Messaggi interattivi

Panoramica

Invece di chiedere all’utente di digitare una risposta, il tuo agente può inviare messaggi interattivi di WhatsApp: fino a tre pulsanti di risposta selezionabili o una lista di fino a dieci opzioni. La selezione dell’utente viene restituita come messaggio successivo e l’agente vede esattamente quale opzione è stata scelta.

I messaggi interattivi funzionano solo nelle conversazioni WhatsApp attive tramite messaggi. L’agente li invia tramite due strumenti di integrazione:

• Invia pulsanti interattivi — fino a tre pulsanti di risposta, per piccoli gruppi di scelte.
• Invia lista interattiva — una lista selezionabile di opzioni raggruppate in sezioni, per più di tre scelte.

Fonte: guida di Meta ai messaggi interattivi di WhatsApp.

Abilitare gli strumenti

Invia pulsanti interattivi

Invia pulsanti interattivi presenta da una a tre scelte nella conversazione WhatsApp corrente tramite messaggi.

Ogni pulsante ha:

Invia una lista interattiva

Invia lista interattiva presenta opzioni raggruppate in sezioni nella conversazione WhatsApp corrente tramite messaggi. L’utente apre la lista e seleziona una riga.

Ogni sezione ha:

Ogni riga ha:

Se l’agente produce contenuti che superano un limite, la chiamata dello strumento non riesce e l’agente viene informato del motivo, così può riprovare con contenuti più brevi.

Istruire l’agente

Indica all’agente nel prompt di sistema quando offrire delle scelte. Ad esempio:

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.

Facoltativo: aggiungi una procedura per guidare l’uso degli strumenti da parte dell’agente

Fornire gli strumenti all’agente è solo metà del lavoro: una procedura gli indica come usarli al meglio.

---
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.

Limitazioni

• I messaggi interattivi possono essere inviati solo nelle conversazioni tramite messaggi, non durante le chiamate vocali WhatsApp né su altri canali.
• I Flussi WhatsApp (moduli interattivi) non sono supportati. Se un utente risponde con una risposta da un Flusso, non viene inoltrata all’agente.
• I messaggi interattivi sono messaggi di sessione: possono essere inviati solo all’interno di una conversazione attiva, non come primo contatto in uscita. Usa i template di messaggio per avviare le conversazioni.