> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# JobNimbus

> Synchronisez automatiquement les enregistrements et résumés d'appels avec vos contacts JobNimbus

## Comment connecter

### Obtenir votre clé API JobNimbus

<Steps>
  <Step title="Se connecter à JobNimbus">
    Connectez-vous à votre compte JobNimbus. Vous devez être administrateur pour créer une clé API.
  </Step>

  <Step title="Accéder aux paramètres API">
    Allez dans **Settings** > **API** et cliquez sur **New API Key**.
  </Step>

  <Step title="Créer la clé">
    Nommez la clé (par exemple **Allo**) et attribuez-lui un profil d'accès capable de lire et modifier les contacts et de lire les paramètres du compte, comme **Admin**. Copiez la clé.
  </Step>
</Steps>

### Connecter dans Allo

<Steps>
  <Step title="Ouvrir les intégrations">
    Rendez-vous sur [**web.withallo.com**](https://web.withallo.com) et naviguez vers **Settings** > **Integrations**.
  </Step>

  <Step title="Trouver JobNimbus">
    Trouvez **JobNimbus** dans la liste des intégrations et cliquez sur **Connect**.
  </Step>

  <Step title="Coller votre clé API">
    Saisissez la clé API copiée depuis JobNimbus.
  </Step>

  <Step title="Enregistrer et connecter">
    Cliquez sur **Save & Connect** et attendez la confirmation.
  </Step>
</Steps>

## Ce qui est synchronisé

**De JobNimbus vers Allo :**

* Contacts

**D'Allo vers JobNimbus :**

* Appels et SMS, enregistrés sur le contact correspondant
* Nouveaux contacts, uniquement lorsque **Create lead for unknown calls** est activé

Lorsqu'Allo crée un contact, il est placé dans votre premier workflow de contact actif, à son premier statut (par exemple **Customer** > **Lead**). Allo ne remplit que les champs vides des contacts existants et n'écrase jamais un nom, un email ou un numéro de téléphone déjà renseigné dans JobNimbus.

Les jobs ne sont pas synchronisés.

## Comment les appels sont synchronisés

Après chaque appel, Allo l'enregistre sur le contact correspondant dans JobNimbus en tant qu'activité **Phone Call**, avec le résumé de l'appel, les tags et un lien vers l'enregistrement. L'activité est datée au moment de l'appel et attribuée à l'utilisateur JobNimbus dont l'email correspond à celui de l'utilisateur Allo.

## Comment les SMS sont synchronisés

Chaque SMS est enregistré sur le contact correspondant dans JobNimbus en tant qu'activité **Text Message**, avec le contenu du message.

<Note>
  Si un administrateur a désactivé le type d'activité **Phone Call** ou **Text Message** dans JobNimbus, Allo enregistre l'activité en tant que **Note**.
</Note>

## Troubleshooting

Vérifiez le statut de synchronisation de n'importe quel appel depuis la **liste des appels sur [web.withallo.com](https://web.withallo.com)** — chaque appel dispose d'un indicateur d'intégration affichant son état de synchronisation.

<AccordionGroup>
  <Accordion title="Je ne peux pas connecter mon intégration">
    Seuls les **admins** et **managers** d'un espace de travail Allo peuvent connecter des intégrations. Si vous ne voyez pas l'option, demandez à l'admin ou au manager de votre espace de travail de la configurer.

    Côté JobNimbus, la clé API doit être créée par un administrateur JobNimbus. Si la connexion échoue, vérifiez que la clé n'a pas été supprimée et que son profil d'accès peut lire les contacts.
  </Accordion>

  <Accordion title="Appel non synchronisé avec mon intégration">
    Vérifiez l'indicateur d'intégration sur l'appel dans l'application web. L'erreur sera l'une des suivantes :

    * **Contact introuvable** — Le contact n'existe pas dans votre CRM. Par défaut, Allo ne synchronise les appels qu'avec des contacts existants. Pour créer automatiquement les contacts, allez dans les paramètres de votre intégration et activez **Create lead for unknown calls**.
    * **Contact supprimé** — Le contact a été supprimé de votre CRM. Allo est additif et ne synchronise pas les appels des contacts supprimés. Recréez le contact dans votre CRM, puis relancez la synchronisation.
    * **Intégration déconnectée** — Votre clé API a été supprimée ou révoquée dans JobNimbus. Allo apparaît toujours connecté mais les requêtes échouent. Créez une nouvelle clé, puis déconnectez et reconnectez l'intégration dans Allo.
    * **Appel en attente (icône de chargement)** — Allo est encore en train de faire correspondre le contact. Cela peut prendre jusqu'à 24 heures avant d'être marqué comme une erreur. Une fois le contact présent dans votre CRM, vous pouvez relancer manuellement.
    * **Le contact est un favori** — Par défaut, les appels avec un contact favori ne sont pas synchronisés avec votre CRM. Retirez le contact de vos favoris si vous souhaitez que ces appels soient synchronisés.
  </Accordion>

  <Accordion title="Les contacts ne se synchronisent pas">
    La première synchronisation peut prendre jusqu'à **15 minutes** pour les grandes bases de contacts. Ensuite, les contacts se synchronisent de manière incrémentale toutes les **5 minutes** — pas en temps réel.

    Allo ne synchronise que les contacts ayant au moins un numéro dans le champ **Mobile**, **Home** ou **Work**. Les contacts sans numéro de téléphone, ainsi que les contacts supprimés, n'apparaîtront pas dans Allo.

    Si les contacts n'apparaissent toujours pas après 15 minutes, déconnectez et reconnectez l'intégration.
  </Accordion>

  <Accordion title="SMS non synchronisés">
    Si vos SMS n'apparaissent pas, vérifiez que l'intégration est connectée dans **Settings** > **Integrations** et consultez l'indicateur d'intégration dans la liste des appels sur [web.withallo.com](https://web.withallo.com) pour le détail de l'erreur.

    Si les SMS n'apparaissent toujours pas, déconnectez et reconnectez l'intégration.
  </Accordion>

  <Accordion title="Contacts en double">
    Allo reflète exactement votre intégration. Si votre CRM contient des contacts en double avec le même numéro de téléphone, ils apparaissent comme des contacts distincts dans Allo.

    Nettoyez les doublons dans votre CRM — Allo reflétera le changement lors de la prochaine synchronisation.
  </Accordion>

  <Accordion title="Appel synchronisé avec le mauvais contact">
    Lorsque plusieurs contacts partagent le même numéro de téléphone, Allo enregistre l'appel sur le premier contact correspondant. Avant de signaler une synchronisation manquante, vérifiez tous les contacts partageant ce numéro — l'appel est peut-être déjà synchronisé avec un autre. Cliquez sur l'indicateur d'intégration de n'importe quel appel dans l'application web pour voir exactement avec quel contact il a été synchronisé.
  </Accordion>
</AccordionGroup>