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

# Strumenti WhatsApp

## Panoramica

Puoi fornire al tuo agente uno strumento per inviare messaggi su WhatsApp, anche durante le conversazioni su un altro canale, ad esempio il telefono.

L'integrazione WhatsApp offre tre strumenti:

* **Invia messaggio** — invia un messaggio modello a qualsiasi utente WhatsApp. Funziona da qualsiasi canale, quindi un agente telefonico può, ad esempio, inviare una conferma al WhatsApp del chiamante. Questa pagina tratta questo strumento.
* **Invia pulsanti interattivi** e **Invia elenco interattivo** — offrono all'utente di una conversazione WhatsApp attiva opzioni selezionabili con un tocco. Funzionano solo all'interno delle conversazioni di messaggistica WhatsApp: consulta i [messaggi interattivi](/docs/it/eleven-agents/whatsapp/interactive-messages).

## Configurazione

#### Importa il tuo account

Segui le istruzioni [qui](/docs/it/eleven-agents/whatsapp) per importare il tuo account WhatsApp Business.

#### Aggiungi un'integrazione

Vai alla [pagina Integrazioni](https://elevenlabs.io/app/agents/integrations), fai clic sul pulsante **\_Aggiungi
integrazione \_**, seleziona WhatsApp e collega il tuo account:

![Integrazione WhatsApp](/docs/_fern-img/e560b1b2a4345bd2fbe9519f7146b87d195268955d2b2aa2c6221629d97e4384.webp)

#### Aggiungi uno strumento

Vai alla [pagina Strumenti](https://elevenlabs.io/app/agents/tools), fai clic sul pulsante **\_Aggiungi strumento
di integrazione \_**, seleziona l'integrazione WhatsApp e lo strumento **\_ Invia messaggio \_**:

![Strumento WhatsApp](/docs/_fern-img/e85dcc3a3e3581250604311c516e080fb7f61f100b98b4b55be5f6071866e888.webp)

## Usare lo strumento

#### Crea un modello di messaggio

Vai a [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/), apri la pagina
***Gestisci modelli*** e crea un modello di messaggio:

![Modello di messaggio WhatsApp](/docs/_fern-img/e2d2c8bcab0b4c664261a57658627fd4368fc00e4768e4bd4c16264c59d07e16.webp)

> **Info**
>
> Al momento lo strumento supporta solo i parametri nel corpo del messaggio.

#### Configura il tuo agente

Vai alla configurazione del tuo agente e aggiungi lo strumento:

![Configurazione dell'agente: strumenti](/docs/_fern-img/0e078a4206030111493387ec6c9bc2235106ac3cb763d4555dd1ae7307c6d46a.webp)

Nel system prompt, indica all'agente:

* quando usare lo strumento
* quale nome del modello e codice lingua usare
* quali parametri passare

![Configurazione dell'agente: prompt](/docs/_fern-img/893aa34f7bd3e01a0cbb919f08f801398de318d46e1d8d1a6c72a945193f7de9.webp)

#### Test

Testa la configurazione dello strumento:

![Conversazione di test](/docs/_fern-img/47d48232a04cd47112d5637288c6225761f7f66f3016f5fc7d9cf38a34b3782d.webp)![Messaggio di test ricevuto](/docs/_fern-img/6b3809101caa5d38cf7ea761feb38f4ee316bfde4bef20e2e22eca6b14d0262f.webp)

## Parametri e codici lingua

Lo strumento compila solo i parametri del **corpo** del modello: i modelli con intestazioni o pulsanti parametrizzati non sono supportati da questo strumento. Il destinatario è un ID utente WhatsApp: solo cifre, con prefisso internazionale e senza `+` (ad esempio `14155552671`). Consulta le [regole sul formato del numero del destinatario](/docs/it/eleven-agents/whatsapp/outbound#recipient-number-format) per le particolarità specifiche dei vari Paesi.

Il codice lingua del modello deve corrispondere alla lingua con cui il modello è stato creato in WhatsApp Manager: consulta i [codici lingua supportati](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages/). Un errore comune è passare `en` per un modello creato come `en_US` (o viceversa); Meta li considera modelli diversi.

## Risoluzione dei problemi

* **Modello non trovato**: il nome del modello o il codice lingua non corrisponde esattamente a quello in WhatsApp Manager, oppure il modello appartiene a un account WhatsApp Business diverso da quello collegato.
* **Messaggio accettato ma non consegnato**: il modello non è approvato, manca un parametro del corpo oppure l'account ha problemi di pagamento. Consulta [Risoluzione dei problemi e domande frequenti](/docs/it/eleven-agents/whatsapp/troubleshooting#message-accepted-but-not-delivered).
* **L'agente passa parametri errati**: indica nel system prompt i nomi esatti dei parametri del modello e i valori previsti, e fornisci un esempio di invocazione.