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

# Webhook

L'integrazione **Webhook Tool** espone i tuoi endpoint HTTP come strumenti che il tuo receptionist o assistente aziendale può chiamare durante le conversazioni. L'IA decide quando chiamare l'endpoint in base alla conversazione.

## Come funzionano gli strumenti webhook

Quando crei uno strumento webhook, definisci:

1. Un endpoint HTTP da chiamare.
2. Una descrizione della sua funzione, affinché l'IA sappia quando utilizzarlo.
3. I parametri che l'IA deve raccogliere dalla conversazione.

Durante una chiamata, quando la conversazione corrisponde allo scopo dello strumento, il tuo receptionist raccoglie i parametri, chiama l'endpoint e utilizza la risposta per continuare la conversazione.

## Creare uno strumento webhook

Vai a **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Webhook Tool**. Configura i campi seguenti e seleziona **Abilita**. Puoi aggiungere più strumenti webhook.

| Campo                                | Descrizione                                                                |
| ------------------------------------ | -------------------------------------------------------------------------- |
| **Nome**                             | Nome dello strumento visualizzato dall'IA, ad esempio `check_order_status` |
| **Descrizione**                      | Quando e perché utilizzare questo strumento                                |
| **Metodo**                           | GET, POST, PUT, PATCH o DELETE                                             |
| **URL**                              | Il tuo endpoint HTTP                                                       |
| **Timeout della risposta (secondi)** | Quanto attendere il tuo server: da 5 a 120 secondi, predefinito 20         |
| **Assegna agli agenti**              | **Receptionist**, **Agente assistente** o entrambi                         |
| **Disabilita le interruzioni**       | Impedisce al chiamante di interrompere mentre lo strumento è in esecuzione |
| **Header della richiesta**           | Header facoltativi inviati con ogni richiesta, ad esempio una chiave API   |
| **Parametri del body**               | Parametri inviati nel body della richiesta                                 |
| **Parametri query**                  | Parametri inviati come stringhe di query URL                               |

### Parametri

Ogni parametro include:

* **Chiave**: il nome del campo.
* **Tipo**: `string`, `number` o `boolean`.
* **Descrizione**: il valore che l'IA deve estrarre dalla conversazione.
* **Obbligatorio**: se l'IA deve raccoglierlo prima della chiamata.

## Casi d'uso

| Scenario                  | Descrizione                                                              | Metodo |
| ------------------------- | ------------------------------------------------------------------------ | ------ |
| Ricerca CRM               | Cerca le informazioni del cliente nel tuo sistema                        | GET    |
| Controllo dell'inventario | Controlla la disponibilità dei prodotti in tempo reale                   | GET    |
| Acquisizione lead         | Invia i dati del chiamante al tuo sistema di marketing                   | POST   |
| Creazione ticket          | Crea un ticket di assistenza durante la chiamata                         | POST   |
| Preventivo                | Calcola un preventivo personalizzato in base alle esigenze del chiamante | POST   |

## Esempio

Un'azienda idraulica crea uno strumento webhook:

* **Nome:** `check_service_area`
* **Descrizione:** "Controlla se serviamo il CAP del chiamante e qual è la prossima fascia oraria disponibile."
* **URL:** `https://api.mybusiness.com/check-area`
* **Metodo:** POST
* **Header della richiesta:** `Authorization` impostato sulla chiave API dell'azienda
* **Parametri del body:** `zip_code` (string, obbligatorio), `service_type` (string, obbligatorio)

Quando un chiamante chiede informazioni sul servizio nella sua zona, il receptionist raccoglie il suo CAP, chiama il webhook e gli comunica il risultato.

Gli strumenti webhook sono disponibili in tutti i piani.