Passer à la navigation
IntégrationsGuides de configurationService sur le terrain

JobNimbus

Ajoutez de nouveaux appelants à JobNimbus en tant que prospects avec un outil de webhook.

Grâce à l’outil webhook 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.

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.

ChampValeur
Nomcreate_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éthodePOST
URLhttps://app.jobnimbus.com/api1/contacts
En-têtes de requêteAuthorization: Bearer YOUR_API_KEY
Paramètres du corpsfirst_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 agentsReceptionist

Remplacez Customer et Lead par les noms de votre propre workflow et de votre statut.

Sélectionnez Enable, puis testez votre réceptionniste 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.

Ajoutez une procédure 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.

Résolution des problèmes

ProblèmeVérification à effectuer
401 ou 403 de JobNimbusLa 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 statutrecord_type_name et status_name doivent correspondre exactement à un workflow de contacts et à l’un de ses statuts.
403 avec un message d’autorisationsL’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’adresseIndiquez dans la description que la réceptionniste doit demander l’adresse complète avant d’ajouter l’appelant.