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

# Airtable

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](https://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](/docs/it/reception-ai/receptionist/testing) 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.                                                      |