Interativa com chamada para ação (URL)

POST

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

🔗 Mensagens Interativas com Chamada para Ação (URL)

As mensagens interativas com chamada para ação (CTA) permitem adicionar botões clicáveis com links em mensagens de texto. É ideal para direcionar o usuário para um site, formulário, produto, rastreio, agendamento ou qualquer outra página web.

Exemplo de mensagem interativa com botão URL

✨ Características principais

Cada mensagem pode ter até 2 botões de chamada para ação.

Os botões podem:

Abrir uma URL fixa (type: url)

Abrir uma URL com preenchimento automático baseado no número do usuário (type: url com example e url_suffix)

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": "cta_url",
        "header": {
            "type": "text",
            "text": "Promoção Especial!"
        },
        "body": {
            "text": "Aproveite nossas ofertas exclusivas! Clique no botão abaixo para acessar nossa loja online."
        },
        "footer": {
            "text": "Promoção válida por tempo limitado"
        },
        "action": {
            "name": "cta_url",
            "parameters": {
                "display_text": "Acessar Loja",
                "url": "https://www.exemplo.com/promocao"
            }
        }
    }
}

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": "cta_url",
        "header": {
            "type": "text",
            "text": "Promoção Especial!"
        },
        "body": {
            "text": "Aproveite nossas ofertas exclusivas! Clique no botão abaixo para acessar nossa loja online."
        },
        "footer": {
            "text": "Promoção válida por tempo limitado"
        },
        "action": {
            "name": "cta_url",
            "parameters": {
                "display_text": "Acessar Loja",
                "url": "https://www.exemplo.com/promocao"
            }
        }
    }
}'

Respostas

🟢200OK

application/json

Mensagem enviada com sucesso

Body

Exemplo

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

🟠400Pedido inválido

🟠401Não autorizado

Modificado em 2025-04-08 05:57:12