Przejdź do nawigacji

JobNimbus

Dodawaj nowych dzwoniących do JobNimbus jako leady, wraz z notatkami i zleceniami, za pomocą narzędzi webhook.

Dzięki poniższym narzędziom webhook twoja recepcjonistka może dodać nową osobę dzwoniącą do JobNimbus jako kontakt w workflow leadów — wraz z numerem telefonu, adresem i informacją, czego potrzebuje. Może też dodać notatkę do kontaktu i utworzyć powiązane z nim zlecenie, aby twój zespół mógł się z nią 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 oraz — jeśli dodasz te narzędzia — notatki i zlecenia, ale nie ma więcej uprawnień, niż potrzebujesz. Klucz zachowuje uprawnienia profilu z chwili jego utworzenia.
  3. Skopiuj cały klucz API, a nie Key ID. JobNimbus wyświetla go tylko raz.

Każde narzędzie wysyła klucz w nagłówku żądania Authorization jako Bearer YOUR_API_KEY. Ustaw jego Type na Secret.

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

Potrzebujesz też dokładnych nazw workflow kontaktów i statusu, do którego mają trafiać nowe leady, widocznych w ustawieniach JobNimbus, na przykład Customer i Lead. W przypadku zleceń potrzebujesz również nazw workflow i statusu zleceń.

Utwórz narzędzia

Dla każdego narzędzia przejdź do Integrations, wybierz Add integration, następnie Webhook Tool i uzupełnij poniższe pola. W polach oznaczonych jako „stała wartość” opcja Value powinna być ustawiona na Fixed value.

Dodaj osobę dzwoniącą

PoleWartość
Nazwacreate_jobnimbus_contact
Opis”Dodaj osobę dzwoniącą do naszego CRM jako nowego leada, gdy potrzebuje wykonania pracy i nie korzystała wcześniej z naszych usług.”
MetodaPOST
URLhttps://app.jobnimbus.com/api1/contacts
Nagłówki żądaniaAuthorization (Secret): Bearer YOUR_API_KEY
Parametry treścifirst_name (string, wymagane): “Imię osoby dzwoniącej.”
last_name (string, wymagane): “Nazwisko osoby dzwoniącej.”
record_type_name (string): stała wartość Customer
status_name (string): stała wartość Lead
mobile_phone (string, wymagane): “Numer telefonu osoby dzwoniącej — tylko cyfry.”
email (string): “Adres e-mail osoby dzwoniącej, jeśli go podała.”
address_line1 (string): “Adres ulicy, pod którym trzeba wykonać pracę.”
city (string): “Miasto tego adresu.”
state_text (string): “Stan w formie dwuliterowego kodu.”
zip (string): “Kod pocztowy ZIP.”
description (string, wymagane): “Czego potrzebuje osoba dzwoniąca, kiedy jest dostępna i wszystko inne, co przekazała.”
Przypisz do agentówReceptionist

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

Dodaj notatkę

PoleWartość
Nazwaadd_jobnimbus_note
Opis”Dodaj notatkę do kontaktu osoby dzwoniącej, zawierającą informację, czego potrzebuje i kiedy jest dostępna. Użyj po create_jobnimbus_contact, podając zwrócone przez nie jnid.”
MetodaPOST
URLhttps://app.jobnimbus.com/api1/activities
Nagłówki żądaniaAuthorization (Secret): Bearer YOUR_API_KEY
Parametry treścinote (string, wymagane): “Czego potrzebuje osoba dzwoniąca, kiedy jest dostępna i wszystko inne, co przekazała.”
record_type_name (string): stała wartość Note
primary (object, wymagane): patrz poniżej.
Przypisz do agentówReceptionist

primary to obiekt z jednym polem:

  • id (string, wymagane): “jnid kontaktu z create_jobnimbus_contact.”

record_type_name musi pasować do jednego z typów aktywności w ustawieniach JobNimbus.

Utwórz zlecenie

Dodaj to narzędzie, jeśli twój zespół pracuje na zleceniach.

PoleWartość
Nazwacreate_jobnimbus_job
Opis”Utwórz zlecenie na pracę, której potrzebuje osoba dzwoniąca, powiązane z jej kontaktem. Użyj po create_jobnimbus_contact, podając zwrócone przez nie jnid.”
MetodaPOST
URLhttps://app.jobnimbus.com/api1/jobs
Nagłówki żądaniaAuthorization (Secret): Bearer YOUR_API_KEY
Parametry treściname (string, wymagane): “Krótki tytuł z opisem pracy i nazwiskiem osoby dzwoniącej, na przykład: Roof inspection - Jane Doe.”
record_type_name (string): stała wartość, nazwa workflow zleceń
status_name (string): stała wartość, status, do którego trafiają nowe zlecenia
description (string, wymagane): “Czego potrzebuje osoba dzwoniąca i kiedy jest dostępna.”
address_line1 (string): “Adres ulicy, pod którym trzeba wykonać pracę.”
city (string): “Miasto tego adresu.”
state_text (string): “Stan w formie dwuliterowego kodu.”
zip (string): “Kod pocztowy ZIP.”
primary (object, wymagane): patrz poniżej.
Przypisz do agentówReceptionist

primary to obiekt z jednym polem:

  • id (string, wymagane): “jnid kontaktu z create_jobnimbus_contact.”

Wybierz Enable dla każdego narzędzia, a następnie przetestuj recepcjonistkę jako nowa osoba dzwoniąca, która potrzebuje przeglądu dachu. Kontakt pojawi się w JobNimbus ze statusem leada, wraz z notatką i zleceniem.

Dodaj procedurę, która mówi recepcjonistce, by zebrała pełny adres przed dodaniem osoby dzwoniącej, a następnie dodała notatkę i zlecenie.

Ograniczenia

  • Wyszukiwanie kontaktów JobNimbus wymaga filtra wyszukiwania JSON, dlatego te narzędzia nie wyszukują osób dzwoniących. Osoba, która dzwoni ponownie, może zostać dodana dwa razy.
  • Narzędzia nie tworzą zadań. JobNimbus przyjmuje czas rozpoczęcia zadania jako znacznik czasu Unix, którego recepcjonistka nie może wiarygodnie ustalić podczas rozmowy.

Aby wyszukiwać osoby dzwoniące po adresie e-mail, użyj akcji Find Contact by Email JobNimbus 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 dotyczący workflow lub statusurecord_type_name i status_name muszą dokładnie odpowiadać workflow i jednemu z jego statusów: workflow kontaktów dla kontaktów, workflow zleceń dla zleceń.
403 z komunikatem o uprawnieniachAccess Profile klucza nie może tworzyć kontaktów. Utwórz nowy klucz z profilem, który może to robić.
Notatka lub zlecenie nie są powiązaneprimary musi być obiektem z jnid kontaktu jako id. Sprawdź, czy najpierw uruchomiono create_jobnimbus_contact.
Kontakty nie mają adresuW opisie poinstruuj recepcjonistkę, by poprosiła o pełny adres przed dodaniem osoby dzwoniącej.