> 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 Met de onderstaande [webhooktool](/docs/nl/reception-ai/integrations/webhooks) 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`. > **Warning** > > 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. | Veld | Waarde | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Naam** | `create_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." | | **Methode** | POST | | **URL** | `https://app.jobnimbus.com/api1/contacts` | | **Requestheaders** | `Authorization`: `Bearer YOUR_API_KEY` | | **Bodyparameters** | `first_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 agents** | **Receptionist** | Vervang `Customer` en `Lead` door je eigen namen voor de workflow en status. Selecteer **Enable** en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) vervolgens als een nieuwe beller die een dakinspectie nodig heeft. Het contact verschijnt in JobNimbus met je leadstatus. > **Tip** > > Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) 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](/docs/nl/reception-ai/integrations/zapier) om bellers op e-mailadres op te zoeken en taken te maken die aan hun contact zijn gekoppeld. ## Problemen oplossen | Probleem | Wat je moet controleren | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | 401 of 403 van JobNimbus | De 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 status | `record_type_name` en `status_name` moeten exact overeenkomen met een contactworkflow en een van de bijbehorende statussen. | | 403 met een bericht over rechten | Het **Access Profile** van de sleutel mag geen contacten maken. Maak een nieuwe sleutel met een profiel dat dit wel mag. | | Contacten hebben geen adres | Laat de beschrijving de receptionist vertellen om het volledige adres te vragen voordat de beller wordt toegevoegd. |