> 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

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