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

# FieldPulse

Za pomocą poniższych [narzędzi webhook](/docs/pl/reception-ai/integrations/webhooks) 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](mailto: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`.

> **Warning**
>
> 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ę](/docs/pl/reception-ai/receptionist/testing) jako nowy dzwoniący potrzebujący naprawy. Klient pojawi się w FieldPulse jako lead wraz z komentarzem recepcjonisty.

> **Tip**
>
> Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures) 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.                                                            |