Airtable | ElevenLabs Documentation

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