# Keap

> Connectez Keap à Allo, synchronisez vos contacts et entreprises, et enregistrez chaque appel en note Call et les SMS de chaque jour dans une note

Allo enregistre chaque appel en note **Call** sur le contact Keap correspondant, et regroupe les SMS échangés avec un contact dans une note par jour. Vos contacts et entreprises Keap se synchronisent dans Allo toutes les 5 minutes.

L'intégration fonctionne avec Keap Pro, Keap Max et Keap Max Classic (anciennement Infusionsoft).

## Comment connecter

L'intégration Keap se connecte avec une clé API Keap. Il faut un admin ou un manager Allo pour connecter l'intégration.

### Créer votre clé API Keap

Utilisez une **Service Account Key**. Elle donne à Allo l'accès à tous les contacts de votre compte Keap. Seul un admin Keap peut en créer une.

<Steps>
  <Step title="Ouvrir les paramètres API">
    Dans Keap Pro ou Keap Max, allez dans **Settings** > **API Settings**. Dans Keap Max Classic, ouvrez votre **menu de profil** (en haut à droite) et cliquez sur **API Settings**.
  </Step>
  <Step title="Ajouter une Service Account Key">
    Ajoutez une nouvelle **Service Account Key** et donnez-lui un nom, par exemple **Allo**.
  </Step>
  <Step title="Copier la clé">
    Copiez la clé tout de suite. Keap n'affiche la clé complète qu'une seule fois : si vous la perdez, créez-en une nouvelle.
  </Step>
</Steps>

<Warning>
  Vous pouvez aussi vous connecter avec un **Personal Access Token**, que tout utilisateur Keap peut créer depuis la même page. Un Personal Access Token ne voit que ce que son utilisateur voit dans Keap : Allo ne synchronise alors que les contacts de cet utilisateur et ne peut enregistrer les appels et SMS que sur eux. Utilisez une Service Account Key pour synchroniser les contacts de toute votre équipe.
</Warning>

### Connecter dans Allo

