Passer au contenu principal
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
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.
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.
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. Chaque appel a un indicateur d’intégration qui montre son état de synchronisation.
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.
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.
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.
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.
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.
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.