Recaudo Docs
Sign up

Conversations

Interactive messages

Send messages with buttons or option lists via WhatsApp

Send interactive message

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

Sends an interactive WhatsApp message with quick reply buttons or an option list. Only available for WhatsApp conversations.

Field Type Required Description
typestringYesMessage type: buttons o list
bodystringYesMessage text (max 1024 chars)
buttonsarrayYes*Reply buttons (min 1, max 3). Required if type=buttons
buttons.*.titlestringYesButton text (max 20 chars)
sectionsarrayYes*List sections. Required if type=list
sections.*.titlestringNoSection title (max 24 chars)
sections.*.rowsarrayYesSection options (min 1, max 10)
sections.*.rows.*.titlestringYesOption text (max 24 chars)
sections.*.rows.*.descriptionstringNoOption description (max 72 chars)
button_textstringNoList button text (default: "Seleccionar", max 20 chars)

* buttons is required when type=buttons. sections is required when type=list.

Example — Message with buttons 
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" }
    ]
  }'
Example — Message with a list 
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" }
        ]
      }
    ]
  }'
Response 
{
  "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"
  }
}
Was this page helpful? Thanks for letting us know.
Esc