Przejdź do nawigacji
IntegracjePrzewodniki konfiguracjiUsługi terenowe

JobNimbus

Dodawaj nowych dzwoniących do JobNimbus jako leady za pomocą narzędzia webhook.

Za pomocą poniższego narzędzia webhook 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.

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.

PoleWartość
Nazwacreate_jobnimbus_contact
Opis”Dodaj rozmówcę do naszego CRM jako nowy lead, gdy potrzebuje usługi i wcześniej z nas nie korzystał.”
MetodaPOST
URLhttps://app.jobnimbus.com/api1/contacts
Nagłówki żądaniaAuthorization: Bearer YOUR_API_KEY
Parametry bodyfirst_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ówReceptionist

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

Wybierz Enable, a następnie przetestuj recepcjonistkę jako nowy rozmówca potrzebujący inspekcji dachu. Kontakt pojawi się w JobNimbus ze statusem leada.

Dodaj procedurę, 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.

Rozwiązywanie problemów

ProblemCo sprawdzić
401 lub 403 z JobNimbusWartość nagłówka musi zawierać Bearer, a po nim pełny klucz API, nie Key ID. Sprawdź, czy klucz nie wygasł.
Błąd procesu lub statusurecord_type_name i status_name muszą dokładnie odpowiadać procesowi kontaktu i jednemu z jego statusów.
403 z komunikatem o uprawnieniachAccess Profile klucza nie może tworzyć kontaktów. Utwórz nowy klucz z profilem, który może.
Kontakty nie mają adresuW opisie poleć recepcjonistce poprosić o pełny adres przed dodaniem rozmówcy.