Hoppa till navigering
IntegreringarInstallationsguiderFältservice

JobNimbus

Lägg till nya uppringare i JobNimbus som leads med ett webhookverktyg.

Med webhookverktyget nedan kan din receptionist lägga till en ny uppringare i JobNimbus som en kontakt i ditt arbetsflöde för leads, med telefonnummer, adress och vad personen behöver, så att ditt team kan följa upp.

Innan du börjar

  1. I JobNimbus väljer du din profilikon i det övre högra hörnet, sedan Settings → API, och skapar en ny API-nyckel.
  2. Välj en Access Profile som kan skapa kontakter och inte ger mer åtkomst än du behöver. Nyckeln behåller de behörigheter som profilen hade när du skapade den.
  3. Kopiera hela API-nyckeln, inte Key ID. JobNimbus visar den bara en gång.

Verktyget skickar nyckeln i förfrågningshuvudet Authorization som Bearer YOUR_API_KEY.

API-nyckeln ger åtkomst till dina JobNimbus-data. Förvara den säkert och dela den inte. Nya nycklar upphör att gälla efter ett år, så skapa en ersättningsnyckel innan dess.

Du behöver också de exakta namnen på kontaktarbetsflödet och statusen där nya leads ska hamna, så som de visas i dina JobNimbus-inställningar, till exempel Customer och Lead.

Skapa verktyget

Gå till Integrations, välj Add integration, välj Webhook Tool och fyll i fälten nedan.

FältVärde
Namncreate_jobnimbus_contact
Beskrivning”Lägg till uppringaren i vårt CRM som ett nytt lead när personen behöver få arbete utfört och inte har anlitat oss tidigare.”
MetodPOST
URLhttps://app.jobnimbus.com/api1/contacts
FörfrågningshuvudenAuthorization: Bearer YOUR_API_KEY
Brödtextparametrarfirst_name (sträng, krävs): “Uppringarens förnamn.”
last_name (sträng, krävs): “Uppringarens efternamn.”
record_type_name (sträng, krävs): “Alltid det exakta värdet Customer.”
status_name (sträng, krävs): “Alltid det exakta värdet Lead.”
mobile_phone (sträng, krävs): “Uppringarens telefonnummer, endast siffror.”
email (sträng): “Uppringarens e-postadress, om personen uppgav en.”
address_line1 (sträng): “Gatuadressen där arbetet behövs.”
city (sträng): “Staden för den adressen.”
state_text (sträng): “Delstaten, som en kod med två bokstäver.”
zip (sträng): “Postnumret.”
description (sträng, krävs): “Vad uppringaren behöver, när personen är tillgänglig och allt annat personen berättade.”
Tilldela till agenterReceptionist

Ersätt Customer och Lead med dina egna namn på arbetsflöde och status.

Välj Enable och testa sedan din receptionist som en ny uppringare som behöver en takinspektion. Kontakten visas i JobNimbus med din lead-status.

Lägg till en procedur som säger åt din receptionist att samla in hela adressen innan den lägger till uppringaren.

Begränsningar

  • Att söka efter JobNimbus-kontakter kräver ett JSON-sökfilter, så verktyget kan inte slå upp uppringare. En återkommande uppringare kan läggas till två gånger.
  • Jobb, uppgifter och anteckningar länkas till en kontakt via kapslade fält, som webhookverktyg inte kan skicka. Kontaktens beskrivning innehåller i stället samtalsinformationen.

Om du vill slå upp uppringare via e-post och skapa jobb som är länkade till deras kontakt använder du JobNimbus-åtgärderna Find Contact by Email, Create Contact och Create Job via Zapier.

Felsökning

ProblemKontrollera
401 eller 403 från JobNimbusRubrikvärdet måste vara Bearer följt av hela API-nyckeln, inte Key ID. Kontrollera att nyckeln inte har upphört att gälla.
Fel om arbetsflödet eller statusenrecord_type_name och status_name måste exakt matcha ett kontaktarbetsflöde och en av dess statusar.
403 med ett behörighetsmeddelandeNyckelns Access Profile kan inte skapa kontakter. Skapa en ny nyckel med en profil som kan det.
Kontakter saknar adressSe till att beskrivningen säger åt receptionisten att fråga efter hela adressen innan uppringaren läggs till.