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

# JobNimbus

Za pomocą poniższego [narzędzia webhook](/docs/pl/reception-ai/integrations/webhooks) twoja recepcjonistka może dodać nowego rozmówcę do JobNimbus jako kontakt w procesie obsługi leadów — wraz z numerem telefonu, adresem i opisem potrzeb — aby twój zespół mógł się z nim skontaktować.

## Zanim zaczniesz

1. W JobNimbus wybierz ikonę profilu w prawym górnym rogu, potem **Settings** → **API** i utwórz nowy klucz API.
2. Wybierz **Access Profile**, który może tworzyć kontakty i ma tylko potrzebne uprawnienia. Klucz zachowuje uprawnienia profilu z chwili utworzenia.
3. Skopiuj cały klucz API, a nie **Key ID**. JobNimbus wyświetla go tylko raz.

Narzędzie wysyła klucz w nagłówku żądania `Authorization` jako `Bearer YOUR_API_KEY`.

> **Warning**
>
> Klucz API daje dostęp do danych JobNimbus. Przechowuj go bezpiecznie i nikomu nie udostępniaj. Nowe klucze
> wygasają po roku, więc wcześniej utwórz nowy.

Potrzebujesz też dokładnych nazw procesu kontaktu i statusu, do których mają trafiać nowe leady, takich jak w ustawieniach JobNimbus, na przykład `Customer` i `Lead`.

## Utwórz narzędzie

Przejdź do **Integrations**, wybierz **Add integration**, potem **Webhook Tool** i uzupełnij pola poniżej.

| Pole                    | Wartość                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `create_jobnimbus_contact`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Opis**                | "Dodaj rozmówcę do naszego CRM jako nowy lead, gdy potrzebuje usługi i wcześniej z nas nie korzystał."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Metoda**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **URL**                 | `https://app.jobnimbus.com/api1/contacts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Nagłówki żądania**    | `Authorization`: `Bearer YOUR_API_KEY`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Parametry body**      | `first_name` (ciąg znaków, wymagane): "Imię rozmówcy."  `last_name` (ciąg znaków, wymagane): "Nazwisko rozmówcy."  `record_type_name` (ciąg znaków, wymagane): "Zawsze dokładna wartość `Customer`."  `status_name` (ciąg znaków, wymagane): "Zawsze dokładna wartość `Lead`."  `mobile_phone` (ciąg znaków, wymagane): "Numer telefonu rozmówcy, tylko cyfry."  `email` (ciąg znaków): "Adres e-mail rozmówcy, jeśli go podał."  `address_line1` (ciąg znaków): "Adres ulicy, pod którym potrzebna jest usługa."  `city` (ciąg znaków): "Miasto tego adresu."  `state_text` (ciąg znaków): "Stan, jako dwuliterowy kod."  `zip` (ciąg znaków): "Kod pocztowy."  `description` (ciąg znaków, wymagane): "Czego potrzebuje rozmówca, kiedy jest dostępny i wszystko, co jeszcze powiedział." |
| **Przypisz do agentów** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

Zastąp `Customer` i `Lead` własnymi nazwami procesu i statusu.

Wybierz **Enable**, a następnie [przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) jako nowy rozmówca potrzebujący inspekcji dachu. Kontakt pojawi się w JobNimbus ze statusem leada.

> **Tip**
>
> Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która każe recepcjonistce
> zebrać pełny adres, zanim doda rozmówcę.

## Ograniczenia

* Wyszukiwanie kontaktów JobNimbus wymaga filtra wyszukiwania JSON, więc to narzędzie nie może ich wyszukiwać. Powracający rozmówca może zostać dodany dwa razy.
* Zlecenia, zadania i notatki są połączone z kontaktem przez zagnieżdżone pola, których narzędzia webhook nie mogą wysyłać. Szczegóły rozmowy trafiają więc do opisu kontaktu.

Aby wyszukiwać rozmówców po e-mailu i tworzyć zlecenia połączone z ich kontaktem, użyj działań JobNimbus **Find Contact by Email**, **Create Contact** i **Create Job** przez [Zapier](/docs/pl/reception-ai/integrations/zapier).

## Rozwiązywanie problemów

| Problem                           | Co sprawdzić                                                                                                      |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 401 lub 403 z JobNimbus           | Wartość nagłówka musi zawierać `Bearer`, a po nim pełny klucz API, nie **Key ID**. Sprawdź, czy klucz nie wygasł. |
| Błąd procesu lub statusu          | `record_type_name` i `status_name` muszą dokładnie odpowiadać procesowi kontaktu i jednemu z jego statusów.       |
| 403 z komunikatem o uprawnieniach | **Access Profile** klucza nie może tworzyć kontaktów. Utwórz nowy klucz z profilem, który może.                   |
| Kontakty nie mają adresu          | W opisie poleć recepcjonistce poprosić o pełny adres przed dodaniem rozmówcy.                                     |