Gorgias

Enregistrez chaque appel et SMS Allo dans Gorgias comme ticket Téléphone ou SMS du client correspondant, et retrouvez vos clients Gorgias dans Allo quand ils appellent

Mis à jour le

L'intégration Gorgias enregistre chaque appel Allo comme ticket Phone et chaque SMS comme ticket SMS du client Gorgias correspondant. Un appel apparaît comme une fiche d'appel avec un lien vers l'enregistrement, et le résumé IA et la transcription sont dans une note interne, visible uniquement par vos agents. Un appel et les SMS qui l'entourent restent dans le même ticket.

Vos clients Gorgias qui ont un numéro de téléphone sont synchronisés dans Allo, modifications comprises : vos appelants apparaissent avec leur nom Gorgias. Si vous utilisez aussi l'intégration Shopify, vos appelants apparaissent aussi avec leur total dépensé et leur dernière commande Shopify.

Comment connecter

L'intégration Gorgias se connecte avec votre domaine Gorgias, votre e-mail de connexion Gorgias et une clé API REST Gorgias. Il faut être administrateur ou manager Allo pour connecter l'intégration.

Comment obtenir votre clé API Gorgias

La clé API appartient à un utilisateur Gorgias. Allo écrit les tickets et les notes au nom de cet utilisateur, sauf si l'appel est assigné à un autre agent (voir Comment les appels sont synchronisés plus bas).

Ouvrir les paramètres REST API

Dans Gorgias, cliquez sur l'icône d'engrenage en bas à gauche pour ouvrir Settings, puis allez dans Account > REST API.

Créer la clé API

Dans la section API Access & Credentials, cliquez sur Create API Key si aucune clé n'existe encore. Si une clé existe déjà, copiez-la : ne cliquez pas sur Reset, car une réinitialisation désactive aussitôt l'ancienne clé.

Copier vos identifiants

Copiez le Password (API Key) et notez le Username, qui est votre e-mail de connexion Gorgias. Vous collez les deux dans Allo à l'étape suivante.

Votre domaine Gorgias est la partie avant .gorgias.com dans l'adresse de votre helpdesk. Pour votremarque.gorgias.com, le domaine est votremarque. Il apparaît aussi dans la Base API URL sur la même page.

Connecter dans Allo

Aller dans Intégrations

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

Trouver Gorgias

Trouvez Gorgias dans la section Support et cliquez sur Connecter.

Saisir votre domaine, votre e-mail et votre clé API

Saisissez votre domaine Gorgias dans le champ Domaine Gorgias, votre e-mail de connexion Gorgias dans le champ E-mail de connexion Gorgias, et collez la clé API dans le champ Clé API.

Enregistrer et connecter

Cliquez sur Enregistrer et Connecter. Allo connecte l'intégration à votre compte Gorgias.

Attendre l'import des clients

Allo importe vos clients Gorgias qui ont un numéro de téléphone. 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écident quelles lignes Allo envoient leurs appels et SMS à Gorgias. 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 jamais dans votre boîte support.

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

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

Créer les appelants inconnus dans Gorgias (facultatif)

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

  • Activé : Allo crée l'appelant comme nouveau client Gorgias, avec son numéro de téléphone et son e-mail, et enregistre l'appel ou le SMS sur ce client. Le nouveau client porte 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 Gorgias ne sont pas envoyés à Gorgias.

Ce qui est synchronisé

De Gorgias vers Allo :

  • Les clients qui ont un numéro de téléphone, avec leur nom, leur e-mail et leurs numéros de téléphone

D'Allo vers Gorgias :

  • Les appels, enregistrés comme tickets Téléphone avec une fiche d'appel et une note interne
  • Les SMS, enregistrés comme tickets SMS
  • Les nouveaux clients, quand Créer les appelants inconnus dans Gorgias est activé

Sens de la synchronisation : dans les deux sens. Les appels et SMS sont envoyés à Gorgias au fil de l'eau. La première synchronisation importe vos clients Gorgias qui ont un numéro de téléphone, en commençant par les plus récemment modifiés. Sur les comptes importants, la première synchronisation peut se limiter aux clients modifiés au cours des 12 derniers mois. Ensuite, Allo vérifie toutes les heures les clients créés ou modifiés dans Gorgias : les modifications faites dans Gorgias arrivent dans Allo.

