InícioBlogAPI Oficial

API Oficial

Botões e listas no WhatsApp: são 10 linhas no total, não 10 por seção — e é aí que o menu quebra

Três botões, vinte caracteres cada, títulos que não podem repetir. Dez seções na lista, mas dez linhas somando tudo. Os limites da documentação decidem o desenho do seu atendimento antes de qualquer estratégia.

Existe um erro que aparece em quase todo projeto de atendimento no WhatsApp, e ele só é descoberto na hora de publicar: alguém desenhou um menu bonito, com cinco seções bem organizadas e quatro opções em cada uma, e a mensagem não sai.

O motivo está numa frase da documentação que passa despercebida:

“Interactive list messages support up to 10 sections, with up to 10 rows for all sections combined”

Até 10 seções, com até 10 linhas somando todas as seções. O dez é o total, não o teto por seção.

Cinco seções com quatro itens cada dão vinte linhas. Não cabe. E como esse limite não é sobre estratégia, e sim sobre estrutura, ele precisa entrar antes do desenho do atendimento — não depois.

Abaixo, todos os números que valem, e o que fazer quando a sua operação não cabe neles.

Anatomia das mensagens interativas do WhatsApp com os limites de cada campo: à esquerda a mensagem com até três botões de resposta rápida, à direita a mensagem de lista com até dez seções e dez linhas no total
O limite de dez linhas é somando as seções — é o que mais quebra menu

Botões de resposta rápida

O formato mais direto: a pergunta aparece e os botões ficam logo abaixo, na própria conversa.

  • Até 3 botões por mensagem.
  • Título do botão: até 20 caracteres.
  • Corpo: até 1.024 caracteres.
  • Rodapé: até 60 caracteres.
  • Títulos precisam ser únicos“Must be unique if using multiple buttons”. Dois botões com o mesmo texto não passam.

Os 20 caracteres do título são mais apertados do que parecem. “Falar com atendente” tem 19 e passa raspando. “Segunda via de boleto” tem 21 e não passa. Vale contar antes de escrever o fluxo, não depois.

A regra da unicidade também tem uma consequência prática que costuma pegar: em menus com submenus, é tentador repetir “Voltar” em vários lugares. Dentro da mesma mensagem os títulos não podem se repetir — em mensagens diferentes, sem problema.

Mensagem de lista

Quando as opções passam de três, o formato é a lista: um botão abre uma tela separada com os itens, cada um podendo ter descrição.

  • Até 10 seções, com até 10 linhas no total.
  • Cabeçalho: até 60 caracteres.
  • Corpo: até 4.096 caracteres.
  • Rodapé: até 60 caracteres.
  • Texto do botão que abre a lista: até 20 caracteres.
  • Título de cada linha: até 24 caracteres.
  • Descrição de cada linha: até 72 caracteres.

A descrição de 72 caracteres é o recurso mais subaproveitado do WhatsApp comercial. Ela permite que cada opção se explique sozinha — “2ª via, alteração de vencimento e comprovantes” cabe — o que reduz o número de pessoas que escolhem errado e voltam para o começo.

E repare no corpo de 4.096 caracteres contra os 1.024 dos botões: a lista aceita quatro vezes mais texto antes das opções. Não que você deva usar tudo.

As duas regras que valem para os dois formatos

1. Só dentro da janela. Mensagem interativa é de formato livre. Ela só é entregue dentro da janela de atendimento de 24 horas — aquela que abre quando o cliente escreve. Fora da janela, o caminho é template aprovado, que tem regras próprias de botão e passa por revisão da Meta. O funcionamento da janela está em a janela de 24 horas do WhatsApp.

Isso muda o desenho: o menu bonito com botões não serve como primeira mensagem de uma campanha. Ele serve como resposta a quem já falou com você.

2. Não funcionam em grupo. A documentação da Groups API lista mensagens interativas entre os tipos não suportados. Em grupo é texto, mídia e template — assunto que detalhamos em grupos na API Oficial.

