Enviando mensagens interativas: botões e listas
As mensagens interativas dão ao destinatário botões ou uma lista para tocar em vez de digitar. Existem dois tipos, botões de resposta e mensagens de lista, e ambos têm limites pequenos e fixos que decidem o desenho da conversa mais do que qualquer outra coisa.
Botões de resposta permitidos em uma mensagem interativa.
Linhas permitidas numa mensagem de lista, distribuídas em até 10 seções.
Caracteres permitidos no título de um botão.
Botões de resposta
Até três botões embaixo de uma mensagem. O destinatário toca em um e a resposta chega no seu webhook como uma mensagem de entrada comum carregando o id do botão, então você faz a correspondência pelo id e não pelo rótulo. Os títulos têm limite de vinte caracteres, o que é mais curto do que parece e é a restrição que normalmente obriga a reescrever.
- Máximo de três botões por mensagem.
- Título limitado a 20 caracteres.
- Cada botão carrega um id escolhido por você, devolvido na resposta.
- Cabeçalho, corpo e rodapé opcionais em volta deles.
Mensagens de lista
Um único botão que abre um menu de até dez linhas, agrupadas em até dez seções. Cada linha tem um título, uma descrição opcional e um id. Use quando três botões não bastarem, e lembre que o destinatário precisa abrir a lista antes de ver qualquer coisa dentro dela, então o rótulo do botão é que carrega o peso.
- Até 10 linhas no total, distribuídas em até 10 seções.
- Título da linha limitado a 24 caracteres, descrição a 72.
- Uma lista por mensagem, e ela não pode ser combinada com botões.
- Não está disponível em mensagens de template de todas as categorias.
Como a resposta chega
Pelo mesmo webhook de mensagens de qualquer outra mensagem de entrada, com um objeto interativo nomeando o id do botão ou da linha. Não é preciso assinar nada à parte.
Faça a correspondência pelo id, e não pelo título. Os títulos são reescritos por quem edita o texto, e um handler que compara texto quebra silenciosamente na primeira vez em que alguém corrigir um erro de digitação.
O que a Coexistência muda
Nada nos botões e nas listas em si. Eles são mensagens comuns da Cloud API e funcionam num número em Coexistência do mesmo jeito que em qualquer outro.
O que muda é onde a resposta cai: o toque do cliente chega tanto no app do WhatsApp Business no celular quanto no seu webhook, porque um número em Coexistência entrega nos dois. Um handler que responde automaticamente deveria levar em conta que um humano pode responder a mesma mensagem pelo app.
Erros comuns
- Fazer a correspondência das respostas pelo título do botão. Títulos são editados; ids não.
- Projetar para mais de três botões. O limite é rígido e não existe contorno.
- Esquecer que um humano pode responder ao mesmo toque pelo app do WhatsApp Business.
A EasyCoexistence roteia os eventos de mensagem, inclusive as respostas interativas, da Meta direto para o seu endpoint, então um toque de botão chega ao seu sistema com o id intacto.
Perguntas frequentes
Quantos botões eu posso enviar?
Três. É um limite rígido da plataforma, sem contorno possível.
O que volta quando alguém toca?
Uma mensagem de entrada comum no webhook de mensagens, carregando o id que você atribuiu àquele botão ou àquela linha.
Posso combinar botões e uma lista?
Não. Uma mensagem leva um ou a outra.
Isso custa mais caro?
Não. São mensagens comuns, precificadas pela Meta do mesmo jeito que qualquer outra naquela conversa.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em