Airtable | ElevenLabs Documentation

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