Naar navigatie springen

JobNimbus

Voeg nieuwe bellers toe aan JobNimbus als leads, met notities en taken, via webhook tools.

Met de onderstaande webhooktools kan je receptioniste een nieuwe beller als contact toevoegen aan JobNimbus in je leadworkflow, met het telefoonnummer, adres en wat de beller nodig heeft. De receptionist kan ook een notitie aan het contact toevoegen en een gekoppelde opdracht maken, zodat je team opvolging kan geven.

Voordat je begint

  1. Selecteer in JobNimbus je profielpictogram rechtsboven, vervolgens Settings → API, en maak een nieuwe API-sleutel.
  2. Kies een Access Profile waarmee je contacten kunt maken, plus notities en opdrachten als je die tools toevoegt, en niet meer rechten dan nodig. De sleutel behoudt de rechten die het profiel had toen je deze maakte.
  3. Kopieer de volledige API-sleutel, niet de Key ID. JobNimbus toont deze maar één keer.

Elke tool verstuurt de sleutel in de requestheader Authorization als Bearer YOUR_API_KEY. Stel het Type in op Secret.

De API-sleutel geeft toegang tot je JobNimbus-gegevens. Bewaar deze veilig en deel hem niet. Nieuwe sleutels verlopen na één jaar, dus maak daarvoor een vervangende sleutel.

Je hebt ook de exacte namen nodig van de contactworkflow en status waarin nieuwe leads moeten terechtkomen, zoals deze in je JobNimbus-instellingen staan, bijvoorbeeld Customer en Lead. Voor opdrachten heb je ook de namen van de opdrachtworkflow en -status nodig.

De tools maken

Ga voor elke tool naar Integrations, selecteer Add integration, kies Webhook Tool en vul de onderstaande velden in. Voor velden met “vaste waarde” is Value ingesteld op Fixed value.

De beller toevoegen

VeldWaarde
Naamcreate_jobnimbus_contact
Beschrijving”Voeg de beller als nieuwe lead toe aan onze CRM wanneer die werk nodig heeft en nog niet eerder klant bij ons was.”
MethodePOST
URLhttps://app.jobnimbus.com/api1/contacts
RequestheadersAuthorization (Secret): Bearer YOUR_API_KEY
Bodyparametersfirst_name (string, verplicht): “De voornaam van de beller.”
last_name (string, verplicht): “De achternaam van de beller.”
record_type_name (string): vaste waarde Customer
status_name (string): vaste waarde Lead
mobile_phone (string, verplicht): “Het telefoonnummer van de beller, alleen cijfers.”
email (string): “Het e-mailadres van de beller, als die er een heeft opgegeven.”
address_line1 (string): “Het straatadres waar het werk nodig is.”
city (string): “De plaats van dat adres.”
state_text (string): “De staat, als code van twee letters.”
zip (string): “De postcode.”
description (string, verplicht): “Wat de beller nodig heeft, wanneer die beschikbaar is en al het andere dat die je heeft verteld.”
Toewijzen aan agentsReceptionist

Vervang Customer en Lead door je eigen workflow- en statusnamen.

Een notitie toevoegen

VeldWaarde
Naamadd_jobnimbus_note
Beschrijving”Voeg een notitie toe aan het contact van de beller met wat die nodig heeft en wanneer die beschikbaar is. Gebruik deze na create_jobnimbus_contact, met de jnid die deze heeft teruggegeven.”
MethodePOST
URLhttps://app.jobnimbus.com/api1/activities
RequestheadersAuthorization (Secret): Bearer YOUR_API_KEY
Bodyparametersnote (string, verplicht): “Wat de beller nodig heeft, wanneer die beschikbaar is en al het andere dat die je heeft verteld.”
record_type_name (string): vaste waarde Note
primary (object, verplicht): zie hieronder.
Toewijzen aan agentsReceptionist

primary is een object met één veld:

  • id (string, verplicht): “De jnid van het contact, van create_jobnimbus_contact.”

record_type_name moet exact overeenkomen met een van de activiteitstypen in je JobNimbus-instellingen.

Een opdracht maken

Voeg deze tool toe als je team met opdrachten werkt.

VeldWaarde
Naamcreate_jobnimbus_job
Beschrijving”Maak een opdracht voor het werk dat de beller nodig heeft, gekoppeld aan het contact. Gebruik deze na create_jobnimbus_contact, met de jnid die deze heeft teruggegeven.”
MethodePOST
URLhttps://app.jobnimbus.com/api1/jobs
RequestheadersAuthorization (Secret): Bearer YOUR_API_KEY
Bodyparametersname (string, verplicht): “Een korte titel met het werk en de naam van de beller, bijvoorbeeld: Dakinspectie - Jane Doe.”
record_type_name (string): vaste waarde, de naam van je opdrachtworkflow
status_name (string): vaste waarde, de opdrachtstatus waarin nieuw werk terechtkomt
description (string, verplicht): “Wat de beller nodig heeft en wanneer die beschikbaar is.”
address_line1 (string): “Het straatadres waar het werk nodig is.”
city (string): “De plaats van dat adres.”
state_text (string): “De staat, als code van twee letters.”
zip (string): “De postcode.”
primary (object, verplicht): zie hieronder.
Toewijzen aan agentsReceptionist

primary is een object met één veld:

  • id (string, verplicht): “De jnid van het contact, van create_jobnimbus_contact.”

Selecteer Enable bij elke tool en test je receptionist als een nieuwe beller die een dakinspectie nodig heeft. Het contact verschijnt in JobNimbus met je leadstatus, samen met de notitie en de opdracht.

Voeg een procedure toe die je receptionist vertelt om het volledige adres te verzamelen voordat de beller wordt toegevoegd, en daarna de notitie en de opdracht toe te voegen.

Beperkingen

  • Voor het zoeken naar JobNimbus-contacten is een JSON-zoekfilter nodig, dus deze tools zoeken bellers niet op. Een terugkerende beller kan twee keer worden toegevoegd.
  • De tools maken geen taken. JobNimbus gebruikt voor de starttijd van een taak een Unix-timestamp, die je receptionist tijdens een gesprek niet betrouwbaar kan bepalen.

Gebruik de actie Find Contact by Email van JobNimbus via Zapier om bellers op e-mailadres op te zoeken.

Problemen oplossen

ProbleemWat je moet controleren
401 of 403 van JobNimbusDe headerwaarde moet bestaan uit Bearer gevolgd door de volledige API-sleutel, niet de Key ID. Controleer of de sleutel niet is verlopen.
Fout over de workflow of statusrecord_type_name en status_name moeten exact overeenkomen met een workflow en een van de bijbehorende statussen: een contactworkflow voor contacten, een opdrachtworkflow voor opdrachten.
403 met een rechtenmeldingMet het Access Profile van de sleutel kunnen geen contacten worden gemaakt. Maak een nieuwe sleutel met een profiel waarmee dat wel kan.
De notitie of opdracht is niet gekoppeldprimary moet een object zijn met de jnid van het contact als id. Controleer of create_jobnimbus_contact eerst is uitgevoerd.
Contacten hebben geen adresZorg dat de beschrijving de receptionist vertelt om naar het volledige adres te vragen voordat de beller wordt toegevoegd.