Como decidir entre botão e lista

Sem teoria:

Use botão quando forem até três opções e a decisão for imediata. Ele aparece na conversa, sem clique extra. É o formato certo para “sim ou não”, “agora ou depois”, “falar com humano”.

Use lista quando forem de quatro a dez opções que merecem ser lidas. Ela custa um toque a mais, mas aceita descrição por item, o que evita escolha errada.

Acima de dez opções, o problema não é o formato. É o menu.

E quando a operação não cabe em dez?

Essa é a pergunta que aparece em toda empresa com muitos produtos ou muitos setores. Três saídas que funcionam, em ordem de preferência:

1. Encadeie. Uma lista de sete categorias que leva a outra lista de sete itens dá 49 destinos com dois toques. Dez por tela é limite de tela, não de operação.

2. Deixe a pessoa escrever. É o que mudou de verdade com a IA: em vez de obrigar o cliente a encontrar sua necessidade dentro de um menu, deixe que ele diga com as palavras dele e roteie a partir disso. Menu grande existia porque a máquina não entendia texto — hoje ela entende.

3. Corte o que ninguém escolhe. Quase todo menu tem opções que respondem por menos de 2% dos toques. Elas ocupam linha, atrapalham quem procura o que interessa e existem porque alguém achou que deveriam existir. O relatório de escolhas responde isso em uma tarde.

O melhor menu costuma ser o menor. E o segundo melhor é o que a pessoa nem precisa ver, porque escreveu o que queria e foi direto para o lugar certo.

Detalhes que evitam retrabalho

Escreva os textos antes de desenhar o fluxo. Contando caracteres. Metade dos ajustes de última hora é título que não coube.

Toda tela precisa de saída. “Falar com atendente” tem que estar disponível sempre — e é gatilho de escalonamento, tema de quando o bot deve passar a conversa para um humano.

Não use botão para confirmar o que exige texto. “Confirmar endereço” como botão é ótimo; “informar endereço” não é.

Meça as escolhas, não só o volume. Saber qual opção ninguém toca vale mais do que saber quantas conversas entraram.

Lembre da conta que muda em outubro. A partir de 1º de outubro de 2026, mensagens de serviço passam a ser cobradas. Menu com três níveis desnecessários deixa de ser só chato: vira custo por conversa. O contexto está em a Meta vai cobrar mensagens de serviço.

Onde a gente entra

O AtendeChat é parceiro oficial da Meta e monta esses fluxos na API Oficial, que é onde botões e listas existem — no aplicativo comum, não.

Em volta deles entregamos o que faz o menu ter para onde levar: vários atendentes no mesmo número, fila de distribuição por setor escolhido, histórico centralizado, funil em kanban, relatórios que mostram qual opção foi escolhida e onde a conversa parou, e integração com os seus sistemas para o menu responder com dado de verdade em vez de texto fixo.

Conduzimos com você a verificação de negócio, o registro do número e a aprovação dos templates.

Se hoje o seu atendimento começa com “digite 1 para vendas”, fale com a gente: dá para trocar por botão, por lista ou por deixar o cliente simplesmente dizer o que precisa — e as três opções são melhores do que pedir para ele digitar um número.

Fontes

  1. Meta — Interactive reply buttons messages: até 3 botões, título de 20 caracteres, unicidade dos títulos e limites de corpo e rodapé
  2. Meta — Interactive list messages: até 10 seções com 10 linhas no total e limites de caracteres de cada campo
  3. Meta — Groups API: mensagens interativas não são suportadas em grupos
  4. Meta — Pricing on the WhatsApp Business Platform: janela de atendimento de 24 horas e exigência de template fora dela

Rode seu WhatsApp na API Oficial da Meta

O AtendeChat é parceiro oficial da Meta: multiatendimento, Kanban, campanhas e IA — dentro das regras.

Leia também