Un client dont le dernier numéro de téléphone est supprimé dans Gorgias est retiré d'Allo à la synchronisation suivante. Les clients Gorgias sans numéro de téléphone ne sont pas importés, car Allo ne peut pas les relier à un appel ou un SMS. Allo ne modifie jamais un client Gorgias existant. Gorgias n'a ni entreprises ni affaires : aucune n'est synchronisée.

Allo retrouve le client Gorgias par son numéro de téléphone, sur les canaux téléphone du client. Allo cherche le numéro au format international, par exemple +33612345678, et dans ses formats nationaux les plus courants, par exemple 0612345678 ou (415) 555-1234.

Comment les appels sont synchronisés

Après chaque appel sur une ligne support, Allo crée un ticket Gorgias pour le client correspondant, ou ajoute l'appel au ticket Allo récent du client (voir Comment les rappels et SMS sont regroupés dans un même ticket plus bas). Le ticket a :

  • Le canal Phone et la priorité Normal
  • Les tags allo et allo-call
  • Un titre avec les détails de l'appel, par exemple Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)

Le ticket contient deux messages :

  • Une fiche d'appel, envoyée par le client pour un appel entrant ou par votre agent pour un appel sortant. Elle indique le sens et le résultat de l'appel, l'heure de début (UTC), la durée, les numéros d'origine et de destination, la ligne Allo, l'utilisateur Allo et un lien vers l'enregistrement.
  • Une note interne avec le résumé IA, les tags de l'appel et la transcription, avec le nom des interlocuteurs quand il est disponible. Les appels manqués sans message vocal n'ont pas de note interne.

Le ticket est assigné à l'utilisateur Gorgias dont l'e-mail correspond à celui de l'utilisateur Allo, et la fiche d'appel et la note interne sont écrites à son nom. Si aucun utilisateur Gorgias actif n'a cet e-mail, le ticket reste non assigné et les messages sont écrits au nom de l'utilisateur qui a connecté Allo.

Statut du ticket

Chaque ticket Allo est Open, pour les appels répondus, manqués et les messages vocaux, pour que votre équipe voie chaque conversation téléphonique dans sa boîte. Allo ne ferme jamais un ticket : c'est le rôle de vos agents.

Comment les rappels et SMS sont regroupés dans un même ticket

Les appels et SMS avec un même client partagent un ticket. Un nouvel appel ou SMS rejoint le ticket Allo du client quand ce ticket est Open et a été mis à 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 SMS rejoint un ticket existant :

  • Allo l'ajoute au ticket comme nouveaux messages.
  • Allo renomme le ticket 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 le ticket ne l'a pas encore. Les tags déjà présents sont conservés.
  • La fenêtre d'une heure repart de cet appel ou SMS.

Une fois qu'un agent ferme le ticket, l'appel ou SMS suivant ouvre un nouveau ticket. Allo n'ajoute des appels et SMS qu'aux tickets qui ont le tag allo-call ou allo-sms. Allo ne les ajoute jamais à un ticket venu d'un autre canal, comme un e-mail ou un chat.

Utilisez les tags allo, allo-call et allo-sms pour filtrer les tickets Allo dans vos vues, règles et statistiques Gorgias.

Comment les SMS sont synchronisés

Après chaque SMS envoyé ou reçu sur une ligne support, Allo crée un ticket Gorgias pour le client correspondant, ou ajoute le SMS au ticket Allo récent du client. Le ticket a le canal SMS, les tags allo et allo-sms, et un titre comme Allo Inbound SMS to US Support (+18885550100) - Leo.

Chaque SMS est un message du ticket, avec son texte et son heure d'envoi : envoyé par le client pour un SMS entrant, par votre agent pour un SMS sortant. Gorgias ne renvoie pas ces messages : ils sont enregistrés comme déjà envoyés.

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.

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 à votre administrateur ou manager de la configurer.

Si Allo refuse vos informations Gorgias, vérifiez ces causes :

  • Vous n'êtes ni propriétaire ni administrateur Gorgias. Seuls les propriétaires et administrateurs peuvent voir et créer des clés API. Demandez à l'un d'eux de connecter Allo, ou de vous donner le rôle administrateur.
  • Le domaine est incorrect. Saisissez seulement la partie avant .gorgias.com, par exemple votremarque.
  • L'e-mail ne correspond pas à la clé API. Saisissez l'e-mail de connexion affiché comme Username à côté de la clé API.
  • La clé API a été réinitialisée. Une réinitialisation désactive aussitôt l'ancienne clé. Copiez la clé actuelle dans Settings > Account > REST API.
