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

# Kustomer

> Enregistrez chaque appel et SMS Allo sur la timeline du client Kustomer comme message vocal ou SMS, et synchronisez vos clients et entreprises Kustomer dans Allo

L'intégration Kustomer enregistre chaque appel et SMS Allo sur la timeline du client Kustomer correspondant. Un appel devient un message **voice** et un SMS devient un message **SMS**, dans une conversation avec le tag `allo-call` ou `allo-sms`. Le message d'appel contient les détails de l'appel, le résumé IA et un lien vers l'enregistrement. La transcription est ajoutée en note interne. Un appel et les SMS qui l'entourent restent dans la même conversation.

Vos clients (customers) et entreprises Kustomer sont synchronisés dans Allo, modifications des clients comprises : vos appelants apparaissent avec leur nom et leur entreprise Kustomer.

Les messages écrits par Allo sont de simples enregistrements : Kustomer ne les envoie jamais à votre client par e-mail, SMS ou chat.

## Comment connecter

L'intégration Kustomer se connecte avec une clé API Kustomer, votre adresse Kustomer et votre région. Il faut être administrateur ou manager Allo pour connecter l'intégration, et administrateur Kustomer pour créer la clé API.

### Comment créer votre clé API Kustomer

La clé API est un utilisateur machine dans Kustomer. Chaque message, conversation et client écrit par Allo affiche le nom de la clé API comme auteur : nommez donc la clé **Allo**.

**1. Ouvrir les clés API**

Dans Kustomer, allez dans **Settings** > **Security** > **API Keys** et cliquez sur **Add API Key**.

**2. Nommer la clé**

Nommez la clé `Allo`. Laissez l'expiration vide, ou choisissez-en une longue : quand la clé expire, Allo n'enregistre plus les appels et SMS.

**3. Cocher les rôles**

Cochez tous les rôles listés ci-dessous.

**4. Copier la clé**

Créez la clé et copiez-la. Kustomer n'affiche la clé qu'une seule fois. Vous la collez dans Allo à l'étape suivante.

La clé API a besoin de ces rôles :

* `org.permission.customer.read`, `org.permission.customer.create` et `org.permission.customer.update`
* `org.permission.company.read`
* `org.permission.conversation.read`, `org.permission.conversation.create` et `org.permission.conversation.update`
* `org.permission.message.read`, `org.permission.message.create` et `org.permission.message.update`
* `org.permission.note.create`
* `org.permission.search.create`
* `org.permission.user.read`

> [!WARNING]
>
> Les rôles ne peuvent pas être modifiés après la création de la clé. S'il manque un rôle, créez une nouvelle clé API avec tous les rôles et reconnectez Kustomer dans Allo.

Votre adresse Kustomer est la partie avant `.kustomerapp.com` dans votre URL Kustomer. Pour `votreentreprise.kustomerapp.com`, l'adresse est `votreentreprise`. Allo l'utilise pour les liens vers Kustomer.

Votre région est l'endroit où votre compte Kustomer est hébergé : **États-Unis**, **Europe** ou **Inde**. Demandez à votre administrateur Kustomer si vous n'êtes pas sûr.

### Connecter dans Allo

**1. Aller dans Intégrations**

Dans Allo, allez dans **Paramètres** > **Intégrations**.

**2. Trouver Kustomer**

Trouvez **Kustomer** dans la section **Support** et cliquez sur **Connecter**.

**3. Saisir vos informations**

Collez la clé API dans le champ **Clé API**, saisissez votre adresse Kustomer dans le champ **Adresse Kustomer** et choisissez votre **Région**. Vous pouvez aussi coller votre URL Kustomer complète dans le champ de l'adresse : Allo ne garde que l'adresse.

**4. Enregistrer et connecter**

Cliquez sur **Enregistrer et Connecter**.

**5. Attendre l'import des contacts**

Allo importe vos clients et entreprises Kustomer. L'intégration affiche l'import en cours jusqu'à la fin de la première synchronisation.

### Choisir vos lignes support (facultatif)

Les lignes support définissent quelles lignes Allo envoient leurs appels et SMS à Kustomer. Seuls les appels et SMS sur les lignes choisies sont envoyés. Les appels et SMS sur les autres lignes ne sont pas envoyés du tout. Les conversations commerciales ou personnelles n'arrivent donc jamais à votre équipe support.

Pour envoyer tous les appels et SMS, laissez la sélection sur **Toutes les lignes**.

Pour choisir vos lignes support, allez dans **Paramètres** > **Intégrations** > **Kustomer**, ouvrez **Lignes support**, sélectionnez les lignes et cliquez sur **Enregistrer**.

> [!NOTE]
>
> Pour un appel ou un SMS entrant, la ligne est le numéro que le client a appelé ou auquel il a écrit. Pour un appel ou un SMS sortant, la ligne est le numéro affiché au client. Rappelez ou répondez depuis une ligne support si vous voulez que l'échange soit enregistré dans Kustomer.

### Créer les appelants inconnus dans Kustomer (facultatif)

