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

# n8n

Collega un workflow n8n a uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks). Quando una conversazione corrisponde alla descrizione dello strumento, il tuo receptionist raccoglie i dettagli, chiama il workflow e legge la risposta al chiamante. Tramite n8n, il receptionist può raggiungere qualsiasi app a cui n8n si connette.

## Crea il workflow

### Aggiungi un trigger Webhook

In n8n, crea un workflow e aggiungi un nodo **Webhook**. Imposta **HTTP Method** su `POST`.

### Proteggi il webhook

Imposta **Authentication** su **Header Auth** e crea una credenziale con un nome header, ad esempio `X-Reception-Key`, e un valore casuale lungo. Reception.ai invia questo header a ogni chiamata.

### Restituisci una risposta

Imposta **Respond** su **Using 'Respond to Webhook' Node**. Aggiungi i passaggi del workflow, quindi termina con un nodo **Respond to Webhook** che restituisca JSON, ad esempio `{"available": true, "next_slot": "Tuesday 10am"}`. Il tuo receptionist legge questa risposta per decidere cosa dire.

### Attiva il workflow

Attiva il workflow e copia la **Production URL** dal nodo Webhook. L'URL di test funziona solo mentre l'editor è in ascolto.

## Crea lo strumento webhook

Vai a **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**.

| Campo                | Valore                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**             | Cosa fa il workflow, ad esempio `check_service_area`                                                                                 |
| **Description**      | Quando usarlo, ad esempio "Verifica se serviamo il codice postale del chiamante. Usalo prima di prenotare una visita in sede."       |
| **Method**           | POST                                                                                                                                 |
| **URL**              | L'URL di produzione del workflow                                                                                                     |
| **Request Headers**  | Il nome e il valore dell'header della credenziale n8n                                                                                |
| **Body Parameters**  | Un parametro per ogni valore necessario al workflow, ad esempio `zip_code` (stringa, obbligatorio). n8n li legge da `body.zip_code`. |
| **Assign to agents** | **Receptionist**                                                                                                                     |

Seleziona **Enable**, quindi [testa il tuo receptionist](/docs/it/reception-ai/receptionist/testing) con una conversazione che dovrebbe attivare il workflow. Ogni esecuzione appare nell'elenco **Executions** di n8n.

> **Note**
>
> I parametri del body sono valori semplici che il tuo receptionist compila in base alla conversazione. Per inviare un
> valore fisso, impostalo invece all'interno del workflow.

## Esponi più workflow tramite MCP

Per fornire al tuo receptionist più workflow n8n contemporaneamente, usa invece il nodo **MCP Server Trigger** di n8n. Collega i workflow o i nodi strumento che vuoi esporre, imposta l'autenticazione del trigger su bearer e attivalo. In Reception.ai, aggiungi un [server MCP](/docs/it/reception-ai/integrations/mcp-server) con l'URL di produzione del trigger e il token bearer come **Secret Token**, quindi assegna gli strumenti nella scheda **Tools**.

## Risoluzione dei problemi

| Problema                                             | Cosa verificare                                                                                                                                                                    |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Non appare alcuna esecuzione in n8n                  | Il workflow deve essere attivo e lo strumento deve usare l'URL di produzione.                                                                                                      |
| Il workflow restituisce 403                          | Il nome e il valore dell'header in Reception.ai devono corrispondere esattamente alla credenziale n8n.                                                                             |
| Il receptionist dice che lo strumento non è riuscito | Il workflow deve terminare entro il **Response timeout** dello strumento. Il valore predefinito è 20 secondi e può arrivare fino a 120.                                            |
| Il receptionist non chiama mai lo strumento          | Assicurati che la descrizione dello strumento indichi le situazioni in cui usarlo. Puoi anche aggiungere una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures). |