Vai alla navigazione
IntegrazioniGuide alla configurazioneAssistenza sul campo

JobNimbus

Aggiungi nuovi chiamanti a JobNimbus come lead con uno strumento webhook.

Con lo strumento webhook qui sotto, la tua receptionist può aggiungere un nuovo chiamante a JobNimbus come contatto nel workflow dei lead, con il suo numero di telefono, indirizzo e ciò di cui ha bisogno, così il tuo team potrà ricontattarlo.

Prima di iniziare

  1. In JobNimbus, seleziona l’icona del tuo profilo nell’angolo in alto a destra, poi Settings → API, e crea una nuova chiave API.
  2. Scegli un Access Profile che possa creare contatti e che non abbia più autorizzazioni di quelle necessarie. La chiave mantiene le autorizzazioni che il profilo aveva al momento della creazione.
  3. Copia la chiave API completa, non il Key ID. JobNimbus la mostra una sola volta.

Lo strumento invia la chiave nell’header della richiesta Authorization come Bearer YOUR_API_KEY.

La chiave API consente di accedere ai tuoi dati JobNimbus. Conservala in modo sicuro e non condividerla. Le nuove chiavi scadono dopo un anno, quindi creane una sostitutiva prima di allora.

Ti servono anche i nomi esatti del workflow dei contatti e dello stato in cui devono finire i nuovi lead, così come appaiono nelle impostazioni di JobNimbus, ad esempio Customer e Lead.

Crea lo strumento

Vai a Integrations, seleziona Add integration, scegli Webhook Tool e compila i campi seguenti.

CampoValore
Nomecreate_jobnimbus_contact
Descrizione”Aggiungi il chiamante al nostro CRM come nuovo lead quando ha bisogno di un intervento e non ci ha mai contattato prima.”
MetodoPOST
URLhttps://app.jobnimbus.com/api1/contacts
Header della richiestaAuthorization: Bearer YOUR_API_KEY
Parametri del bodyfirst_name (stringa, obbligatorio): “Il nome del chiamante.”
last_name (stringa, obbligatorio): “Il cognome del chiamante.”
record_type_name (stringa, obbligatorio): “Sempre il valore esatto Customer.”
status_name (stringa, obbligatorio): “Sempre il valore esatto Lead.”
mobile_phone (stringa, obbligatorio): “Il numero di telefono del chiamante, solo cifre.”
email (stringa): “L’indirizzo email del chiamante, se ne ha fornito uno.”
address_line1 (stringa): “L’indirizzo dove è necessario l’intervento.”
city (stringa): “La città dell’indirizzo.”
state_text (stringa): “Lo stato, come codice di due lettere.”
zip (stringa): “Il codice postale.”
description (stringa, obbligatorio): “Di cosa ha bisogno il chiamante, quando è disponibile e qualsiasi altra informazione che ti ha comunicato.”
Assegna agli agentiReceptionist

Sostituisci Customer e Lead con i nomi del tuo workflow e del tuo stato.

Seleziona Enable, poi testa la tua receptionist come se fossi un nuovo chiamante che necessita di un’ispezione del tetto. Il contatto apparirà in JobNimbus con lo stato lead.

Aggiungi una procedura che indichi alla tua receptionist di raccogliere l’indirizzo completo prima di aggiungere il chiamante.

Limitazioni

  • La ricerca dei contatti JobNimbus richiede un filtro di ricerca JSON, quindi questo strumento non può cercare i chiamanti. Un chiamante già noto può essere aggiunto due volte.
  • Lavori, attività e note sono collegati a un contatto tramite campi annidati, che gli strumenti webhook non possono inviare. La descrizione del contatto contiene invece i dettagli della chiamata.

Per cercare i chiamanti tramite email e creare lavori collegati al loro contatto, usa le azioni Find Contact by Email, Create Contact e Create Job di JobNimbus tramite Zapier.

Risoluzione dei problemi

ProblemaCosa verificare
401 o 403 da JobNimbusIl valore dell’header deve essere Bearer seguito dalla chiave API completa, non dal Key ID. Verifica che la chiave non sia scaduta.
Errore relativo al workflow o allo statorecord_type_name e status_name devono corrispondere esattamente a un workflow dei contatti e a uno dei suoi stati.
403 con un messaggio sulle autorizzazioniL’Access Profile della chiave non può creare contatti. Crea una nuova chiave con un profilo che possa farlo.
I contatti non hanno un indirizzoAssicurati che la descrizione indichi alla receptionist di chiedere l’indirizzo completo prima di aggiungere il chiamante.