Skip to main content
Um usuário comum não consegue enviar mensagens interativas 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. O comportamento depende do cliente de quem recebe e pode mudar sem aviso. Tudo nesta página é 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 não implementa esses tipos para contas comuns. z-api, Evolution e similares se comportam do mesmo jeito.
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, como “Responda 1 para confirmar, 2 para remarcar”.

​
Detalhes por tipo

Até 3 botões renderizam bem; acima disso o app pode mostrar como lista. Os tipos são reply (devolve button_id), url (abre o link), call (disca) e copy (copia um texto). O botão 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 o pagamento, que fica entre o cliente e o banco. Uma cobrança PIX recebida de outra conta chega no webhook received como botão type: "pix" (veja buttons recebidos).
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, então 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). Você não escolhe 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 chegar como texto ou nem aparecer. Avise o suporte com o message_id e a versão do app de quem recebeu, e enquanto isso use a alternativa em texto. O changelog registra ajustes nesses formatos.