Airtable | ElevenLabs Documentation

La tua receptionist può cercare un chiamante in una tabella Airtable e aggiungere un nuovo record, ad esempio un lead o una richiesta di richiamata. Le ricerche usano l’API di Airtable. I nuovi record passano tramite un’automazione Airtable, perché l’API richiede campi annidati in un modo che gli strumenti webhook non possono inviare.

Cerca record

Crea un token di accesso personale

Vai su airtable.com/create/tokens e crea un token con l’ambito data.records:read. In Accesso, aggiungi solo la base necessaria alla tua receptionist.

Trova gli ID della base e della tabella

Apri la tabella nel browser. L’URL contiene l’ID della base, che inizia con app, e l’ID della tabella, che inizia con tbl.

Crea lo strumento webhook

Vai su Integrazioni, seleziona Aggiungi integrazione e scegli Webhook Tool.

Campo	Valore
Nome	`find_airtable_record`
Descrizione	”Cerca il chiamante nella nostra tabella clienti. Usalo quando un chiamante chiede informazioni su una prenotazione, un ordine o un account esistente.”
Metodo	GET
URL	`https://api.airtable.com/v0/BASE_ID/TABLE_ID`
Header della richiesta	`Authorization`: `Bearer` seguito dal tuo token
Parametri di query	`filterByFormula` (stringa, obbligatorio): “Una formula Airtable che corrisponde al chiamante, ad esempio `{Phone} = '+14155550123'`. Usa i nomi dei campi Phone e Name.” `maxRecords` (numero, obbligatorio): “Sempre 5.”
Assegna agli agenti	Receptionist

Seleziona Abilita.

Sostituisci Phone e Name nella descrizione con i nomi dei campi della tua tabella, così la receptionist scriverà formule corrispondenti.

Aggiungi record

Crea un’automazione

Nella tua base, apri Automazioni, seleziona Crea automazione e scegli il trigger Quando viene ricevuto un webhook. Copia l’URL del webhook. I trigger webhook non sono disponibili in tutti i piani Airtable.

Crea lo strumento webhook

Vai su Integrazioni, seleziona Aggiungi integrazione e scegli Webhook Tool.

Campo	Valore
Nome	`add_airtable_record`
Descrizione	”Salva un nuovo lead quando un chiamante desidera un preventivo o una richiamata.”
Metodo	POST
URL	L’URL del webhook dell’automazione
Parametri del body	Uno per ogni campo da compilare, ad esempio `name`, `phone` e `request` (tutti stringhe, obbligatori)
Assegna agli agenti	Receptionist

Invia un esempio e mappa i campi

Testa la tua receptionist con una conversazione che attivi lo strumento. Nell’automazione, seleziona Testa trigger per caricare la richiesta, quindi aggiungi un’azione Crea record e mappa ogni parametro del body a un campo.

Attiva l’automazione

Attiva l’automazione.

Risoluzione dei problemi

Problema	Cosa controllare
401 o 403 nelle ricerche	Il token richiede l’ambito `data.records:read` e l’accesso a questa base.
422 `INVALID_FILTER_BY_FORMULA`	I nomi dei campi nella descrizione dello strumento devono corrispondere esattamente a quelli della tabella, incluse le maiuscole e minuscole.
Le ricerche non restituiscono risultati	I numeri di telefono devono essere archiviati nello stesso formato inviato dalla receptionist, ad esempio `+14155550123`.
Non vengono aggiunti record	L’automazione deve essere attiva e Crea record deve mappare i campi dal trigger webhook.
429 da Airtable	Airtable consente 5 richieste al secondo per base. Riduci altro traffico API sulla base.