> ## 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.

# Insightly

> Connectez Insightly à Allo, synchronisez vos contacts, leads et organisations, et enregistrez chaque appel et SMS en événement sur le contact et son organisation

Allo enregistre chaque appel en événement sur le contact ou le lead Insightly correspondant et sur l'organisation du contact, et regroupe les SMS échangés avec un contact dans un événement par jour. Vos contacts, leads et organisations Insightly se synchronisent dans Allo.

## Comment connecter

L'intégration Insightly se connecte avec votre clé API Insightly et votre API URL. Tous les plans Insightly incluent l'accès à l'API. La connexion doit être faite par un admin ou un manager Allo.

### Récupérer votre clé API et votre API URL Insightly

**1. Ouvrir vos paramètres utilisateur**

Dans Insightly, cliquez sur votre photo de profil en haut à droite, puis sur **User Settings**.

**2. Trouver la section API**

Descendez jusqu'à la section **API**. Elle affiche votre **API key** et, juste en dessous, votre **API URL**, par exemple `https://api.na1.insightly.com`.

Si le champ de la clé API indique **API Access is disabled**, un administrateur Insightly doit d'abord activer l'accès à l'API pour votre utilisateur.

**3. Copier les deux valeurs**

Copiez la clé API et l'API URL. Ne cliquez pas ensuite sur **Generate New API Key** : cela révoque immédiatement la clé utilisée par Allo.

Allo agit avec les droits de l'utilisateur Insightly propriétaire de la clé API. Utilisez la clé d'un utilisateur qui voit les contacts, leads et organisations que vous voulez dans Allo.

### Connecter dans Allo

**1. Ouvrir les intégrations**

