n8n | ElevenLabs Documentation

Collega un workflow n8n a uno strumento webhook. 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 con una conversazione che dovrebbe attivare il workflow. Ogni esecuzione appare nell’elenco Executions di n8n.

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