Botões e listas no WhatsApp: mensagens interativas na API

Q: Como sei em qual botão o cliente tocou?

O webhook entrega uma mensagem do tipo interactive com o id que você definiu ao montar o botão. Processe sempre pelo id: o texto visível muda quando alguém melhora a redação.

6 de outubro de 2026·7 min de leitura

Resposta rápida

A API oficial oferece três formatos interativos: botões de resposta rápida (até 3 por mensagem), listas com opções agrupadas em seções, e botões que abrem uma URL ou ligam para um telefone. O ganho não é só visual: quando o cliente toca num botão de resposta, isso conta como mensagem dele e reabre a janela de 24 horas — deixando o atendimento seguinte gratuito.

Mensagem interativa é vendida como melhoria de experiência, e é. Mas o argumento que realmente importa é financeiro, e quase ninguém escreve: um toque em botão reabre a janela de 24 horas, e tudo que acontece dentro dela é gratuito.

Sem botão, o cliente precisa digitar para reabrir a janela — e muita gente não digita. Aí a próxima mensagem sua é um template cobrado.

Os três formatos

Formato	Para que serve	Limite prático
Botões de resposta	Escolha entre poucas opções: confirmar, cancelar, falar com atendente	Até 3 botões, texto curto em cada
Lista	Muitas opções organizadas: catálogo de serviços, horários, unidades	Opções agrupadas em seções, abertas num menu
Botão de URL	Levar para rastreio, boleto, site	Abre o navegador — encerra a conversa
Botão de telefone	Iniciar ligação	Útil para urgência, raro em atendimento comercial

Os limites exatos de quantidade e de caracteres mudam com o tempo — confira na documentação antes de desenhar o fluxo.

O toque no botão contou como mensagem do cliente. A resposta seguinte foi gratuita — sem botão, teria sido outro template.

Cada botão de resposta rápida num template é uma chance de o cliente reabrir a janela com um toque. É a economia mais barata de implementar em toda a API.

Dentro e fora da janela

A regra que confunde: interativo dentro da janela é livre; fora dela, só o que estiver previsto no template aprovado.

	Dentro da janela	Fora da janela
Botões de resposta	Livres, montados na hora	Só os aprovados no template
Lista	Livre	Não disponível em template
Botão de URL	Livre	Só o aprovado no template
Trocar o texto do botão	Sim	Não — exige novo template
Custo	Nenhum	Template cobrado

Fluxo de menu com muitas opções só funciona depois que o cliente escreveu — o mecanismo está em janela de 24 horas.

O que o cliente devolve

Toda interação volta pelo webhook como mensagem do tipo interativo. O que interessa é o id que você definiu, não o texto que ele viu.

{
  "type": "interactive",
  "interactive": {
    "type": "button_reply",
    "button_reply": {
      "id": "retirada_hoje",
      "title": "Confirmar retirada hoje"
    }
  }
}

Sempre processe pelo id. O title é texto de interface: muda quando alguém melhora a redação, e aí o fluxo que comparava o texto quebra.

Como desenhar as opções

1Texto de botão curto e literal. “Confirmar”, “Remarcar”, “Falar com atendente”. Botão que não cabe é cortado, e cortado no meio confunde.
2Sempre ofereça a saída humana. Um dos botões precisa ser “falar com uma pessoa”. Fluxo sem essa porta gera a reclamação mais comum do WhatsApp automatizado.
3Nunca peça dado sensível por botão. Senha, cartão e documento não passam por aqui — nem por lista, nem por texto.
4Use lista quando passar de 3 opções, e agrupe em seções com nome. Lista com dez itens soltos é pior que três botões bem escolhidos.
5Um assunto por mensagem. Botão de confirmar pedido junto com botão de promoção mistura o que é utilidade com o que é marketing — e reclassifica o template para a categoria mais cara.

Onde interativo rende mais

Situação	Formato	O que economiza
Confirmação de agendamento	2 botões: confirmar / remarcar	Reabre a janela e reduz falta
Aviso de pedido pronto	1 botão: já vou retirar	Reabre a janela sem custo
Triagem inicial	Lista de assuntos	Direciona antes de ocupar atendente
Rastreio de entrega	Botão de URL	Evita ida e volta de perguntas
Pesquisa de satisfação	3 botões de nota	Resposta em um toque, taxa muito maior
Cancelar inscrição	1 botão de saída	Troca bloqueio por opt-out — protege a qualidade

A primeira linha é a de retorno mais fácil de calcular — o desenho está em lembretes automáticos. A última é a que mais protege a conta: o mecanismo está em qualidade do número.

Antes de publicar um fluxo interativo

Todo botão tem id estável, e o fluxo compara o id, nunca o title.
Existe uma opção de falar com uma pessoa em todo ponto do fluxo.
Textos de botão testados em tela pequena, sem corte no meio.
Nenhum botão pede dado sensível.
Utilidade e marketing em templates separados.
Template de marketing tem botão de saída.
O webhook trata o tipo interactive além de text.
Testado o caminho de quem ignora os botões e escreve à mão.

Quando o botão atrapalha

Interativo tem um custo de desenho que quase não se discute: ele fecha as respostas possíveis. Isso é ótimo para confirmar retirada e péssimo para descobrir o que o cliente quer.

