Airtable | ElevenLabs Documentation

Ihre Rezeption kann einen Anrufer in einer Airtable-Tabelle suchen und einen neuen Datensatz hinzufügen, etwa einen Lead oder eine Rückrufanfrage. Suchen verwenden die API von Airtable. Neue Datensätze werden über eine Airtable-Automatisierung erstellt, da die API Felder in einer Verschachtelung erwartet, die Webhook-Tools nicht senden können.

Datensätze suchen

Persönlichen Zugriffstoken erstellen

Gehen Sie zu airtable.com/create/tokens und erstellen Sie einen Token mit dem Bereich data.records:read. Fügen Sie unter Access nur die Base hinzu, die Ihre Rezeption benötigt.

Base- und Tabellen-IDs finden

Öffnen Sie die Tabelle im Browser. Die URL enthält die Base-ID, die mit app beginnt, und die Tabellen-ID, die mit tbl beginnt.

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`find_airtable_record`
Beschreibung	”Suchen Sie den Anrufer in unserer Kundentabelle. Verwenden Sie dies, wenn ein Anrufer nach einer bestehenden Buchung, Bestellung oder einem Konto fragt.”
Methode	GET
URL	`https://api.airtable.com/v0/BASE_ID/TABLE_ID`
Anfrage-Header	`Authorization`: `Bearer` gefolgt von Ihrem Token
Abfrageparameter	`filterByFormula` (string, erforderlich): “Eine Airtable-Formel, die zum Anrufer passt, zum Beispiel `{Phone} = '+14155550123'`. Verwenden Sie die Feldnamen Phone und Name.” `maxRecords` (number, erforderlich): “Immer 5.”
Agenten zuweisen	Receptionist

Wählen Sie Enable.

Ersetzen Sie Phone und Name in der Beschreibung durch die Feldnamen Ihrer Tabelle, damit Ihre Rezeption passende Formeln erstellt.

Datensätze hinzufügen

Automatisierung erstellen

Öffnen Sie in Ihrer Base Automations, wählen Sie Create automation und dann den Trigger When webhook received. Kopieren Sie die Webhook-URL. Webhook-Trigger sind nicht in jedem Airtable-Tarif verfügbar.

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`add_airtable_record`
Beschreibung	”Speichern Sie einen neuen Lead, wenn ein Anrufer ein Angebot oder einen Rückruf wünscht.”
Methode	POST
URL	Die Webhook-URL der Automatisierung
Body-Parameter	Einer pro auszufüllendem Feld, zum Beispiel `name`, `phone` und `request` (alle string, erforderlich)
Agenten zuweisen	Receptionist

Beispiel senden und Felder zuordnen

Testen Sie Ihre Rezeption mit einem Gespräch, das das Tool auslöst. Wählen Sie in der Automatisierung Test trigger, um die Anfrage zu laden. Fügen Sie dann die Aktion Create record hinzu und ordnen Sie jeden Body-Parameter einem Feld zu.

Automatisierung aktivieren

Aktivieren Sie die Automatisierung.

Fehlerbehebung

Problem	Prüfen Sie
401 oder 403 bei Suchen	Der Token benötigt den Bereich `data.records:read` und Zugriff auf diese Base.
422 `INVALID_FILTER_BY_FORMULA`	Die Feldnamen in der Tool-Beschreibung müssen exakt mit der Tabelle übereinstimmen, einschließlich Groß- und Kleinschreibung.
Suchen liefern keine Ergebnisse	Telefonnummern müssen im selben Format gespeichert sein, das Ihre Rezeption sendet, etwa `+14155550123`.
Keine Datensätze werden hinzugefügt	Die Automatisierung muss aktiviert sein, und Create record muss Felder vom Webhook-Trigger zuordnen.
429 von Airtable	Airtable erlaubt 5 Anfragen pro Sekunde und Base. Reduzieren Sie anderen API-Traffic auf der Base.