# 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

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](/fr/help/integrations/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.

<Note>
  L'API REST Gorgias est disponible sur tous les abonnements Helpdesk de Gorgias et pendant l'essai Gorgias. Seuls les propriétaires et administrateurs du compte Gorgias peuvent voir et créer des clés API.
</Note>

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

<Steps>
  <Step title="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**.
  </Step>
  <Step title="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é.
  </Step>
  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="Aller dans Intégrations">
    Dans Allo, allez dans **Paramètres** \> **Intégrations**.
  </Step>
  <Step title="Trouver Gorgias">
    Trouvez **Gorgias** dans la section **Support** et cliquez sur **Connecter**.
  </Step>
  <Step title="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**.
  </Step>
  <Step title="Enregistrer et connecter">
    Cliquez sur **Enregistrer et Connecter**. Allo connecte l'intégration à votre compte Gorgias.
  </Step>
  <Step title="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.
  </Step>
</Steps>

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

<Note>
  Pour un appel ou SMS entrant, la ligne est le numéro que le client a appelé ou à qui il a écrit. Pour un appel ou 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 Gorgias.
</Note>

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

<Warning>
  Ne retirez pas les tags `allo-call` et `allo-sms` des tickets Allo. Sans eux, chaque appel et SMS ouvre un nouveau ticket.
</Warning>

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.

<Warning>
  Répondez aux SMS depuis Allo. Une réponse écrite dans Gorgias n'est pas envoyée par Allo.
</Warning>

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

<AccordionGroup>
  <Accordion title="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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>
</AccordionGroup>
