> 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

Twój recepcjonista może wyszukać dzwoniącego w tabeli Airtable i dodać nowy rekord, na przykład potencjalnego klienta lub prośbę o oddzwonienie. Wyszukiwanie używa API Airtable. Nowe rekordy są dodawane przez automatyzację Airtable, ponieważ API wymaga pól zagnieżdżonych w sposób, którego narzędzia webhook nie mogą wysłać.

## Wyszukiwanie rekordów

### Utwórz osobisty token dostępu

Wejdź na [airtable.com/create/tokens](https://airtable.com/create/tokens) i utwórz token z zakresem `data.records:read`. W sekcji **Access** dodaj tylko bazę potrzebną recepcjoniście.

### Znajdź identyfikatory bazy i tabeli

Otwórz tabelę w przeglądarce. Adres URL zawiera identyfikator bazy, który zaczyna się od `app`, oraz identyfikator tabeli, który zaczyna się od `tbl`.

### Utwórz narzędzie webhook

Wejdź w **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**.

| Pole                    | Wartość                                                                                                                                                                                                   |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `find_airtable_record`                                                                                                                                                                                    |
| **Opis**                | "Wyszukaj dzwoniącego w naszej tabeli klientów. Użyj tego, gdy dzwoniący pyta o istniejącą rezerwację, zamówienie lub konto."                                                                             |
| **Metoda**              | GET                                                                                                                                                                                                       |
| **URL**                 | `https://api.airtable.com/v0/BASE_ID/TABLE_ID`                                                                                                                                                            |
| **Nagłówki żądania**    | `Authorization`: `Bearer `, a następnie token                                                                                                                                                             |
| **Parametry zapytania** | `filterByFormula` (ciąg znaków, wymagany): "Formuła Airtable dopasowująca dzwoniącego, na przykład `{Phone} = '+14155550123'`. Użyj nazw pól Phone i Name."  `maxRecords` (liczba, wymagany): "Zawsze 5." |
| **Przypisz do agentów** | **Receptionist**                                                                                                                                                                                          |

Wybierz **Enable**.

Zastąp `Phone` i `Name` w opisie nazwami pól z tabeli, aby recepcjonista tworzył pasujące formuły.

## Dodawanie rekordów

### Utwórz automatyzację

W swojej bazie otwórz **Automations**, wybierz **Create automation**, a następnie wyzwalacz **When webhook received**. Skopiuj URL webhooka. Wyzwalacze webhook nie są dostępne w każdym planie Airtable.

### Utwórz narzędzie webhook

Wejdź w **Integrations**, wybierz **Add integration**, a następnie **Webhook Tool**.

| Pole                    | Wartość                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `add_airtable_record`                                                                                                       |
| **Opis**                | "Zapisz nowego potencjalnego klienta, gdy dzwoniący chce wycenę lub oddzwonienie."                                          |
| **Metoda**              | POST                                                                                                                        |
| **URL**                 | URL webhooka automatyzacji                                                                                                  |
| **Parametry treści**    | Po jednym dla każdego pola do uzupełnienia, na przykład `name`, `phone` i `request` (wszystkie jako ciągi znaków, wymagane) |
| **Przypisz do agentów** | **Receptionist**                                                                                                            |

### Wyślij przykład i przypisz pola

[Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing) w rozmowie, która uruchamia narzędzie. W automatyzacji wybierz **Test trigger**, aby wczytać żądanie, potem dodaj akcję **Create record** i przypisz każdy parametr treści do pola.

### Włącz automatyzację

Włącz automatyzację.

## Rozwiązywanie problemów

| Problem                         | Co sprawdzić                                                                                                      |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 401 lub 403 przy wyszukiwaniu   | Token potrzebuje zakresu `data.records:read` i dostępu do tej bazy.                                               |
| 422 `INVALID_FILTER_BY_FORMULA` | Nazwy pól w opisie narzędzia muszą dokładnie odpowiadać nazwom w tabeli, także pod względem wielkości liter.      |
| Wyszukiwanie nic nie zwraca     | Numery telefonów muszą być zapisane w tym samym formacie, który wysyła recepcjonista, na przykład `+14155550123`. |
| Rekordy nie są dodawane         | Automatyzacja musi być włączona, a **Create record** musi przypisywać pola z wyzwalacza webhook.                  |
| 429 z Airtable                  | Airtable pozwala na 5 żądań na sekundę na bazę. Ogranicz inny ruch API w bazie.                                   |