Pular para o conteúdo

Enviar mensagens

Enviar contato

Envie de 1 a 10 cartões de contato pelo WhatsApp com POST /v1/messages e type contacts, com nome, telefones e e-mails.

type: "contacts" envia cartões de contato que o destinatário salva com um toque. Só no WhatsApp. Os campos comuns a todos os tipos (to, reply_to, typing, delay_ms, janela de 24 h) estão em Campos comuns.

contacts é uma lista de 1 a 10 cartões.

Campo Regra
contacts[].name.formatted_name Obrigatório, de 1 a 256 caracteres
contacts[].name.first_name Opcional, até 128 caracteres
contacts[].name.last_name Opcional, até 128 caracteres
contacts[].phones Opcional, até 10 itens
contacts[].phones[].phone De 1 a 64 caracteres
contacts[].phones[].type Opcional, até 32 caracteres (ex.: CELL, WORK)
contacts[].phones[].wa_id Opcional, até 64 caracteres: o número no WhatsApp, para o botão de conversa
contacts[].emails Opcional, até 10 itens
contacts[].emails[].email De 1 a 128 caracteres
contacts[].emails[].type Opcional, até 32 caracteres
Janela do terminal
curl https://api.messajo.com/v1/messages \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"connection_id": "conn_...",
"to": "5511999999999",
"type": "contacts",
"contacts": [
{
"name": { "formatted_name": "Ana Souza", "first_name": "Ana", "last_name": "Souza" },
"phones": [{ "phone": "+55 11 98888-7777", "type": "CELL", "wa_id": "5511988887777" }],
"emails": [{ "email": "[email protected]", "type": "WORK" }]
}
]
}'

A resposta é a mesma do envio de texto (201, status: "queued"); veja Resposta.

  • 422 outside_service_window: contato é mensagem livre, então só sai dentro de 24 horas da última mensagem do destinatário. Fora da janela, use um template.
  • 422 type_not_supported_by_channel: conexão do Instagram ou do Messenger. Contato é só do WhatsApp.
  • 400 validation_failed: lista vazia ou com mais de 10 cartões, formatted_name ausente, limite de tamanho excedido ou campo desconhecido.