Ir al contenido

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
Ventana de 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" }]
}
]
}'

La respuesta es la misma que la del envío de texto (201, status: "queued"); consulta Respuesta.

  • 422 outside_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.
  • 422 type_not_supported_by_channel: conexión de Instagram o Messenger. Los contactos son solo de WhatsApp.
  • 400 validation_failed: lista vacía o con más de 10 tarjetas, falta formatted_name, se superó un límite de tamaño o hay un campo desconocido.