<Steps>
  <Step title="Ouvrir les intégrations">
    Allez sur [**web.withallo.com**](https://web.withallo.com) puis dans **Settings** > **Integrations**.
  </Step>
  <Step title="Trouver Keap">
    Trouvez **Keap** dans la liste et cliquez sur **Connect**.
  </Step>
  <Step title="Coller la clé API">
    Collez la Service Account Key copiée depuis Keap.
  </Step>
  <Step title="Enregistrer et connecter">
    Cliquez sur **Save & Connect**. Allo importe vos contacts et entreprises Keap.
  </Step>
</Steps>

## Ce qui est synchronisé

**De Keap vers Allo :**
- Les contacts, avec leur prénom et nom, leur e-mail, tous leurs numéros de téléphone, leur poste, leur entreprise, leur site web, leur propriétaire et un lien vers le contact dans Keap
- Les entreprises, avec leur nom, leur numéro de téléphone, leur site web, leur adresse, leurs notes et leur propriétaire, et un lien vers l'entreprise dans Keap

Le propriétaire est l'utilisateur Keap auquel la fiche est assignée, associé à vos utilisateurs Allo par e-mail.

**D'Allo vers Keap :**
- Les appels, enregistrés en notes Call sur le contact correspondant
- Les SMS, enregistrés dans une note par contact et par jour
- Les nouveaux contacts, créés dans Keap uniquement quand **Create lead for unknown calls** est activé. Allo crée le contact avec le nom, l'e-mail, le numéro de téléphone, le poste et le site web connus dans Allo.

Allo ne remplit que les champs vides d'un contact existant et ajoute les e-mails et numéros de téléphone que le contact n'a pas encore, dans les emplacements libres de Keap (jusqu'à 5 numéros de téléphone et 3 e-mails par contact). Allo n'écrase jamais ce qui est déjà renseigné dans Keap.

Les contacts et entreprises se synchronisent toutes les 5 minutes, uniquement les fiches modifiées. Les opportunités (deals) et les tâches ne sont pas synchronisées. Supprimer une fiche dans Keap ne supprime pas le contact dans Allo. Les contacts sans numéro de téléphone ne sont pas synchronisés dans Allo.

Lors d'un appel entrant ou sortant, Allo retrouve le contact Keap grâce à n'importe lequel de ses numéros, dans les formats courants utilisés dans Keap (par exemple `+1 415 555 0123`, `(415) 555-0123`, `415.555.0123` ou `06 12 34 56 78`).

## Comment les appels sont synchronisés

Après chaque appel, Allo ajoute une note **Call** au contact correspondant. La note apparaît dans les notes et l'historique du contact.

Le titre de la note indique le sens, le résultat, l'utilisateur Allo et la durée, par exemple `Allo Outbound Call - Answered - Jane Doe (5:12)`. La note contient :

- La date et l'heure de l'appel, en UTC
- Qui a appelé qui et sur quelle ligne Allo
- Les tags de l'appel
- Le résumé de l'appel
- Un lien vers l'enregistrement de l'appel

Keap date chaque note du moment de sa création : la date de la note est donc celle où Allo a enregistré l'appel. La ligne **Date** en haut de la note indique l'heure réelle de l'appel.

La transcription de l'appel n'est pas ajoutée à la note.

Quand vous modifiez le résumé, les tags ou le résultat d'un appel dans Allo, Allo met à jour la même note dans Keap.

Allo écrit la note au nom de l'utilisateur Keap dont l'e-mail correspond à l'utilisateur Allo qui a pris l'appel. Si aucun utilisateur Keap ne correspond, la note est écrite au nom de l'utilisateur Keap qui a créé la clé API, ou à défaut d'un admin Keap.

Keap Max Classic utilise les types de notes configurés par votre admin. Si votre compte n'a pas de type **Call**, Allo ajoute la note sans type.

## Comment les SMS sont synchronisés

Allo regroupe les SMS dans une note par contact et par jour, intitulée par exemple `Message texte - Camille Durand - 9 nov. 2026`. Chaque message est ajouté à la note du jour avec son heure, son sens et l'utilisateur Allo.

## Click-to-call

Keap n'a pas de click-to-call intégré pour Allo. Installez l'[extension Chrome Allo](/fr/help/integrations/chrome-extension) : elle ajoute une icône Allo à côté des numéros de téléphone dans Keap, et un clic lance l'appel dans l'application Allo.

## Troubleshooting

Vérifiez l'état de synchronisation de chaque appel depuis la **liste des appels sur [web.withallo.com](https://web.withallo.com)**. Chaque appel a un indicateur d'intégration qui montre 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é Keap, vérifiez ces points :

    - **Type de clé** : collez une Service Account Key ou un Personal Access Token créé dans les **API Settings** de Keap, pas un mot de passe Keap ni un secret client OAuth.
    - **Clé complète** : collez la clé en entier, sans espaces. Keap ne l'affiche qu'une fois : créez une nouvelle clé si vous ne l'avez pas copiée.
    - **Admin** : seul un admin Keap peut créer une Service Account Key.
  </Accordion>

  <Accordion title="Connecté, mais rien ne se synchronise">
    Allo ne vérifie pas la clé au moment de la connexion : une clé mal saisie, supprimée ou expirée apparaît quand même comme connectée. La première synchronisation échoue alors et aucun contact n'apparaît.

    Créez une nouvelle clé dans Keap, puis déconnectez et reconnectez l'intégration dans Allo avec la nouvelle clé.
  </Accordion>

  <Accordion title="Seule une partie de mes contacts se synchronise">
    L'intégration est connectée avec un **Personal Access Token**, qui ne voit que les contacts visibles par son utilisateur Keap. Demandez à un admin Keap de créer une **Service Account Key**, puis déconnectez et reconnectez l'intégration dans Allo avec cette clé.

    Allo ignore aussi les contacts sans numéro de téléphone.
  </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** : la clé Keap a été supprimée ou a expiré. Allo apparaît toujours connecté mais les requêtes échouent. Créez une nouvelle clé dans Keap, 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.
    - **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>

  <Accordion title="Les appels apparaissent en notes sans type Call">
    Votre compte est sur Keap Max Classic et n'a pas de type de note **Call**. Demandez à votre admin Keap d'ajouter un type de note **Call** : les appels suivants seront enregistrés avec ce type.
  </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 et entreprises se synchronisent de manière incrémentale toutes les **5 minutes**, pas en temps réel.

    Keap limite le nombre de requêtes par clé (240 requêtes par minute et 30 000 par jour). Sur un gros compte, la première synchronisation attend cette limite et réessaie, ce qui peut ajouter quelques minutes.

    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">
    Les SMS sont ajoutés à une note par contact et par jour. Cherchez sur le contact dans Keap la note intitulée `Message texte - <nom du contact> - <date>`.

    Si la note est absente, 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 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é.
  </Accordion>
</AccordionGroup>
