Mensagens interativas no WhatsApp: botões e listas
Mensagens de texto puro funcionam bem para perguntas abertas, mas, quando o cliente precisa escolher entre alternativas conhecidas, formatos interativos aceleram a triagem e padronizam respostas. Botões e listas reduzem digitação, encurtam fluxos e produzem respostas mais previsíveis para automações subsequentes. Esta página descreve cada formato disponível pela SiteUp via WhatsApp Cloud API (oficial) e via WAHA (não-oficial).
Botões de resposta rápida
Botões aparecem como pequenos cartões clicáveis abaixo do texto da mensagem. Quando o cliente toca em um, a resposta retorna como uma mensagem de texto contendo o rótulo selecionado — totalmente compatível com automações que esperam por palavras-chave.
Limites do WhatsApp para botões de Quick Reply
| Atributo | Limite |
|---|---|
| Quantidade de botões | Até 3 por mensagem |
| Caracteres por rótulo | Até 20 |
| Texto do corpo (acima dos botões) | Até 1024 caracteres |
| Cabeçalho opcional (texto, imagem, vídeo ou documento) | Sim, com regras próprias |
| Rodapé opcional | Até 60 caracteres |
Quando usar
- Triagens curtas: "Qual sua dúvida? Pedido | Cobrança | Falar com humano"
- Confirmações binárias: "Posso prosseguir? Sim | Não, aguarde"
- Decisões com no máximo três caminhos claros
Para enviar pela SiteUp dentro da janela de 24h, abra a conversa, utilize o seletor de mensagem interativa do composer, escolha Botões, preencha o corpo, os rótulos e envie.
Listas (menus)
Listas são acionadas por um botão único (por exemplo, "Ver opções") que, ao ser tocado, abre uma folha inferior com até dez itens organizados em seções.
Limites do WhatsApp para listas
| Atributo | Limite |
|---|---|
| Itens totais | Até 10 |
| Seções (agrupadores) | Até 10, com o total de itens permanecendo em 10 |
| Caracteres por título de item | Até 24 |
| Descrição por item | Até 72 caracteres |
| Texto do botão de abertura | Até 20 caracteres |
Quando usar
- Catálogos de serviços com 6 a 10 opções
- Agendamentos com horários discretos
- Submenus dentro de um fluxo guiado
Listas comportam mais opções que botões, mas exigem um toque extra para abrir. Se você tem três opções, prefira botões; com cinco ou mais, use lista.
Cabeçalhos de mídia
Tanto botões quanto listas aceitam um cabeçalho com imagem, vídeo ou documento (somente botões aceitam vídeo no cabeçalho). Útil para reforço visual, como uma foto do produto antes dos botões "Quero" / "Mais detalhes" / "Não tenho interesse". Use arquivos leves para garantir entrega rápida — cerca de 5 MB para imagem e até 16 MB para vídeo.
Janela de 24 horas e templates
Mensagens interativas podem ser enviadas de duas formas, conforme a regra do WhatsApp:
- Dentro da janela de 24h — o cliente respondeu nas últimas 24 horas. A SiteUp envia livremente, sem aprovação prévia.
- Fora da janela — você precisa de um template HSM aprovado pelo Meta, com componente interativo embutido (botões de resposta rápida, botões de URL, botões de telefone, ou lista, conforme o que sua conta tem habilitado).
Fluxo de aprovação no Meta para WhatsApp Oficial
- Em Configurações → Caixas de entrada → [WhatsApp Oficial] → Templates, acesse a área de templates.
- Crie ou solicite no painel do Meta Business um novo template, escolhendo categoria (Marketing, Utilidade ou Autenticação) e idioma.
- Defina cabeçalho, corpo (com variáveis numeradas), rodapé e o componente interativo desejado.
- Submeta para análise. O Meta avalia em geral entre alguns minutos e 24 horas.
- Quando aprovado, o template fica disponível no seletor de envio dentro da SiteUp.
Atenção: templates de Marketing têm regras mais rígidas e podem ser rejeitados por linguagem promocional excessiva. Use Utilidade quando a mensagem for confirmação ou notificação transacional.
Atalhos para WAHA (não-oficial)
Em inboxes que utilizam WAHA, botões e listas seguem a especificação do WhatsApp para a versão pareada do aplicativo. A SiteUp envia o payload no formato esperado, mas a entrega depende da estabilidade da sessão pareada. Caso a sessão caia, a mensagem volta como texto puro. Para fluxos sensíveis, prefira a inbox oficial.
Boas práticas
- Limite-se a três opções claras quando puder usar botões. A fricção é menor que a da lista.
- Combine cabeçalho + corpo + rodapé para criar hierarquia visual; evite empilhar tudo no corpo.
- Não utilize rótulos genéricos como "Opção 1". Use "Acompanhar pedido", "Trocar produto", e similares.
- Para fluxos longos, encadeie botões em mensagens sucessivas ou prefira o Capitão IA com fluxo guiado.