Skip to main content
Mensagens interativas não fazem parte do que um usuário comum consegue enviar pelo WhatsApp: são formatos reservados a contas comerciais na API oficial. O Wabox as monta no mesmo formato que o WhatsApp usa internamente (“native flow”), e por isso elas funcionam nos apps de celular — mas o comportamento depende do cliente de quem recebe e pode mudar sem aviso. Tratamos tudo desta página como best effort.

​
Tabela de compatibilidade

Placeholder significa que o WhatsApp Web/Desktop mostra algo como “mensagem de visualização única” ou um aviso de que o conteúdo precisa ser visto no celular. Não é um bug do Wabox: o conteúdo é cifrado de forma idêntica para todos os aparelhos, e o cliente web simplesmente não implementa esses tipos para contas comuns. z-api, Evolution e similares têm exatamente o mesmo comportamento.
Se o seu público atende pelo computador (equipes de suporte, empresas B2B), não dependa de botões e listas. Ofereça a alternativa em texto: “Responda 1 para confirmar, 2 para remarcar”.

​
Detalhes por tipo

Até 3 botões renderizam bem; acima disso o app pode mostrar como lista. Tipos: reply (devolve button_id), url (abre o link), call (disca), copy (copia um texto). Pode levar image no topo. Apps muito antigos podem receber só o texto.
Um botão (button_label) que abre um menu com sections[].rows[] (ou options[] simples). A escolha chega em list_response.selected_row_id.
Botão que abre o app de pagamento com a chave (key, key_type: CPF, CNPJ, telefone, e-mail ou aleatória) e o nome do recebedor. O Wabox não confirma pagamento — isso é entre o cliente e o banco.
Renderizam em todos os clientes, com RSVP. Edição, cancelamento e RSVP dependem de um segredo da mensagem que o engine guarda em memória: só funcionam para eventos criados pela API ou recebidos desde o último restart do engine. Fora disso, delivery vem com message_not_found.
Publicam no seu status seguindo a privacidade de status configurada no celular (meus contatos, exceto, só compartilhar com). Não há como escolher a audiência pela API. Respostas ao status chegam como received normais.

​
Como testar

A aba Testes da instância envia cada tipo interativo para um número seu e acompanha o delivery. Ela mostra se o WhatsApp aceitou o envio; para saber como renderizou, olhe o celular. Veja Diagnóstico.

​
Se algo parar de renderizar

O WhatsApp muda o formato interno desses tipos periodicamente. Quando isso acontece, o envio pode passar a chegar como texto ou nem aparecer. Avise pelo suporte com o message_id e a versão do app de quem recebeu; enquanto isso, use a alternativa em texto. O changelog registra ajustes nesses formatos.