Recaudo Docs
Crear cuenta

Conversaciones

Mensajes interactivos

Envía mensajes con botones o listas de opciones por WhatsApp

Enviar mensaje interactivo

POST /v1/conversations/{'{id}'}/interactive

Envía un mensaje interactivo de WhatsApp con botones de respuesta rápida o una lista de opciones. Solo disponible para conversaciones de WhatsApp.

Campo Tipo Requerido Descripción
typestringSíTipo de mensaje: buttons o list
bodystringSíTexto del mensaje (máx. 1024 caracteres)
buttonsarraySí*Botones de respuesta (mín. 1, máx. 3). Requerido si type=buttons
buttons.*.titlestringSíTexto del botón (máx. 20 caracteres)
sectionsarraySí*Secciones de la lista. Requerido si type=list
sections.*.titlestringNoTítulo de la sección (máx. 24 caracteres)
sections.*.rowsarraySíOpciones de la sección (mín. 1, máx. 10)
sections.*.rows.*.titlestringSíTexto de la opción (máx. 24 caracteres)
sections.*.rows.*.descriptionstringNoDescripción de la opción (máx. 72 caracteres)
button_textstringNoTexto del botón de la lista (por defecto: "Seleccionar", máx. 20 caracteres)

* buttons es requerido cuando type=buttons. sections es requerido cuando type=list.

Ejemplo — mensaje con botones 
curl -X POST https://recaudo.app/api/v1/conversations/{id}/interactive \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "buttons",
    "body": "¿Deseas confirmar tu pago de $1,500.00?",
    "buttons": [
      { "title": "Sí, confirmar" },
      { "title": "No, cancelar" },
      { "title": "Hablar con agente" }
    ]
  }'
Ejemplo — mensaje con lista 
curl -X POST https://recaudo.app/api/v1/conversations/{id}/interactive \
  -H "Authorization: Bearer sk_live_tu_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "list",
    "body": "Selecciona el método de pago que prefieres:",
    "button_text": "Ver opciones",
    "sections": [
      {
        "title": "Métodos de pago",
        "rows": [
          { "title": "Tarjeta de crédito", "description": "Visa, Mastercard, AMEX" },
          { "title": "Transferencia SPEI", "description": "Pago inmediato desde tu banco" },
          { "title": "Pago en OXXO", "description": "Genera una referencia de pago" }
        ]
      }
    ]
  }'
Respuesta 
{
  "object": "message",
  "data": {
    "id": "01234567-89ab-cdef-0123-456789abcdef",
    "conversation_id": "uuid-de-la-conversacion",
    "type": "interactive",
    "direction": "outbound",
    "status": "sent",
    "created_at": "2026-04-08T10:30:00Z"
  }
}
¿Te sirvió esta página? Gracias por avisarnos.
Esc