Le réglage **Créer les appelants inconnus dans Kustomer** définit ce qui se passe quand l'appelant ou l'expéditeur du SMS n'est pas encore un client Kustomer.

* **Activé :** Allo crée l'appelant comme nouveau client Kustomer et enregistre l'appel ou le SMS sur ce client. Le nouveau client prend le nom du contact Allo, ou le numéro de téléphone si le contact Allo n'a pas de nom.
* **Désactivé :** les appels et SMS des numéros qui ne sont pas des clients Kustomer ne sont pas envoyés à Kustomer.

Le réglage est désactivé par défaut.

## Ce qui est synchronisé

**De Kustomer vers Allo :**

* Les clients qui ont un numéro de téléphone, avec leur nom, leur premier e-mail, leurs numéros de téléphone (numéros partagés compris), leur entreprise, leur avatar, leur date de dernière activité et leurs attributs personnalisés
* Les entreprises, avec leur nom, leur site web (à partir du premier domaine) et leurs attributs personnalisés

**D'Allo vers Kustomer :**

* Les appels, enregistrés comme messages vocaux sur la timeline du client correspondant, avec la transcription en note interne
* Les SMS, enregistrés comme messages SMS sur la timeline du client correspondant
* Les nouveaux clients, quand **Créer les appelants inconnus dans Kustomer** est activé

**Sens de synchronisation :** bidirectionnel. Les appels et SMS sont envoyés à Kustomer au fil de l'eau. La première synchronisation importe tous vos clients et entreprises Kustomer. Ensuite, Allo vérifie toutes les heures les clients modifiés dans Kustomer, et relit vos entreprises toutes les 6 heures.

Un client supprimé dans Kustomer, ou dont le dernier numéro de téléphone est retiré, est retiré d'Allo à la synchronisation horaire suivante. Les clients sans numéro de téléphone ne sont pas importés, car Allo ne peut pas les associer à un appel ou un SMS. Allo ne modifie jamais un client Kustomer existant.

Allo retrouve le client Kustomer par son numéro de téléphone, parmi ses numéros et ses numéros partagés. Allo cherche le numéro dans plusieurs formats nationaux et internationaux, comme `+33612345678` ou `06 12 34 56 78`.

## Comment les appels sont synchronisés

Après chaque appel sur une ligne support, Allo ajoute un message **voice** sur la timeline du client correspondant. Le message va dans une nouvelle conversation Allo, ou dans la conversation Allo récente du client (voir la section sur le regroupement ci-dessous).

Une nouvelle conversation a :

* Le statut **Open**
* Le tag `allo-call`
* Un nom avec les détails de l'appel, par exemple `Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)`
* L'utilisateur Kustomer dont l'e-mail correspond à celui de l'utilisateur Allo comme assigné. Si aucun utilisateur Kustomer n'a cet e-mail, la conversation n'est pas assignée.

Le message vocal est placé sur la timeline à l'heure réelle de début de l'appel, entrant ou sortant comme l'appel. Il contient :

* Le sens et le résultat de l'appel, la durée, et les numéros appelant et appelé avec leurs noms
* La ligne Allo et l'utilisateur Allo qui a traité l'appel, et les tags de l'appel
* Le résumé IA
* Un lien vers l'enregistrement de l'appel

Quand l'appel a une transcription, Allo l'ajoute en **note interne** sur la conversation. Les clients ne voient jamais les notes. Une transcription de plus de 10 000 caractères est coupée, avec un lien vers la transcription complète dans Allo.

Quand le résumé IA, le résultat ou les tags d'un appel changent dans Allo après son enregistrement, Allo met à jour le texte du message vocal.

### Comment les rappels et SMS sont regroupés dans une même conversation

Les appels et SMS avec un même client partagent une conversation. Un nouvel appel ou SMS rejoint la conversation Allo du client quand cette conversation est Open ou Snoozed et a été mise à jour moins d'une heure avant. Cela couvre le client qui rappelle ou réécrit, et votre équipe qui rappelle ou répond.

Quand un appel ou un SMS rejoint une conversation existante :

* Allo l'ajoute comme nouveau message.
* Allo renomme la conversation selon son contenu : `Allo calls with <nom du client> on <nom de la ligne> (<numéro>)`, `Allo SMS with …` ou `Allo calls and SMS with …`.
* Allo ajoute le tag `allo-call` ou `allo-sms` si la conversation ne l'a pas encore.
* Allo ne change jamais le statut de la conversation.

Une fois la conversation passée en Done par un agent, l'appel ou le SMS suivant ouvre une nouvelle conversation. Allo n'ajoute les appels et SMS qu'aux conversations qu'il a créées. Allo ne les ajoute jamais à une conversation venue d'un autre canal, comme un e-mail.

> [!WARNING]
>
> Allo reconnaît ses conversations aux tags `allo-call` et `allo-sms`, ou au nom qu'il leur a donné. Si vous retirez les tags et renommez une conversation Allo, l'appel ou le SMS suivant ouvre une nouvelle conversation.

