> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 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](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/).

## Abilitare gli strumenti

#### Aggiungi l'integrazione WhatsApp

Importa il tuo account WhatsApp Business ([istruzioni](/docs/it/eleven-agents/whatsapp)), quindi vai alla
[pagina Integrazioni](https://elevenlabs.io/app/agents/integrations), fai clic sul pulsante **\_Aggiungi
integrazione \_**, seleziona WhatsApp e collega il tuo account.

#### Aggiungi gli strumenti

Vai alla [pagina Strumenti](https://elevenlabs.io/app/agents/tools), fai clic sul pulsante **\_Aggiungi strumento
di integrazione \_**, seleziona l'integrazione WhatsApp e aggiungi gli strumenti **\_ Invia pulsanti interattivi \_** e
***Invia lista interattiva***.

> **Warning**
>
> Se hai importato più di un account WhatsApp, ognuno ha la propria integrazione WhatsApp.
> Assicurati di aggiungere gli strumenti dall'integrazione collegata all'account usato dal tuo agente:
> gli strumenti aggiunti dall'integrazione di un altro account non funzioneranno nelle conversazioni
> di questo agente.

#### Collega gli strumenti al tuo agente

Aggiungi gli strumenti nella configurazione dell'agente. Gli strumenti inviano sempre messaggi all'utente della
conversazione in corso: l'agente sceglie il contenuto, mai il destinatario.

## Invia pulsanti interattivi

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

| Parametro     | Obbligatorio | Descrizione                                                                            |
| ------------- | ------------ | -------------------------------------------------------------------------------------- |
| `body_text`   | Sì           | Messaggio mostrato sopra i pulsanti. Max 1024 caratteri.                               |
| `buttons`     | Sì           | Da uno a tre pulsanti, nell'ordine di visualizzazione. I titoli devono essere univoci. |
| `footer_text` | No           | Testo piccolo mostrato sotto i pulsanti. Max 60 caratteri.                             |

Ogni pulsante ha:

| Campo   | Obbligatorio | Descrizione                                                                             |
| ------- | ------------ | --------------------------------------------------------------------------------------- |
| `id`    | Sì           | Identificatore restituito quando l'utente seleziona questo pulsante. Max 256 caratteri. |
| `title` | Sì           | Etichetta del pulsante. Max 20 caratteri.                                               |

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

| Parametro     | Obbligatorio | Descrizione                                                                                             |
| ------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
| `body_text`   | Sì           | Messaggio mostrato sopra la lista. Max 4096 caratteri.                                                  |
| `button_text` | Sì           | Etichetta del pulsante che apre la lista. Max 20 caratteri.                                             |
| `sections`    | Sì           | Da uno a 10 gruppi di opzioni. Una lista può contenere fino a 10 righe complessive in tutte le sezioni. |
| `header_text` | No           | Intestazione mostrata sopra il corpo del messaggio. Max 60 caratteri.                                   |
| `footer_text` | No           | Testo piccolo mostrato sotto la lista. Max 60 caratteri.                                                |

Ogni sezione ha:

| Campo   | Obbligatorio | Descrizione                                   |
| ------- | ------------ | --------------------------------------------- |
| `title` | Sì           | Intestazione della sezione. Max 24 caratteri. |
| `rows`  | Sì           | Da una a 10 opzioni in questa sezione.        |

Ogni riga ha:

| Campo         | Obbligatorio | Descrizione                                                                         |
| ------------- | ------------ | ----------------------------------------------------------------------------------- |
| `id`          | Sì           | Identificatore restituito quando l'utente seleziona questa riga. Max 200 caratteri. |
| `title`       | Sì           | Etichetta della riga. Max 24 caratteri.                                             |
| `description` | No           | Testo secondario mostrato sotto l'etichetta della riga. Max 72 caratteri.           |

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:

```text
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](/docs/it/eleven-agents/customization/procedures) gli indica come usarli al meglio.

> **Note**
>
> La procedura seguente è un modello, non è pronta da usare così com'è. Dopo averla copiata, adattala alle tue esigenze: modifica il
> trigger in base ai tuoi flussi, mantieni solo gli strumenti effettivamente disponibili per il tuo agente e riscrivi gli esempi
> delle opzioni e le regole in base al tuo caso d'uso.

#### Copia la procedura di esempio

```markdown
---
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](/docs/it/eleven-agents/whatsapp/outbound) per avviare le conversazioni.