> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # JobNimbus Con lo [strumento webhook](/docs/it/reception-ai/integrations/webhooks) 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`. > **Warning** > > 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. | Campo | Valore | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_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." | | **Metodo** | POST | | **URL** | `https://app.jobnimbus.com/api1/contacts` | | **Header della richiesta** | `Authorization`: `Bearer YOUR_API_KEY` | | **Parametri del body** | `first_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 agenti** | **Receptionist** | Sostituisci `Customer` e `Lead` con i nomi del tuo workflow e del tuo stato. Seleziona **Enable**, poi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) come se fossi un nuovo chiamante che necessita di un'ispezione del tetto. Il contatto apparirà in JobNimbus con lo stato lead. > **Tip** > > Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) 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](/docs/it/reception-ai/integrations/zapier). ## Risoluzione dei problemi | Problema | Cosa verificare | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | 401 o 403 da JobNimbus | Il 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 stato | `record_type_name` e `status_name` devono corrispondere esattamente a un workflow dei contatti e a uno dei suoi stati. | | 403 con un messaggio sulle autorizzazioni | L'**Access Profile** della chiave non può creare contatti. Crea una nuova chiave con un profilo che possa farlo. | | I contatti non hanno un indirizzo | Assicurati che la descrizione indichi alla receptionist di chiedere l'indirizzo completo prima di aggiungere il chiamante. |