Situação	Botão ajuda?	Por quê
Confirmar ou cancelar	Sim	As respostas possíveis são realmente duas
Escolher horário entre 4 opções	Sim	Conjunto fechado e conhecido
Primeira mensagem de um lead novo	Não	Você ainda não sabe o que ele quer — deixe escrever
Reclamação	Não	Menu diante de cliente irritado é o que gera nota baixa
Orçamento sob medida	Não	A informação que importa não cabe em opção pronta

As três últimas linhas são onde fluxo interativo mal aplicado destrói a experiência que a API deveria melhorar.

A regra prática: use botão quando você conhece as respostas possíveis, e texto livre quando a resposta é a informação. Fluxo que obriga todo mundo a passar por menu antes de falar com alguém é a reclamação número um sobre atendimento automatizado.

Acessibilidade e aparelhos antigos

Dois cuidados que só aparecem em produção, com base grande:

Sempre aceite a resposta escrita equivalente. Parte dos clientes vai digitar “1”, “confirmar” ou “sim” em vez de tocar. Se o fluxo só entende o id do botão, essas pessoas ficam presas.
Versões antigas do aplicativo podem exibir o interativo de forma degradada. O texto do corpo da mensagem precisa fazer sentido sozinho, sem depender do que está escrito nos botões.

Perguntas frequentes

Quantos botões posso colocar numa mensagem do WhatsApp?

Botões de resposta rápida vão até três por mensagem, com texto curto em cada. Para mais opções, o formato é a lista, que agrupa itens em seções abertas num menu.

Botão reabre a janela de 24 horas?

Sim. O toque num botão de resposta rápida conta como mensagem do cliente e reinicia as 24 horas, o que torna o atendimento seguinte gratuito. É o principal motivo econômico para usar botões.

Posso usar botões em template?

Pode, mas eles precisam ser definidos e aprovados junto com o template. Fora da janela só saem os botões que foram aprovados — não dá para montar opções na hora.

Como sei em qual botão o cliente tocou?

O webhook entrega uma mensagem do tipo interactive com o id que você definiu ao montar o botão. Processe sempre pelo id: o texto visível muda quando alguém melhora a redação.

Lista ou botões?

Até três opções, botões — são visíveis sem nenhum toque extra. Acima disso, lista, agrupada em seções nomeadas. Dez itens soltos numa lista convertem pior que três botões bem escolhidos.

Quantas opções cabem numa lista?

As opções ficam agrupadas em seções nomeadas, e o total é limitado — na prática, muito acima do que é útil. O gargalo real não é o teto da plataforma: lista longa converte pior que três botões bem escolhidos, porque exige rolagem e decisão.

O cliente pode responder por texto em vez de tocar?

Pode, e uma parte vai fazer isso — digitando “1”, “sim” ou “confirmar”. Se o seu fluxo só entende o identificador do botão, essas pessoas ficam presas. Sempre aceite o equivalente escrito.

Dá para usar botões na primeira mensagem para um cliente novo?

Tecnicamente sim, se estiverem no template aprovado. Mas costuma ser má ideia: você ainda não sabe o que a pessoa quer, e oferecer opções fechadas antes de ela falar limita a conversa justamente no momento em que ela deveria abrir.

Mensagem interativa custa mais caro?

Não. O custo é definido pela categoria do template e pelo país, não pelo formato. Dentro da janela de 24 horas, interativo é gratuito como qualquer outra mensagem.

Termos deste artigo

Janela de 24 horas: Período em que uma empresa pode responder livremente a um cliente pela API oficial do WhatsApp. Abre a cada mensagem que o cliente envia e dura 24 horas a partir dela. Dentro da janela, a conversa não é cobrada; fora dela, só sai template aprovado, que é cobrado.
Template de mensagem(HSM): Mensagem escrita antes, submetida à Meta e aprovada, com espaços para variáveis. É a única forma de falar com quem não escreveu para a empresa nas últimas 24 horas. Classificado pela Meta em marketing, utilidade, autenticação ou serviço — e o preço varia conforme a categoria.
Webhook: URL pública onde a Meta entrega os eventos do seu número: mensagem recebida, confirmação de entrega e de leitura. Não existe consulta sob demanda na API do WhatsApp — receber mensagem exige um servidor sempre no ar.
Cloud API: Versão da API oficial do WhatsApp hospedada pela própria Meta, sem custo de hospedagem. É o caminho atual para integrar o WhatsApp a um sistema; a alternativa antiga, On-Premises, foi descontinuada.
Opt-out: Pedido do cliente para parar de receber mensagens. Oferecer uma saída fácil é proteção comercial, não cortesia: quem não consegue sair bloqueia, e bloqueio é a métrica que derruba a qualidade da conta.

Ver o glossário completo do WhatsApp

Resumo

Três formatos: botões de resposta, lista e botões de URL ou telefone.
Toque em botão reabre a janela de 24 horas — e o que vem depois é gratuito.
Fora da janela só saem os botões aprovados no template.
Processe sempre pelo id, nunca pelo texto visível.
Sempre ofereça a opção de falar com uma pessoa.
Nunca misture aviso e promoção: reclassifica o template para a categoria cara.

Referências oficiais

Cloud API — mensagens interativas — consultado em 6 de outubro de 2026
Cloud API — referência de objetos de mensagem — consultado em 6 de outubro de 2026