> 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

Votre réceptionniste peut rechercher un appelant dans une table Airtable et ajouter un nouvel enregistrement, par exemple un prospect ou une demande de rappel. Les recherches utilisent l'API d'Airtable. Les nouveaux enregistrements passent par une automatisation Airtable, car l'API attend des champs imbriqués que les outils webhook ne peuvent pas envoyer.

## Rechercher des enregistrements

### Créer un jeton d'accès personnel

Accédez à [airtable.com/create/tokens](https://airtable.com/create/tokens) et créez un jeton avec l'autorisation `data.records:read`. Dans **Access**, ajoutez uniquement la base dont votre réceptionniste a besoin.

### Trouver les ID de la base et de la table

Ouvrez la table dans votre navigateur. L'URL contient l'ID de la base, qui commence par `app`, et l'ID de la table, qui commence par `tbl`.

### Créer l'outil webhook

Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**.

| Champ                     | Valeur                                                                                                                                                                                                                               |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                   | `find_airtable_record`                                                                                                                                                                                                               |
| **Description**           | "Recherchez l'appelant dans notre table de clients. Utilisez cet outil lorsqu'un appelant pose une question sur une réservation, une commande ou un compte existant."                                                                |
| **Méthode**               | GET                                                                                                                                                                                                                                  |
| **URL**                   | `https://api.airtable.com/v0/BASE_ID/TABLE_ID`                                                                                                                                                                                       |
| **En-têtes de requête**   | `Authorization` : `Bearer ` suivi de votre jeton                                                                                                                                                                                     |
| **Paramètres de requête** | `filterByFormula` (chaîne, obligatoire) : "Une formule Airtable qui correspond à l'appelant, par exemple `{Phone} = '+14155550123'`. Utilisez les noms de champs Phone et Name."  `maxRecords` (nombre, obligatoire) : "Toujours 5." |
| **Attribuer aux agents**  | **Receptionist**                                                                                                                                                                                                                     |

Sélectionnez **Enable**.

Remplacez `Phone` et `Name` dans la description par les noms de champs de votre table, afin que votre réceptionniste rédige des formules correspondantes.

## Ajouter des enregistrements

### Créer une automatisation

Dans votre base, ouvrez **Automations**, sélectionnez **Create automation**, puis choisissez le déclencheur **When webhook received**. Copiez l'URL du webhook. Les déclencheurs webhook ne sont pas inclus dans tous les forfaits Airtable.

### Créer l'outil webhook

Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**.

| Champ                    | Valeur                                                                                               |
| ------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Nom**                  | `add_airtable_record`                                                                                |
| **Description**          | "Enregistrez un nouveau prospect lorsqu'un appelant souhaite un devis ou un rappel."                 |
| **Méthode**              | POST                                                                                                 |
| **URL**                  | L'URL webhook de l'automatisation                                                                    |
| **Paramètres du corps**  | Un par champ à renseigner, par exemple `name`, `phone` et `request` (tous des chaînes, obligatoires) |
| **Attribuer aux agents** | **Receptionist**                                                                                     |

### Envoyer un exemple et associer les champs

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) avec une conversation qui déclenche l'outil. Dans l'automatisation, sélectionnez **Test trigger** pour charger la requête, puis ajoutez une action **Create record** et associez chaque paramètre du corps à un champ.

### Activer l'automatisation

Activez l'automatisation.

## Résolution des problèmes

| Problème                          | Vérifications à effectuer                                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| 401 ou 403 lors des recherches    | Le jeton requiert l'autorisation `data.records:read` et l'accès à cette base.                                                       |
| 422 `INVALID_FILTER_BY_FORMULA`   | Les noms de champs dans la description de l'outil doivent correspondre exactement à ceux de la table, y compris la casse.           |
| Les recherches ne renvoient rien  | Les numéros de téléphone doivent être enregistrés au même format que celui envoyé par votre réceptionniste, tel que `+14155550123`. |
| Aucun enregistrement n'est ajouté | L'automatisation doit être activée et **Create record** doit associer les champs du déclencheur webhook.                            |
| 429 d'Airtable                    | Airtable autorise 5 requêtes par seconde et par base. Réduisez les autres appels API sur la base.                                   |