Allez sur [**web.withallo.com**](https://web.withallo.com), puis dans **Settings** > **Integrations**.

**2. Trouver Insightly**

Trouvez **Insightly** dans la liste et cliquez sur **Connect**.

**3. Coller la clé API**

Collez la clé API copiée depuis Insightly.

**4. Coller l'API URL**

Collez l'API URL affichée sous la clé API, par exemple `https://api.na1.insightly.com`. Utilisez bien l'API URL, et non l'adresse affichée dans votre navigateur quand vous utilisez Insightly.

**5. Enregistrer et connecter**

Cliquez sur **Save & Connect**. Allo importe vos contacts, leads et organisations Insightly.

## Ce qui est synchronisé

**D'Insightly vers Allo :**

* Contacts, avec leur prénom et nom, leur email, leurs numéros de téléphone (professionnel, mobile, domicile, autre et assistant), leur fonction, leur organisation, leur propriétaire, leurs tags et un lien vers le contact dans Insightly
* Leads pas encore convertis, avec leur prénom et nom, leur email, leurs numéros de téléphone et de mobile, leur fonction, le nom de leur organisation, leur site web, leur statut, leur propriétaire, leurs tags et un lien vers le lead dans Insightly
* Organisations, avec leur nom, leur site web, leur numéro de téléphone, leur adresse, leur description, leur propriétaire et un lien vers l'organisation dans Insightly

Allo fait correspondre le propriétaire par email : le propriétaire d'un contact dans Allo est l'utilisateur Insightly qui a le même email.

**D'Allo vers Insightly :**

* Appels et SMS, enregistrés en événements sur le contact ou le lead correspondant et sur l'organisation du contact
* Nouveaux contacts, uniquement lorsque **Create lead for unknown calls** est activé. Allo crée un contact Insightly (et non un lead) avec le nom, l'email, le numéro de téléphone et la fonction connus dans Allo. Un contact sans nom dans Allo reçoit son numéro de téléphone comme prénom.

Sur un contact ou un lead existant, Allo remplit uniquement les champs vides et ajoute les numéros qu'il n'a pas encore. Allo n'écrase jamais ce qui est déjà renseigné dans Insightly et ne convertit jamais un lead.

Les contacts et les leads se synchronisent toutes les 10 minutes et les organisations toutes les 30 minutes, en ne reprenant que les fiches modifiées. Quand un lead est converti dans Insightly, il disparaît d'Allo et son contact prend le relais. Les opportunités et les projets ne sont pas synchronisés. Supprimer une fiche dans Insightly ne la retire pas d'Allo. Les fiches sans numéro de téléphone ne sont pas synchronisées dans Allo.

Lors d'un appel entrant ou sortant, Allo cherche l'appelant dans les champs **Phone** et **Mobile** de vos contacts, puis de vos leads.

> [!TIP]
>
> Insightly retrouve un numéro à partir des caractères enregistrés dans le champ : le format compte. Les numéros au format international (`+33612345678`) ou en chiffres seuls (`0612345678`) sont les mieux retrouvés. Les formats courants comme `06 12 34 56 78`, `+33 6 12 34 56 78` ou `(415) 555-0123` sont aussi retrouvés. Un numéro écrit avec des points, comme `06.12.34.56.78`, n'est pas retrouvé au moment de l'appel. Les contacts avec ce type de numéro, et les numéros des champs domicile, autre ou assistant, se synchronisent quand même dans Allo : une fois synchronisés, Allo affiche leur nom et enregistre leurs appels.

## Comment les appels sont synchronisés

Après chaque appel, Allo crée un **Event** dans Insightly, lié au contact correspondant et à son organisation s'il en a une, ou au lead. L'événement commence au début de l'appel et se termine à la fin de l'appel : il montre donc la durée de l'appel. Les appels manqués et les messages vocaux commencent et se terminent au même moment.

Le titre de l'événement indique le sens de l'appel, son résultat, l'utilisateur Allo et la durée, par exemple `Allo Appel Sortant - Répondu - Jean Dupont (5:12)`. Le détail de l'événement contient :

* Qui a appelé qui, et sur quelle ligne Allo
* Les tags de l'appel
* Un lien vers l'enregistrement de l'appel dans Allo
* Le résumé de l'appel

La transcription de l'appel n'est pas ajoutée à l'événement. Insightly limite le détail d'un événement à 4000 caractères : Allo raccourcit un résumé très long et garde le lien vers l'enregistrement.

L'événement appartient à l'utilisateur Insightly dont l'email correspond à celui de l'utilisateur Allo. Si aucun utilisateur Insightly actif n'a cet email, le propriétaire de la clé API devient propriétaire de l'événement.

Si vous modifiez le résumé, les tags ou le résultat d'un appel dans Allo, Allo met à jour le même événement dans Insightly.

## Comment les SMS sont synchronisés

Allo regroupe les SMS dans un événement par contact et par jour, intitulé par exemple `Message texte - Hugo Martin - 6 nov. 2026`. Chaque message est ajouté à l'événement du jour avec son heure, son sens et l'utilisateur Allo. L'événement est lié au contact et à son organisation, ou au lead. Quand l'événement du jour atteint la limite de 4000 caractères d'Insightly, Allo crée un deuxième événement pour ce jour.

## Click-to-call

Le click-to-call n'est pas disponible pour cette intégration.

## 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 affiche un indicateur d'intégration avec son état de synchronisation.

> [accordion] 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é Insightly, vérifiez ces points :
>
> * **API Access is disabled** : un administrateur Insightly a désactivé l'accès à l'API pour votre utilisateur. Demandez-lui de le réactiver, puis copiez à nouveau la clé API.
> * **Clé API** : collez la clé API complète depuis **User Settings** > **API**, sans espace avant ou après.
> * **API URL** : collez l'API URL affichée sous la clé API, comme `https://api.na1.insightly.com`. L'adresse de votre compte Insightly dans le navigateur ne fonctionne pas.

> [accordion] 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**. Si le contact existe, vérifiez le format de son numéro (voir l'astuce dans **Ce qui est synchronisé**).
> * **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** : la clé API Insightly a changé. Insightly crée une nouvelle clé API quand quelqu'un clique sur **Generate New API Key** et quand les droits administrateur d'un utilisateur changent, et l'ancienne clé cesse aussitôt de fonctionner. Copiez la nouvelle clé API, puis déconnectez et reconnectez l'intégration dans Allo.
> * **Limite quotidienne d'API atteinte** : Insightly limite chaque compte à un nombre de requêtes API par jour, partagé entre tous les outils qui y sont connectés. Quand la limite est atteinte, Allo réessaie plus tard. Vérifiez avec votre administrateur Insightly quels autres outils utilisent l'API.
> * **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.
> * **Contact 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 voulez que ces appels soient synchronisés.

> [accordion] Les contacts ne se synchronisent pas
>
> La première synchronisation peut prendre jusqu'à **15 minutes** pour les grandes bases de contacts. Ensuite, les contacts et les leads se synchronisent de manière incrémentale toutes les **10 minutes** et les organisations toutes les **30 minutes**, pas en temps réel.
>
> Allo ne synchronise que les contacts et les leads ayant au moins un numéro de téléphone. Les fiches sans numéro de téléphone n'apparaîtront pas dans Allo. Les leads convertis n'apparaissent pas non plus : c'est leur contact qui apparaît.
>
> Si les contacts n'apparaissent toujours pas après 15 minutes, déconnectez et reconnectez l'intégration.

> [accordion] SMS non synchronisés
>
> Les SMS sont ajoutés à un événement par contact et par jour. Cherchez sur le contact ou le lead, dans Insightly, l'événement `Message texte` daté du jour du SMS.
>
> Si l'événement est absent, 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] 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] 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 qui partagent 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é.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.