Como enviar mensagens com contatos e localização
Use o nó messages para enviar outros tipos de mensagem, como contatos ou localizações, para os clientes.
Antes de começar
Você precisará:
- Atender a todos os pré-requisitos listados na seção Antes de começar da documentação sobre mensagens.
Essas mensagens só podem ser enviadas em resposta a mensagens de entrada do cliente dentro da janela de atendimento. No momento, não é possível enviá-las em um modelo de mensagem.
Mensagens com contatos
Etapa 1: fazer uma solicitação POST para /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 obter mais informações sobre parâmetros, consulte os seguintes documentos:
Etapa 2: verificar a resposta
A resposta bem-sucedida é semelhante a esta:
{
"messages": [{
"id": "message-id"
}]
}
Mensagens de localização
Etapa 1: fazer uma solicitação POST para /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 obter mais informações sobre parâmetros, consulte os seguintes documentos:
Etapa 2: verificar a resposta
A resposta bem-sucedida é semelhante a esta:
{
"messages": [{
"id": "message-id"
}]
}