Enviar mensajes de contactos y ubicación
Utiliza el nodo messages para enviar otros tipos de mensajes, como de contactos o ubicación, a tus clientes.
Antes de empezar
Necesitarás lo siguiente:
- Cumplir todos los requisitos previos que se indican en la sección Antes de empezar de la documentación Mensajes.
Estos mensajes solo se pueden enviar en respuesta a un mensaje entrante del cliente en la ventana de atención al cliente. Actualmente, no se admite su envío en una plantilla de mensaje.
Mensajes de contactos
Paso 1: Realizar una solicitud POST a /messages
POST /v1/messages
{
"to": "recipient-wa-id",
"type": "contacts",
"contacts": [
{
"addresses": [
{
"city": "Menlo Park",
"country": "United States",
"country_code": "us",
"state": "CA",
"street": "1 Hacker Way",
"type": "HOME",
"zip": "94025"
},
{
"city": "Menlo Park",
"country": "United States",
"country_code": "us",
"state": "CA",
"street": "200 Jefferson Dr",
"type": "WORK",
"zip": "94025"
}
],
"birthday": "2012-08-18",
"emails": [
{
"email": "test@fb.com",
"type": "WORK"
},
{
"email": "test@whatsapp.com",
"type": "WORK"
}
],
"name": {
"first_name": "John",
"formatted_name": "John Smith",
"last_name": "Smith"
},
"org": {
"company": "WhatsApp",
"department": "Design",
"title": "Manager"
},
"phones": [
{
"phone": "+1 (940) 555-1234",
"type": "HOME"
},
{
"phone": "+1 (650) 555-1234",
"type": "WORK",
"wa_id": "16505551234"
}
],
"urls": [
{
"url": "https://www.facebook.com",
"type": "WORK"
}
]
}
]
}
Para obtener más información sobre los parámetros, consulta:
Paso 2: Comprobar la respuesta
Las respuestas que se completan correctamente tienen este aspecto:
{
"messages": [{
"id": "message-id"
}]
}
Mensajes de ubicación
Paso 1: Realizar una solicitud POST a /messages
POST /v1/messages
{
"to": "recipient-wa-id",
"type": "location",
"location": {
"longitude": -122.425332,
"latitude": 37.758056,
"name": "Facebook HQ",
"address": "1 Hacker Way, Menlo Park, CA 94025"
}
}
Para obtener más información sobre los parámetros, consulta:
Paso 2: Comprobar la respuesta
Las respuestas que se completan correctamente tienen este aspecto:
{
"messages": [{
"id": "message-id"
}]
}