Recaudo Docs
Criar conta

Conversas

Mensagens interativas

Envie mensagens com botões ou listas de opções pelo WhatsApp

Enviar mensagem interativa

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

Envia uma mensagem interativa de WhatsApp com botões de resposta rápida ou uma lista de opções. Disponível só para conversas de WhatsApp.

Campo Tipo Obrigatório Descrição
typestringSimTipo de mensagem: buttons o list
bodystringSimTexto da mensagem (máx. 1024 caracteres)
buttonsarraySim*Botões de resposta (mín. 1, máx. 3). Obrigatório se type=buttons
buttons.*.titlestringSimTexto do botão (máx. 20 caracteres)
sectionsarraySim*Seções da lista. Obrigatório se type=list
sections.*.titlestringNãoTítulo da seção (máx. 24 caracteres)
sections.*.rowsarraySimOpções da seção (mín. 1, máx. 10)
sections.*.rows.*.titlestringSimTexto da opção (máx. 24 caracteres)
sections.*.rows.*.descriptionstringNãoDescrição da opção (máx. 72 caracteres)
button_textstringNãoTexto do botão da lista (padrão: "Seleccionar", máx. 20 caracteres)

* buttons é obrigatório quando type=buttons. sections é obrigatório quando type=list.

Exemplo — mensagem com botões 
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" }
    ]
  }'
Exemplo — mensagem com 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" }
        ]
      }
    ]
  }'
Resposta 
{
  "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"
  }
}
Esta página ajudou? Obrigado por avisar.
Esc