Enviar mensajes
Enviar lista
Envía una lista de opciones con secciones en WhatsApp con POST /v1/messages y recibe la elección del contacto.
POST /v1/messages con type: "interactive" e interactive.type: "list" muestra un botón que abre una lista de opciones. Solo existe en WhatsApp. Los campos comunes a todos los envíos están en Campos comunes.
Antes de empezar
Sección titulada «Antes de empezar»- Una clave de API con el permiso
send(consulta Autenticación). - Una conexión Activa de WhatsApp.
- Un mensaje interactivo es un mensaje libre: solo sale dentro de la ventana de 24 horas (consulta Ventanas). Fuera de ella, usa una plantilla.
Enviar una lista
Sección titulada «Enviar una lista»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": "interactive", "interactive": { "type": "list", "header": { "type": "text", "text": "Atención" }, "body": { "text": "¿Sobre qué quieres hablar?" }, "footer": { "text": "Elige una opción" }, "action": { "button": "Ver opciones", "sections": [ { "title": "Pedidos", "rows": [ { "id": "status", "title": "Estado del pedido", "description": "Dónde está mi entrega" }, { "id": "troca", "title": "Cambio o devolución" } ] }, { "title": "Cuenta", "rows": [ { "id": "fatura", "title": "Copia de la factura" }, { "id": "humano", "title": "Hablar con una persona", "description": "Atención en horario comercial" } ] } ] } } }'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": "interactive", "interactive": { "type": "list", "header": { "type": "text", "text": "Atención" }, "body": { "text": "¿Sobre qué quieres hablar?" }, "footer": { "text": "Elige una opción" }, "action": { "button": "Ver opciones", "sections": [ { "title": "Pedidos", "rows": [ { "id": "status", "title": "Estado del pedido", "description": "Dónde está mi entrega" }, { "id": "troca", "title": "Cambio o devolución" } ] }, { "title": "Cuenta", "rows": [ { "id": "fatura", "title": "Copia de la factura" }, { "id": "humano", "title": "Hablar con una persona", "description": "Atención en horario comercial" } ] } ] } }});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": "interactive", "interactive": { "type": "list", "header": { "type": "text", "text": "Atención" }, "body": { "text": "¿Sobre qué quieres hablar?" }, "footer": { "text": "Elige una opción" }, "action": { "button": "Ver opciones", "sections": [ { "title": "Pedidos", "rows": [ { "id": "status", "title": "Estado del pedido", "description": "Dónde está mi entrega" }, { "id": "troca", "title": "Cambio o devolución" } ] }, { "title": "Cuenta", "rows": [ { "id": "fatura", "title": "Copia de la factura" }, { "id": "humano", "title": "Hablar con una persona", "description": "Atención en horario comercial" } ] } ] } }}Sustituye mj_... por tu clave de API.
Campos de la lista
Sección titulada «Campos de la lista»| Campo | Regla |
|---|---|
interactive.body.text |
Obligatorio, de 1 a 1024 caracteres. |
interactive.header, interactive.footer |
Opcionales. Encabezado de texto y pie con hasta 60 caracteres. |
action.button |
De 1 a 20 caracteres. Es la etiqueta del botón que abre la lista. |
action.sections |
De 1 a 10 secciones. |
sections[].title |
Opcional, hasta 24 caracteres. |
sections[].rows |
Al menos 1 fila. |
rows[].id |
De 1 a 200 caracteres. Es lo que recibes de vuelta. |
rows[].title |
De 1 a 24 caracteres. |
rows[].description |
Opcional, hasta 72 caracteres. |
Recibir la elección
Sección titulada «Recibir la elección»La elección llega como un evento message.received, con data.message.content de tipo reply y kind: "list":
{ "type": "message.received", "data": { "message": { "direction": "inbound", "content": { "type": "reply", "kind": "list", "id": "status", "title": "Estado del pedido", "description": "Dónde está mi entrega", "payload": null } } }}id, title y description son los de la fila elegida. Enlaza tu lógica al id.
Otros tipos interactivos
Sección titulada «Otros tipos interactivos»- Botones de respuesta y de enlace: Enviar botones.
- Flujos: Flows.
- Catálogo y pedido con Pix: Ventas en WhatsApp.
Errores comunes
Sección titulada «Errores comunes»outside_service_window(422): fuera de las 24 horas (ventanas). El fin de la ventana viene endetails[0].message.type_not_supported_by_channel(422): el canal no acepta ese tipo. Por ejemplo,interactiveen Instagram o Messenger, obuttonsen WhatsApp.validation_failed(400): el cuerpo incumple las reglas, como más de 3 botones o un título por encima del límite.