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

A mensagem automática diz: "digite 1 para orçamento, 2 para segunda via, 3 para falar com alguém". O cliente responde "oi, quanto custa?". O sistema não entende, repete o menu, e a conversa termina com o cliente mandando um áudio de dois minutos.

Menu numerado é o jeito antigo de oferecer escolhas no WhatsApp. Pela API oficial existe outro: mensagens interativas, com botões que o cliente toca e listas que ele abre. Elas tiram o erro de digitação do caminho, mas têm regras que pegam muita empresa de surpresa. Há limite de caracteres, número máximo de opções e, principalmente, hora certa para cada formato sair.

Os quatro formatos, lado a lado

Um detalhe de montagem: botões de resposta e botão de link aceitam cabeçalho com texto, imagem, vídeo ou documento. A lista aceita só cabeçalho de texto.

A regra que decide quando cada um pode sair

Enviados como mensagem interativa, sem template, os quatro formatos são o que a Meta chama de mensagem de serviço. Só podem sair dentro da janela de atendimento de 24 horas, que abre quando o cliente escreve para a empresa e recomeça a cada nova mensagem dele.

Fora da janela, a única porta é o template aprovado. E o template tem botões próprios, com outras regras. Na prática:

• O cliente acabou de perguntar "quais horários vocês têm no sábado?" A lista com os horários pode sair na hora.
• O lembrete do horário de amanhã vai para quem não escreve há uma semana. Precisa ser template, e os botões "Confirmar" e "Remarcar" vêm dentro dele.
• O cliente sumiu depois de receber o orçamento, três dias atrás. Lista interativa não sai. Só template.

Quando o sistema tenta mandar mensagem sem template com a janela fechada, a Meta recusa com o erro 131047. Na coexistência há um detalhe a mais: o que a equipe responde pelo aplicativo não abre nem estende a janela da API. Só a mensagem do cliente conta. As regras completas estão em janela de 24 horas no WhatsApp Coexistence.

Botões dentro do template

O template pode ser enviado a qualquer hora para quem deu consentimento, e aceita até 10 botões no total, com teto por tipo:

Três regras de montagem mudam o que o cliente enxerga:

• Respostas rápidas ficam juntas. Elas precisam estar agrupadas, separadas dos botões de outro tipo.
• Acima de 3, só 2 aparecem. Com mais de 3 botões, o WhatsApp mostra 2 e guarda o resto em "Ver todas as opções". Coloque a ação principal entre as duas primeiras.
• O computador não mostra tudo. Template com 4 botões ou mais, ou que mistura resposta rápida com outro tipo, não aparece no WhatsApp Desktop. Se boa parte dos seus clientes usa o WhatsApp no computador, como costuma acontecer em vendas para empresas, fique em até 3 botões do mesmo tipo.

Quem cria, quem aprova e quem paga o template quando há um provedor no meio está em templates de WhatsApp com um Tech Provider. A categoria que a Meta atribui ao texto, e que define a cobrança, é assunto de marketing, utilidade ou autenticação.

Escrever em 20 caracteres

O limite que mais aperta no dia a dia é o do rótulo: 20 caracteres no botão e 24 no título da linha da lista. Espaço conta.

Algumas regras que poupam retrabalho:

• Comece pelo verbo. "Ver horários" diz mais que "Horários disponíveis para você".
• Jogue o detalhe para a descrição. Na lista, a linha tem 72 caracteres de descrição para preço, duração ou endereço.
• Deixe sempre uma saída. "Outro assunto" ou "Falar com atendente". Quem não acha a própria opção digita, e o sistema precisa entender texto livre também.

Um exemplo de lista para uma rede com quatro unidades: o botão que abre o menu se chama "Escolher unidade" (16 caracteres); a seção "Zona Sul" tem duas linhas, cada uma com o nome da unidade no título e "seg a sáb, até 20h" na descrição; a seção "Centro" repete o formato.

Quanto custa uma mensagem com botão

A Meta cobra por mensagem entregue, conforme a categoria e o país de quem recebe. Cada mensagem tem uma única categoria e gera no máximo uma cobrança, então o botão não cria taxa extra.

• Interativa dentro da janela: é mensagem de serviço. Desde 01/10/2026, a Meta dá uma cota de 1.000 mensagens de serviço por mês para cada número comercial, que não acumula. A partir da 1.001ª, cobra. Muito conteúdo na internet ainda diz que serviço é grátis; isso mudou.
• Template com botões: é cobrado pela categoria do template (marketing, utilidade ou autenticação).
• O toque do cliente: a Meta só cobra mensagens da empresa para o usuário. A resposta dele não entra na conta.

O que continua de graça, e as promessas de "API grátis" que não se sustentam, estão em API do WhatsApp grátis existe?.

Flows, em um parágrafo

Quando três botões ou dez linhas não bastam, existe o WhatsApp Flows: telas com campos, seletores e formulário dentro da conversa, para agendamento, cadastro, cotação ou pesquisa. O Flow sai de dois jeitos: como template com um botão do tipo Flow, a qualquer hora, ou como mensagem interativa dentro da janela de atendimento. A Meta exige empresa verificada e boa qualidade de mensagens. Um Flow no estado de envio limitado (“throttled”) só pode ser enviado 10 vezes por hora, e desde dezembro de 2025 os Flows abrem também no WhatsApp Web.

Quem envia e quem trata a resposta

Mensagem interativa não se monta no aplicativo do celular. Ela sai de um sistema ligado à API: um robô, uma ferramenta de atendimento ou a integração do seu site. E enviar é metade do trabalho. Quando o cliente toca no botão, a resposta chega ao sistema conectado, que precisa saber o que fazer com ela. Botão que ninguém trata é pior que menu numerado: o cliente escolhe e nada acontece.

Se o número está em coexistência, com a equipe no app, o robô que manda os botões também precisa saber a hora de sair da conversa. Esse encaixe, com o aviso de eco que a Meta manda quando alguém responde pelo app, está em chatbot no WhatsApp via Tech Provider.

Antes de pôr botões no ar:

• cada botão tem uma ação definida no sistema;
• existe saída para falar com uma pessoa;
• o texto livre também é entendido;
• o template foi testado no celular e no computador;
• a ação principal está entre as duas primeiras.

O que o Vazante faz aqui, e o que não faz

O Vazante é Tech Provider (provedor de tecnologia) da Meta, mas não monta fluxos, menus de botões nem listas interativas, e não é robô de atendimento. No painel, com o número conectado pelo cadastro oficial da Meta, você cria e acompanha templates, envia mensagens e vê qual anúncio gerou cada conversa, com o custo, ao lado das métricas de Meta Ads, Google Ads e TikTok Ads.

Se você precisa de menu interativo, ele vem de uma ferramenta de chatbot ou de atendimento. Antes de ligar duas ferramentas ao mesmo número, pergunte por escrito como elas convivem: o recurso oficial da Meta para vários parceiros no mesmo número ainda está em beta fechado. O Coexistence vem incluído nos planos com assinatura ativa, e as mensagens são pagas direto à Meta, sem margem do Vazante. Veja a página do WhatsApp Coexistence e os planos.