Ir al contenido

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.

  • 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.
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": "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"
}
]
}
]
}
}
}'
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.

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.