Airtable | ElevenLabs Documentation

Je receptionist kan een beller opzoeken in een Airtable-tabel en een nieuw record toevoegen, zoals een lead of een terugbelverzoek. Zoekopdrachten gebruiken de API van Airtable. Nieuwe records gaan via een Airtable-automatisering, omdat de API velden verwacht die op een manier zijn genest die webhooktools niet kunnen verzenden.

Records opzoeken

Maak een persoonlijk toegangstoken

Ga naar airtable.com/create/tokens en maak een token met de scope data.records:read. Voeg onder Access alleen de base toe die je receptionist nodig heeft.

Zoek de base- en tabel-ID’s op

Open de tabel in je browser. De URL bevat de base-ID, die begint met app, en de tabel-ID, die begint met tbl.

Maak de webhooktool

Ga naar Integrations, selecteer Add integration en kies Webhook Tool.

Veld	Waarde
Naam	`find_airtable_record`
Beschrijving	”Zoek de beller op in onze klantentabel. Gebruik dit wanneer een beller vraagt naar een bestaande boeking, bestelling of account.”
Methode	GET
URL	`https://api.airtable.com/v0/BASE_ID/TABLE_ID`
Requestheaders	`Authorization`: `Bearer` gevolgd door je token
Queryparameters	`filterByFormula` (string, verplicht): “Een Airtable-formule die overeenkomt met de beller, bijvoorbeeld `{Phone} = '+14155550123'`. Gebruik de veldnamen Phone en Name.” `maxRecords` (number, verplicht): “Altijd 5.”
Toewijzen aan agents	Receptionist

Selecteer Enable.

Vervang Phone en Name in de beschrijving door de veldnamen van je tabel, zodat je receptionist formules schrijft die overeenkomen.

Records toevoegen

Maak een automatisering

Open in je base Automations, selecteer Create automation en kies de trigger When webhook received. Kopieer de webhook-URL. Webhooktriggers zijn niet beschikbaar in elk Airtable-abonnement.

Maak de webhooktool

Ga naar Integrations, selecteer Add integration en kies Webhook Tool.

Veld	Waarde
Naam	`add_airtable_record`
Beschrijving	”Sla een nieuwe lead op wanneer een beller een offerte of een terugbelverzoek wil.”
Methode	POST
URL	De webhook-URL van de automatisering
Bodyparameters	Eén per veld dat je wilt invullen, bijvoorbeeld `name`, `phone` en `request` (allemaal strings, verplicht)
Toewijzen aan agents	Receptionist

Stuur een voorbeeld en koppel velden

Test je receptionist met een gesprek dat de tool activeert. Selecteer in de automatisering Test trigger om de request te laden, voeg daarna een actie Create record toe en koppel elke bodyparameter aan een veld.

Schakel de automatisering in

Schakel de automatisering in.

Problemen oplossen

Probleem	Wat je moet controleren
401 of 403 bij zoekopdrachten	Het token heeft de scope `data.records:read` en toegang tot deze base nodig.
422 `INVALID_FILTER_BY_FORMULA`	De veldnamen in de beschrijving van de tool moeten exact overeenkomen met die in de tabel, inclusief hoofdletters.
Zoekopdrachten geven niets terug	Telefoonnummers moeten zijn opgeslagen in dezelfde indeling als je receptionist verzendt, zoals `+14155550123`.
Er worden geen records toegevoegd	De automatisering moet ingeschakeld zijn en Create record moet velden uit de webhooktrigger koppelen.
429 van Airtable	Airtable staat 5 requests per seconde per base toe. Verminder ander API-verkeer op de base.