## Comment les SMS sont synchronisés

Après chaque SMS envoyé ou reçu sur une ligne support, Allo ajoute un message **SMS** sur la timeline du client correspondant, dans une nouvelle conversation Allo ou dans sa conversation récente. Une nouvelle conversation est **Open**, porte le tag `allo-sms` et s'appelle par exemple `Allo Inbound SMS to US Support (+18885550100) - Leo`.

Le message SMS est placé sur la timeline à l'heure d'envoi du SMS, et contient :

* Le sens du SMS, et les numéros expéditeur et destinataire
* La ligne Allo et l'utilisateur Allo qui l'a envoyé ou reçu
* Le texte du message

Rien n'est envoyé par SMS à votre client depuis Kustomer.

## Click-to-call

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

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

> [accordion] Je n'arrive pas à connecter mon intégration
>
> Seuls les **administrateurs** et **managers** d'un espace Allo peuvent connecter des intégrations. Si vous ne voyez pas l'option, demandez à l'administrateur ou au manager de votre espace de la configurer.
>
> Si la connexion échoue, vérifiez ces causes :
>
> * **La clé API a été copiée en partie.** Kustomer n'affiche la clé qu'une seule fois. Créez une nouvelle clé API et collez-la à nouveau.
> * **La clé API a expiré ou a été supprimée.** Créez une nouvelle clé API avec tous les rôles listés plus haut.
> * **L'adresse est fausse.** Saisissez uniquement la partie avant `.kustomerapp.com`, par exemple `votreentreprise`.

> [accordion] Appel ou SMS non synchronisé dans Kustomer
>
> Vérifiez ces causes, dans cet ordre :
>
> * **L'appel ou le SMS n'était pas sur une ligne support.** Seuls les appels et SMS sur vos lignes support sont envoyés à Kustomer. Vérifiez **Paramètres** > **Intégrations** > **Kustomer** > **Lignes support**, ou choisissez **Toutes les lignes** pour tout envoyer.
> * **L'appelant n'est pas un client Kustomer.** Quand **Créer les appelants inconnus dans Kustomer** est désactivé, les appels et SMS des numéros inconnus ne sont pas envoyés. Ajoutez le numéro au client Kustomer, ou activez le réglage.
> * **Il manque un rôle à la clé API.** Kustomer refuse les requêtes que les rôles de la clé ne permettent pas. Les rôles ne se modifient pas : créez une nouvelle clé API avec tous les rôles listés plus haut, puis déconnectez Kustomer dans Allo et reconnectez-le avec la nouvelle clé.
> * **La région est fausse.** Un compte hébergé en Europe ou en Inde doit être connecté avec cette région. Déconnectez Kustomer dans Allo et reconnectez-le avec la bonne région.
> * **Limites de requêtes Kustomer.** Kustomer limite le nombre d'appels API par minute pour tout le compte, et les recherches à 100 par minute pour les clés API. Les requêtes limitées sont réessayées. Si la limite est toujours atteinte, attendez une minute et resynchronisez l'appel depuis la liste des appels.

> [accordion] Un client Kustomer n'apparaît pas dans Allo
>
> Vérifiez ces causes :
>
> * **Le client n'a pas de numéro de téléphone dans Kustomer.** Allo n'importe que les clients avec un numéro ou un numéro partagé. Ajoutez le numéro dans Kustomer : Allo importe le client à la synchronisation horaire suivante.
> * **La synchronisation n'a pas encore tourné.** Allo vérifie Kustomer toutes les heures. Un client créé ou modifié dans Kustomer apparaît dans Allo après la synchronisation suivante.
> * **Le premier import est encore en cours.** Sur un gros compte Kustomer, le premier import peut prendre plusieurs minutes.

> [accordion] Un rappel ou un SMS a ouvert une nouvelle conversation
>
> Un rappel ou un SMS rejoint une conversation existante seulement si ces trois conditions sont vraies :
>
> * La conversation a été créée par Allo et porte encore le tag `allo-call` ou `allo-sms`, ou le nom qu'Allo lui a donné.
> * La conversation est Open ou Snoozed, pas Done.
> * La conversation a été mise à jour moins d'une heure avant le nouvel appel ou SMS.
>
> Si l'une de ces conditions est fausse, Allo ouvre une nouvelle conversation.

> [accordion] La conversation n'est pas assignée
>
> Allo assigne les nouvelles conversations à l'utilisateur Kustomer dont l'e-mail correspond à celui de l'utilisateur Allo. Si les e-mails diffèrent, la conversation n'est pas assignée. Utilisez le même e-mail dans Allo et Kustomer, ou routez les conversations Allo avec une règle Kustomer sur le tag `allo-call` ou `allo-sms`.

> [accordion] Les messages Allo affichent « Allo » comme auteur
>
> La clé API est un utilisateur machine qui porte le nom de la clé. Tout ce qu'Allo écrit affiche ce nom comme auteur : vos agents savent ce qui vient d'Allo.


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