> 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 Grâce à l'[outil webhook](/docs/fr/reception-ai/integrations/webhooks) ci-dessous, votre réceptionniste peut ajouter un nouvel appelant à JobNimbus comme contact dans votre workflow de prospects, avec son numéro de téléphone, son adresse et ses besoins, afin que votre équipe puisse assurer le suivi. ## Avant de commencer 1. Dans JobNimbus, sélectionnez l'icône de votre profil en haut à droite, puis **Settings** → **API**, et créez une clé API. 2. Choisissez un **Access Profile** capable de créer des contacts, avec uniquement les autorisations dont vous avez besoin. La clé conserve les autorisations du profil au moment de sa création. 3. Copiez la clé API complète, et non le **Key ID**. JobNimbus ne l'affiche qu'une seule fois. L'outil envoie la clé dans l'en-tête de requête `Authorization` sous la forme `Bearer YOUR_API_KEY`. > **Warning** > > La clé API donne accès à vos données JobNimbus. Conservez-la en lieu sûr et ne la partagez pas. Les nouvelles clés > expirent après un an, créez donc une clé de remplacement avant cette échéance. Vous avez également besoin des noms exacts du workflow de contacts et du statut dans lesquels les nouveaux prospects doivent arriver, tels qu'ils apparaissent dans vos paramètres JobNimbus, par exemple `Customer` et `Lead`. ## Créer l'outil Accédez à **Integrations**, sélectionnez **Add integration**, choisissez **Webhook Tool**, puis renseignez les champs ci-dessous. | Champ | Valeur | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | `create_jobnimbus_contact` | | **Description** | "Ajoutez l'appelant à notre CRM comme nouveau prospect lorsqu'il a besoin de travaux et n'a jamais fait appel à nous." | | **Méthode** | POST | | **URL** | `https://app.jobnimbus.com/api1/contacts` | | **En-têtes de requête** | `Authorization`: `Bearer YOUR_API_KEY` | | **Paramètres du corps** | `first_name` (chaîne, obligatoire) : "Le prénom de l'appelant." `last_name` (chaîne, obligatoire) : "Le nom de famille de l'appelant." `record_type_name` (chaîne, obligatoire) : "Toujours la valeur exacte `Customer`." `status_name` (chaîne, obligatoire) : "Toujours la valeur exacte `Lead`." `mobile_phone` (chaîne, obligatoire) : "Le numéro de téléphone de l'appelant, chiffres uniquement." `email` (chaîne) : "L'adresse email de l'appelant, s'il en a fourni une." `address_line1` (chaîne) : "L'adresse où les travaux sont nécessaires." `city` (chaîne) : "La ville de cette adresse." `state_text` (chaîne) : "L'État, sous la forme d'un code à deux lettres." `zip` (chaîne) : "Le code postal." `description` (chaîne, obligatoire) : "Les besoins de l'appelant, ses disponibilités et toute autre information qu'il vous a communiquée." | | **Attribuer aux agents** | **Receptionist** | Remplacez `Customer` et `Lead` par les noms de votre propre workflow et de votre statut. Sélectionnez **Enable**, puis [testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en vous faisant passer pour un nouvel appelant ayant besoin d'une inspection de toiture. Le contact apparaît dans JobNimbus avec votre statut de prospect. > **Tip** > > Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) demandant à votre réceptionniste > de recueillir l'adresse complète avant d'ajouter l'appelant. ## Limites * La recherche de contacts JobNimbus nécessite un filtre de recherche JSON, cet outil ne peut donc pas rechercher des appelants. Un appelant récurrent peut être ajouté deux fois. * Les tâches, les missions et les notes sont liées à un contact par des champs imbriqués que les outils webhook ne peuvent pas envoyer. La description du contact contient les détails de l'appel à la place. Pour rechercher des appelants par email et créer des tâches liées à leur contact, utilisez les actions **Find Contact by Email**, **Create Contact** et **Create Job** de JobNimbus via [Zapier](/docs/fr/reception-ai/integrations/zapier). ## Résolution des problèmes | Problème | Vérification à effectuer | | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | | 401 ou 403 de JobNimbus | La valeur de l'en-tête doit être `Bearer` suivi de la clé API complète, et non du **Key ID**. Vérifiez que la clé n'a pas expiré. | | Erreur concernant le workflow ou le statut | `record_type_name` et `status_name` doivent correspondre exactement à un workflow de contacts et à l'un de ses statuts. | | 403 avec un message d'autorisations | L'**Access Profile** de la clé ne peut pas créer de contacts. Créez une clé avec un profil qui le peut. | | Les contacts n'ont pas d'adresse | Indiquez dans la description que la réceptionniste doit demander l'adresse complète avant d'ajouter l'appelant. |