FieldPulse | ElevenLabs Documentation

Za pomocą poniższych narzędzi webhook recepcjonista rozpozna dzwoniących, którzy są już w FieldPulse, doda nowych dzwoniących jako leady i zostawi komentarz przy kliencie z informacją, czego potrzebują, aby twój zespół mógł się z nimi skontaktować.

Zanim zaczniesz

FieldPulse wydaje klucze API na prośbę. Skontaktuj się z pomocą FieldPulse pod adresem support@fieldpulse.com lub przez czat w aplikacji i poproś o klucz API. Każde z poniższych narzędzi wysyła go w nagłówku żądania x-api-key.

Klucz API może odczytywać i zmieniać dane FieldPulse. Przechowuj go bezpiecznie i nikomu nie udostępniaj.

Utwórz narzędzia

Dla każdego narzędzia przejdź do Integrations, wybierz Add integration, następnie Webhook Tool, a w Assign to agents ustaw Receptionist.

Znajdź dzwoniącego

Pole	Wartość
Nazwa	`find_fieldpulse_customer`
Opis	”Znajdź dzwoniącego na naszej liście klientów po imieniu i nazwisku lub numerze telefonu. Użyj na początku rozmowy dotyczącej zlecenia.”
Metoda	GET
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Nagłówki żądania	`x-api-key`: twój klucz API
Parametry zapytania	`search` (string, wymagany): “Imię i nazwisko dzwoniącego lub jego numer telefonu.”

Dodaj nowego klienta

Pole	Wartość
Nazwa	`create_fieldpulse_customer`
Opis	”Dodaj dzwoniącego jako nowego klienta, gdy `find_fieldpulse_customer` go nie znajdzie.”
Metoda	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Nagłówki żądania	`x-api-key`: twój klucz API
Parametry body	`first_name` (string, wymagany): “Imię dzwoniącego.” `last_name` (string, wymagany): “Nazwisko dzwoniącego.” `phone` (string, wymagany): “Numer telefonu dzwoniącego wraz z numerem kierunkowym.” `email` (string): “Adres e-mail dzwoniącego, jeśli go podał.” `status` (string, wymagany): “Zawsze dokładna wartość `lead`.” `service_address_1` (string): “Adres ulicy, pod którym potrzebne jest zlecenie.” `service_address_city` (string): “Miasto tego adresu.” `service_address_state` (string): “Stan.” `service_address_zip_code` (string): “Kod pocztowy.”

Zapisz szczegóły rozmowy

Pole	Wartość
Nazwa	`add_fieldpulse_comment`
Opis	”Dodaj komentarz do rekordu klienta dzwoniącego z informacją, czego potrzebuje. Użyj, gdy masz jego id klienta.”
Metoda	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`
Nagłówki żądania	`x-api-key`: twój klucz API
Parametry body	`commentable_type` (string, wymagany): “Zawsze dokładna wartość `customer`.” `commentable_id` (number, wymagany): “Id klienta z `find_fieldpulse_customer` lub `create_fieldpulse_customer`.” `text` (string, wymagany): “Czego potrzebuje dzwoniący, kiedy jest dostępny i jak się z nim skontaktować.”

Wybierz Enable dla każdego narzędzia, a następnie przetestuj recepcjonistę jako nowy dzwoniący potrzebujący naprawy. Klient pojawi się w FieldPulse jako lead wraz z komentarzem recepcjonisty.

Dodaj procedurę dla nowych zleceń: znajdź dzwoniącego, dodaj go, jeśli nie zostanie znaleziony, a potem zapisz szczegóły rozmowy.

Ograniczenia

Zlecenia wymagają typu zlecenia, statusu i danych rozliczeniowych z konta FieldPulse, więc recepcjonista ich nie tworzy. Twój zespół zmienia lead w zlecenie.
Recepcjonista nie może sprawdzać dostępności techników ani rezerwować terminu.
Narzędzia webhook nie mogą wysyłać list, więc nie mogą dodawać klientowi tagów ani pól niestandardowych.

Rozwiązywanie problemów

Problem	Co sprawdzić
401 z FieldPulse	Nagłówek musi nazywać się `x-api-key` i zawierać aktualny klucz.
400 z FieldPulse	Sprawdź listę błędów w odpowiedzi. `status` musi mieć dokładnie wartość `lead`, a numery telefonów muszą być poprawne.
Znani dzwoniący nie są znajdowani	FieldPulse dopasowuje zapisane dane. Spróbuj użyć imienia i nazwiska dzwoniącego oraz jego numeru telefonu.
Komentarz nie został dodany	`commentable_id` musi być id istniejącego klienta. Sprawdź, czy najpierw uruchomiono narzędzie wyszukiwania lub tworzenia.
429 z FieldPulse	Osiągnięto limit żądań FieldPulse. Poczekaj i spróbuj ponownie.