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 |
Enviar um contato
Seção intitulada “Enviar um contato”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" }] } ] }'import { Messajo } from "@messajo/sdk";
const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });
const sent = await messajo.messages.send({ 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" }], }, ],});Configurações do nó HTTP Request do n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages - Autenticação: Generic Credential Type, depois Header Auth. Nome:
Authorization; Valor:Bearer mj_... - Cabeçalhos: ative Send Headers e adicione
Idempotency-Key(um valor único por item) - Corpo: ative Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "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": [ { "type": "WORK" } ] } ]}Substitua mj_... pela sua chave de API.
A resposta é a mesma do envio de texto (201, status: "queued"); veja Resposta.
422outside_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.422type_not_supported_by_channel: conexão do Instagram ou do Messenger. Contato é só do WhatsApp.400validation_failed: lista vazia ou com mais de 10 cartões,formatted_nameausente, limite de tamanho excedido ou campo desconhecido.