Appel ou SMS non synchronisé dans Gorgias

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 à Gorgias. Vérifiez Paramètres > Intégrations > Gorgias > Lignes support, ou choisissez Toutes les lignes pour tout envoyer.
  • Le client n'est pas dans Gorgias avec ce numéro. Avec Créer les appelants inconnus dans Gorgias désactivé, les appels et SMS des numéros inconnus ne sont pas envoyés. Ajoutez le numéro au client Gorgias, ou activez le réglage.
  • La clé API ne fonctionne plus. La clé API appartient à l'utilisateur Gorgias qui a connecté Allo. Si cet utilisateur quitte votre compte Gorgias, perd le rôle administrateur ou réinitialise la clé, Allo semble toujours connecté mais les requêtes échouent. Déconnectez Gorgias dans Allo et reconnectez-le avec une clé API actuelle.
  • Limites de requêtes Gorgias. Gorgias autorise environ 2 requêtes API par seconde pour chaque compte, partagées avec vos autres applications Gorgias. Allo réessaie quelques fois les requêtes limitées. Si la limite est encore atteinte, l'appel ou le SMS n'est pas synchronisé : attendez une minute et resynchronisez-le depuis la liste des appels.
Un client Gorgias n'apparaît pas dans Allo

Vérifiez ces causes :

  • Le client n'a pas de numéro de téléphone dans Gorgias. Allo importe seulement les clients avec un canal téléphone. Ajoutez le numéro au client dans Gorgias ; Allo l'importe à la synchronisation horaire suivante.
  • La synchronisation n'a pas encore eu lieu. Allo vérifie Gorgias toutes les heures. Un client créé ou modifié dans Gorgias apparaît dans Allo après la synchronisation suivante.
  • Le premier import est encore en cours. Sur un compte Gorgias important, le premier import peut prendre du temps. L'intégration affiche l'import en cours jusqu'à la fin.
Clients en double

Avec Créer les appelants inconnus dans Gorgias activé, Allo cherche d'abord un client Gorgias existant par e-mail, puis par numéro de téléphone, et ne crée un client que s'il n'en trouve aucun. Un doublon apparaît quand la même personne est enregistrée dans Gorgias avec un autre e-mail et sans canal téléphone. Fusionnez les clients dans Gorgias.

Un rappel ou un SMS a ouvert un nouveau ticket

Un rappel ou un SMS rejoint un ticket existant seulement si ces trois conditions sont remplies :

  • Le ticket a été créé par Allo et a toujours le tag allo-call ou allo-sms.
  • Le ticket est Open, pas Closed.
  • Le ticket a été mis à jour moins d'une heure avant le nouvel appel ou SMS.

Si l'une de ces conditions n'est pas remplie, Allo ouvre un nouveau ticket.

Mon client a reçu un e-mail pour un ticket Allo

Allo crée ses tickets par l'API Gorgias, et les notes internes ne sont jamais envoyées à votre client. Un e-mail vient de votre propre configuration Gorgias. Vérifiez vos Rules Gorgias qui répondent aux nouveaux tickets, et excluez les tickets avec le tag allo.

Les tickets Allo comptent-ils dans ma facturation Gorgias ?

Gorgias facture par ticket facturable : un ticket où au moins un message est envoyé depuis votre helpdesk. Les notes internes ne sont pas facturables, pas plus qu'un ticket qui ne contient que des messages entrants. Les appels et SMS sortants sont enregistrés comme messages de votre agent. Consultez Settings > Billing & usage dans Gorgias pour voir comment votre abonnement les compte.

Le ticket n'est pas assigné

Allo assigne le ticket à l'utilisateur Gorgias dont l'e-mail correspond à celui de l'utilisateur Allo. Si les e-mails diffèrent, ou si l'utilisateur est désactivé, le ticket reste non assigné. Utilisez le même e-mail dans Allo et Gorgias, ou assignez les tickets Allo avec une règle Gorgias sur le tag allo-call ou allo-sms.