OPT Juntos
  1. Mensagens
OPT Juntos
  • OPT waba
    • Como enviar mensagens
    • Mensagens
      • Áudio
        POST
      • Contato
        POST
      • Documento
        POST
      • Imagem
        POST
      • Interativa com chamada para ação (URL)
        POST
      • Interativa com lista
        POST
      • Interativa com botões
        POST
      • Localização
        POST
      • Figurinha
        POST
      • Texto
        POST
      • Vídeo
        POST
      • Reação
        POST
      • Confirmação de leitura
        POST
    • Modelos de mensagens
      • Texto
      • Imagem
      • Documento
      • Vídeo
      • Botões
      • Lista
      • Localização
      • Código OTP
    • Mídia
      • Obter mídia
  • OPT Bot
    • send message to bot
      GET
  1. Mensagens

Interativa com lista

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

📋 Mensagens de Lista Interativa#

As mensagens de lista interativa permitem que você apresente um menu de opções para os usuários escolherem, melhorando a navegação e a interatividade da conversa.
Mensagem recebida com botão de lista
Ao tocar no botão, o usuário verá uma lista interativa com seções e itens organizados:
Lista expandida com seções e opções
Após escolher uma opção, a resposta é enviada automaticamente para o seu sistema, permitindo dar continuidade à conversa:
Confirmação de item selecionado

Limitações e boas práticas#

Você pode incluir até 10 seções na lista
Cada seção pode conter até 10 itens (rows)
O texto do botão da lista deve ser claro e convidativo
Use títulos concisos para cada seção e item
Adicione descrições úteis para fornecer contexto
Certifique-se de gerar IDs únicos para cada item
Mantenha a lista organizada e fácil de navegar
O cabeçalho é opcional, mas recomendado para melhor contexto

Casos de uso comuns#

Menus de autoatendimento
Seleção de produtos ou serviços
Escolha de horários de atendimento
Respostas a pesquisas de satisfação
Navegação em FAQs ou tópicos de ajuda

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": "list",
        "header": {
            "type": "text",
            "text": "Menu de Opções"
        },
        "body": {
            "text": "Selecione uma das opções disponíveis abaixo:"
        },
        "footer": {
            "text": "Escolha a opção desejada"
        },
        "action": {
            "button": "Ver Opções",
            "sections": [
                {
                    "title": "Produtos e Serviços",
                    "rows": [
                        {
                            "id": "product_1",
                            "title": "Produto A",
                            "description": "Descrição detalhada do Produto A"
                        },
                        {
                            "id": "product_2",
                            "title": "Produto B",
                            "description": "Descrição detalhada do Produto B"
                        }
                    ]
                },
                {
                    "title": "Atendimento",
                    "rows": [
                        {
                            "id": "service_1",
                            "title": "Suporte Técnico",
                            "description": "Suporte para produtos adquiridos"
                        },
                        {
                            "id": "service_2",
                            "title": "Reclamações",
                            "description": "Registre sua reclamação"
                        }
                    ]
                }
            ]
        }
    }
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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": "list",
        "header": {
            "type": "text",
            "text": "Menu de Opções"
        },
        "body": {
            "text": "Selecione uma das opções disponíveis abaixo:"
        },
        "footer": {
            "text": "Escolha a opção desejada"
        },
        "action": {
            "button": "Ver Opções",
            "sections": [
                {
                    "title": "Produtos e Serviços",
                    "rows": [
                        {
                            "id": "product_1",
                            "title": "Produto A",
                            "description": "Descrição detalhada do Produto A"
                        },
                        {
                            "id": "product_2",
                            "title": "Produto B",
                            "description": "Descrição detalhada do Produto B"
                        }
                    ]
                },
                {
                    "title": "Atendimento",
                    "rows": [
                        {
                            "id": "service_1",
                            "title": "Suporte Técnico",
                            "description": "Suporte para produtos adquiridos"
                        },
                        {
                            "id": "service_2",
                            "title": "Reclamações",
                            "description": "Registre sua reclamação"
                        }
                    ]
                }
            ]
        }
    }
}'

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 06:55:26
Página anterior
Interativa com chamada para ação (URL)
Próxima página
Interativa com botões
Built with