Botões

POST

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

🔘 Envio de Mensagem com Botões via Template

Este endpoint permite enviar mensagens interativas com botões utilizando um template pré-aprovado.

Parâmetros de template:

button: Componentes que definem os botões interativos

button.sub_type: Tipo de botão (quick_reply, url)

button.index: Índice do botão no template

button.parameters: Parâmetros específicos do botão

Limitações:

Máximo de 3 botões por mensagem

Texto do botão limitado a 20 caracteres

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": "5511999999999",
    "type": "template",
    "template": {
        "name": "confirmacao_agendamento",
        "language": {
            "code": "pt_BR"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "João Silva"
                    },
                    {
                        "type": "text",
                        "text": "15/04/2025 às 14:30"
                    },
                    {
                        "type": "text",
                        "text": "Dr. Carlos Oliveira"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": "0",
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "CONFIRM_APPOINTMENT_12345"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": "1",
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "RESCHEDULE_APPOINTMENT_12345"
                    }
                ]
            }
        ]
    }
}

Códigos de solicitaçã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 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5511999999999",
    "type": "template",
    "template": {
        "name": "confirmacao_agendamento",
        "language": {
            "code": "pt_BR"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "João Silva"
                    },
                    {
                        "type": "text",
                        "text": "15/04/2025 às 14:30"
                    },
                    {
                        "type": "text",
                        "text": "Dr. Carlos Oliveira"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": "0",
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "CONFIRM_APPOINTMENT_12345"
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "quick_reply",
                "index": "1",
                "parameters": [
                    {
                        "type": "payload",
                        "payload": "RESCHEDULE_APPOINTMENT_12345"
                    }
                ]
            }
        ]
    }
}'

Respostas

🟢200OK

application/json

Mensagem enviada com sucesso

Body

Exemplo

{
    "messaging_product": "string",
    "contacts": [
        {
            "input": "string",
            "wa_id": "string"
        }
    ],
    "messages": [
        {
            "id": "string"
        }
    ]
}

Modificado em 2025-10-21 19:29:49