Interativa com botões

POST

https://waba.optjuntos.com.br/api/v1/messages

🔘 Mensagens Interativas com Botões de Resposta Rápida

As mensagens interativas com botões de resposta rápida permitem oferecer até 3 botões clicáveis logo abaixo da mensagem. Elas são ideais para capturar decisões rápidas do usuário, como confirmações, seleções simples ou navegação rápida.

🧠 Como Funciona

O usuário recebe uma mensagem com até 3 botões de resposta.

Cada botão possui um título visível e um ID oculto que será enviado ao seu sistema quando selecionado.

Ao tocar em um botão, o WhatsApp envia imediatamente a resposta sem exigir digitação manual.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/json

Exemplo

{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{recipient_number}}",
    "type": "interactive",
    "interactive": {
        "type": "button",
        "body": {
            "text": "Escolha uma das opções abaixo para continuar seu atendimento:"
        },
        "action": {
            "buttons": [
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_1",
                        "title": "Suporte Técnico"
                    }
                },
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_2",
                        "title": "Vendas"
                    }
                },
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_3",
                        "title": "Falar com Atendente"
                    }
                }
            ]
        }
    }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://waba.optjuntos.com.br/api/v1/messages' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5517991677564",
    "type": "interactive",
    "interactive": {
        "type": "button",
        "body": {
            "text": "Escolha uma das opções abaixo para continuar seu atendimento:"
        },
        "action": {
            "buttons": [
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_1",
                        "title": "Suporte Técnico"
                    }
                },
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_2",
                        "title": "Vendas"
                    }
                },
                {
                    "type": "reply",
                    "reply": {
                        "id": "option_3",
                        "title": "Falar com Atendente"
                    }
                }
            ]
        }
    }
}'

Respostas

🟢200OK

application/json

Mensagem enviada com sucesso

Body

Exemplo

{
    "messaging_product": "whatsapp",
    "contacts": [
        {
            "input": "{{recipient_number}}",
            "wa_id": "{{recipient_number}}"
        }
    ],
    "messages": [
        {
            "id": "wamid.ABGGFlCGg0tx_Ahlkd_wHWUhbgOSJQ"
        }
    ]
}

🟠400Pedido inválido

🟠401Não autorizado

Modificado em 2025-04-08 06:05:37