Skip to navigation
IntegratiesInstallatiehandleidingenService op locatie

JobNimbus

Voeg nieuwe bellers als leads toe aan JobNimbus met een webhooktool.

Met de onderstaande webhooktool kan je receptionist een nieuwe beller als contact toevoegen aan JobNimbus in je workflow voor leads, met het telefoonnummer, adres en wat diegene nodig heeft, zodat je team kan opvolgen.

Voordat je begint

  1. Selecteer in JobNimbus je profielpictogram in de rechterbovenhoek, vervolgens Settings → API, en maak een nieuwe API-sleutel.
  2. Kies een Access Profile waarmee je contacten kunt maken, en niet meer rechten dan je nodig hebt. 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.

De tool verstuurt de sleutel in de requestheader Authorization als Bearer YOUR_API_KEY.

Met de API-sleutel krijg je 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 de status waarin nieuwe leads moeten terechtkomen, zoals ze in je JobNimbus-instellingen staan, bijvoorbeeld Customer en Lead.

De tool maken

Ga naar Integrations, selecteer Add integration, kies Webhook Tool en vul de onderstaande velden in.

VeldWaarde
Naamcreate_jobnimbus_contact
Beschrijving”Voeg de beller als nieuwe lead toe aan onze CRM wanneer die werk moet laten uitvoeren en nog niet eerder klant bij ons is geweest.”
MethodePOST
URLhttps://app.jobnimbus.com/api1/contacts
RequestheadersAuthorization: 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, verplicht): “Altijd de exacte waarde Customer.”
status_name (string, verplicht): “Altijd de exacte waarde Lead.”
mobile_phone (string, verplicht): “Het telefoonnummer van de beller, alleen cijfers.”
email (string): “Het e-mailadres van de beller, als diegene 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 diegene beschikbaar is en alles wat diegene je verder heeft verteld.”
Toewijzen aan agentsReceptionist

Vervang Customer en Lead door je eigen namen voor de workflow en status.

Selecteer Enable en test je receptionist vervolgens als een nieuwe beller die een dakinspectie nodig heeft. Het contact verschijnt in JobNimbus met je leadstatus.

Voeg een procedure toe waarin je receptionist wordt verteld het volledige adres te verzamelen voordat deze de beller toevoegt.

Beperkingen

  • Voor het zoeken naar JobNimbus-contacten is een JSON-zoekfilter nodig, dus deze tool kan bellers niet opzoeken. Een terugkerende beller kan twee keer worden toegevoegd.
  • Taken, opdrachten en notities worden via geneste velden aan een contact gekoppeld, die webhooktools niet kunnen versturen. De beschrijving van het contact bevat in plaats daarvan de gespreksgegevens.

Gebruik de acties Find Contact by Email, Create Contact en Create Job van JobNimbus via Zapier om bellers op e-mailadres op te zoeken en taken te maken die aan hun contact zijn gekoppeld.

Problemen oplossen

ProbleemWat je moet controleren
401 of 403 van JobNimbusDe headerwaarde moet Bearer gevolgd door de volledige API-sleutel zijn, 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 contactworkflow en een van de bijbehorende statussen.
403 met een bericht over rechtenHet Access Profile van de sleutel mag geen contacten maken. Maak een nieuwe sleutel met een profiel dat dit wel mag.
Contacten hebben geen adresLaat de beschrijving de receptionist vertellen om het volledige adres te vragen voordat de beller wordt toegevoegd.