Mensagens interativas

Visão geral

Em vez de pedir que o usuário digite uma resposta, seu agente pode enviar mensagens interativas do WhatsApp: até três botões de resposta selecionáveis ou uma lista de até dez opções. A seleção do usuário retorna como sua próxima mensagem, e o agente vê exatamente qual opção foi escolhida.

As mensagens interativas funcionam apenas em conversas ativas por mensagem no WhatsApp. Elas são enviadas pelo agente por meio de duas ferramentas de integração:

• Enviar botões interativos — até três botões de resposta, para pequenos conjuntos de opções.
• Enviar lista interativa — uma lista selecionável de opções agrupadas em seções, para mais de três opções.

Fonte: guia da Meta sobre mensagens interativas do WhatsApp.

Como ativar as ferramentas

Enviar botões interativos

Enviar botões interativos apresenta de uma a três opções na conversa atual por mensagem do WhatsApp.

Cada botão tem:

Enviar uma lista interativa

Enviar lista interativa apresenta opções agrupadas em seções na conversa atual por mensagem do WhatsApp. O usuário abre a lista e seleciona uma linha.

Cada seção tem:

Cada linha tem:

Se o agente gerar conteúdo acima de um limite, a chamada da ferramenta falhará e o agente receberá o motivo, para que possa tentar novamente com conteúdo mais curto.

Como orientar o agente

Informe ao agente no prompt de sistema quando oferecer opções. Por exemplo:

When you need the user to pick from a fixed set of options (appointment slots,
product variants, yes/no confirmations), use the Send Interactive Buttons tool
for up to 3 options or the Send Interactive List tool for more. Keep option
titles short. Do not use interactive messages for open-ended questions.

Opcional: adicione um procedimento para orientar o uso das ferramentas pelo agente

Dar as ferramentas ao agente é metade do trabalho — um procedimento informa como usá-las bem.

---
name: Offer choices with interactive messages
trigger: The user must pick from a fixed set of known options in a WhatsApp message conversation, such as appointment slots, product variants, or order confirmations.
---
Offer the options as an interactive message instead of asking the user
to type an answer.
1. Check which interactive tools you have. Prefer Send Interactive
   Buttons for 2–3 options and Send Interactive List for 4–10. If only
   one of the two is available, use it for any option count that fits its
   limits; if no interactive tool fits, ask the question in plain text.
   Never present more than 10 options; narrow them down with a question
   first.
2. Write a body_text that asks one clear question. Do not stack multiple
   questions into one interactive message.
3. Give every option a stable, machine-readable id (for example
   slot_2026-08-20_10am) and a short human title — 20 characters for
   buttons, 24 for list rows.
4. For lists, group related rows into titled sections, and add a
   description to a row only when its title alone is ambiguous.
5. Send the message with the tool, then wait for the user's reply. Do not
   send a second interactive message before the user responds to the first.
6. Treat the reply as the user's choice. Confirm it back in one short line
   and continue the flow.
Rules:
- Never use interactive messages for open-ended questions.
- When the fixed options may not cover everyone, include a final option
  such as "Something else" and follow up with a free-text question.
- If the tool call fails because content exceeds a limit, shorten titles
  and descriptions and retry once.
- If the user types an answer instead of tapping, accept it — do not
  re-send the options.

Restrições

• Mensagens interativas só podem ser enviadas em conversas por mensagem — não durante chamadas de voz do WhatsApp nem em outros canais.
• Os Fluxos do WhatsApp (formulários interativos) não são compatíveis. Se um usuário responder com uma resposta de Fluxo, ela não será enviada ao agente.
• Mensagens interativas são mensagens de sessão: elas só podem ser enviadas dentro de uma conversa ativa, não como o primeiro contato de saída. Use modelos de mensagem para iniciar conversas.