Enviar mensajes
Enviar contacto
Envía de 1 a 10 tarjetas de contacto por WhatsApp con POST /v1/messages y type contacts, con nombre, teléfonos y correos.
type: "contacts" envía tarjetas de contacto que el destinatario guarda con un toque. Solo en WhatsApp. Los campos comunes a todos los tipos (to, reply_to, typing, delay_ms, ventana de 24 h) están en Campos comunes.
contacts es una lista de 1 a 10 tarjetas.
| Campo | Regla |
|---|---|
contacts[].name.formatted_name |
Obligatorio, de 1 a 256 caracteres |
contacts[].name.first_name |
Opcional, hasta 128 caracteres |
contacts[].name.last_name |
Opcional, hasta 128 caracteres |
contacts[].phones |
Opcional, hasta 10 elementos |
contacts[].phones[].phone |
De 1 a 64 caracteres |
contacts[].phones[].type |
Opcional, hasta 32 caracteres (p. ej. CELL, WORK) |
contacts[].phones[].wa_id |
Opcional, hasta 64 caracteres: el número en WhatsApp, para el botón de chat |
contacts[].emails |
Opcional, hasta 10 elementos |
contacts[].emails[].email |
De 1 a 128 caracteres |
contacts[].emails[].type |
Opcional, hasta 32 caracteres |
Enviar un contacto
Sección titulada «Enviar un contacto»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" }], }, ],});Ajustes del nodo HTTP Request de n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages - Autenticación: Generic Credential Type, luego Header Auth. Nombre:
Authorization; Valor:Bearer mj_... - Encabezados: activa Send Headers y añade
Idempotency-Key(un valor único por ítem) - Cuerpo: activa 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" } ] } ]}Sustituye mj_... por tu clave de API.
La respuesta es la misma que la del envío de texto (201, status: "queued"); consulta Respuesta.
Errores
Sección titulada «Errores»422outside_service_window: un contacto es un mensaje libre, así que solo sale dentro de las 24 horas desde el último mensaje del destinatario. Fuera de la ventana, usa una plantilla.422type_not_supported_by_channel: conexión de Instagram o Messenger. Los contactos son solo de WhatsApp.400validation_failed: lista vacía o con más de 10 tarjetas, faltaformatted_name, se superó un límite de tamaño o hay un campo desconocido.