# Help Scout

> Enregistrez chaque appel et chaque SMS Allo dans une boîte de réception Help Scout, sur la fiche du client, et synchronisez vos clients et organisations Help Scout avec Allo

L'intégration Help Scout enregistre chaque appel et chaque SMS Allo dans la boîte de réception Help Scout de votre choix, sur la fiche du client. Un appel devient une conversation téléphonique avec les détails de l'appel, le résumé IA, un lien vers l'enregistrement et la transcription. Un SMS est ajouté en note. Les appels et SMS avec un même client à moins d'une heure d'intervalle partagent une seule conversation : votre équipe les lit ensemble.

Vos clients et organisations Help Scout sont synchronisés avec Allo : les appelants s'affichent avec leur nom et leur entreprise Help Scout.

<Note>
  Aucun e-mail n'est envoyé à vos clients : Allo importe ses conversations dans Help Scout sans les envoyer. Les SMS vont dans un seul sens : répondez à un SMS depuis Allo, pas depuis Help Scout.
</Note>

## Comment connecter

L'intégration Help Scout se connecte avec votre identifiant Help Scout (OAuth). Il faut un admin ou un manager Allo pour connecter l'intégration. Allo voit ce que voit l'utilisateur Help Scout qui connecte : connectez-vous avec un utilisateur Help Scout qui a accès à la boîte de réception où Allo doit écrire, idéalement un propriétaire du compte ou un administrateur.

### Connecter dans Allo

<Steps>
  <Step title="Allez dans Intégrations">
    Dans Allo, allez dans **Paramètres** \> **Intégrations**.
  </Step>
  <Step title="Trouvez Help Scout">
    Trouvez **Help Scout** dans la section **Support** et cliquez sur **Connecter**.
  </Step>
  <Step title="Autorisez Allo dans Help Scout">
    Connectez-vous à Help Scout si besoin, puis cliquez sur **Authorize** pour autoriser Allo à accéder à votre compte Help Scout.
  </Step>
  <Step title="Choisissez la boîte de réception (facultatif)">
    Allez dans **Paramètres** \> **Intégrations** \> **Help Scout**, choisissez la boîte de réception Help Scout où Allo écrit dans **Boîte de réception**, puis cliquez sur **Enregistrer**.
  </Step>
</Steps>

Tant qu'aucune boîte n'est choisie, Allo écrit dans votre seule boîte de réception, ou dans la plus ancienne si vous en avez plusieurs.

<Tip>
  Créez une boîte de réception dédiée dans Help Scout, par exemple « Appels Allo », avant de la choisir. Vos autres boîtes restent alors telles quelles. C'est facultatif : Allo peut écrire dans toute boîte visible par l'utilisateur connecté.
</Tip>

### Choisir vos lignes support (facultatif)

Les lignes support déterminent quelles lignes Allo envoient leurs appels et SMS à Help Scout. 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 : vos conversations commerciales ou personnelles n'arrivent jamais dans votre boîte Help Scout.

Pour tout envoyer, laissez la sélection sur **Toutes les lignes**.

Pour choisir les lignes support, allez dans **Paramètres** \> **Intégrations** \> **Help Scout**, 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 à qui il a écrit. Pour un appel ou un SMS sortant, la ligne est le numéro affiché au client.
</Note>

### Créer les appelants inconnus dans Help Scout (facultatif)

Le paramètre **Créer les appelants inconnus dans Help Scout** décide de ce qui se passe quand un appelant ou l'expéditeur d'un SMS n'est pas encore un client Help Scout.

- **Activé :** Allo crée l'appelant comme nouveau client Help Scout, au nom du contact Allo (ou à son numéro si le contact Allo n'a pas de nom), avec ses numéros et son e-mail. Allo enregistre ensuite l'appel ou le SMS.
- **Désactivé :** les appels et SMS des numéros qui ne sont pas des clients Help Scout ne sont pas envoyés à Help Scout.

Le paramètre est désactivé par défaut.

## Ce qui est synchronisé

**De Help Scout vers Allo :**
- Les clients qui ont un numéro de téléphone, avec leur nom, leur premier e-mail, leurs numéros, leur poste, leur photo, leur site web, leurs notes, leur organisation et leurs propriétés client
- Les organisations, avec leur nom, leur site web, leur description, leur logo, leurs notes, leur localisation et leurs numéros

**D'Allo vers Help Scout :**
- Les appels, comme conversations téléphoniques dans la boîte de réception choisie
- Les SMS, comme notes dans ces mêmes conversations
- Les nouveaux clients, quand **Créer les appelants inconnus dans Help Scout** est activé

**Sens de synchronisation :** Bidirectionnel. Les appels et SMS sont envoyés à Help Scout en temps réel. La première synchronisation importe tous vos clients et organisations Help Scout. Ensuite, Allo vérifie les clients modifiés toutes les heures et relit vos organisations toutes les 6 heures.

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. Un client dont le dernier numéro est supprimé dans Help Scout est retiré d'Allo à la synchronisation suivante.

Quand Allo trouve un client Help Scout existant pour un contact Allo, il complète seulement ce qui manque : les numéros que le client n'a pas encore, un e-mail s'il n'en a aucun, et le nom s'il est vide. Allo n'écrase jamais ce que votre équipe a saisi dans Help Scout.

Allo retrouve le client Help Scout par son numéro, au format international et dans les formats nationaux courants : `+33 6 12 34 56 78` et `06 12 34 56 78` trouvent le même client.

## Comment les appels sont synchronisés

Après chaque appel sur une ligne support, Allo enregistre l'appel comme conversation téléphonique sur le client, dans votre boîte Help Scout. Enregistrer une conversation n'envoie jamais rien à votre client.

La conversation contient :

- Un sujet avec les détails de l'appel, par exemple `Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)`
- Les numéros appelant et appelé, l'heure de début et la durée
- La ligne Allo, 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, ou vers l'appel dans Allo s'il n'y a pas d'enregistrement
- La transcription de l'appel, avec le nom des interlocuteurs quand il est connu. Une transcription très longue est coupée, avec un lien vers l'appel complet dans Allo.
- Le tag `allo-call`

La conversation affiche l'heure réelle de début de l'appel et est assignée à l'utilisateur Help Scout qui a le même e-mail que l'utilisateur Allo.

**Statut :** les appels répondus, transférés et bloqués, et tous les appels sortants, sont enregistrés comme **Closed**. Les appels entrants manqués et les messages vocaux sont enregistrés comme **Active**, pour que votre équipe rappelle le client.

### Les appels et SMS rapprochés partagent une conversation

Quand le client a déjà une conversation Allo dans la même boîte, mise à jour dans l'heure, le nouvel appel ou SMS y est ajouté au lieu d'ouvrir une nouvelle conversation. Le sujet devient alors, par exemple, `Allo calls and SMS with Jeanne Dupont on US Support (+18885550100)`. Si le nouvel appel ou SMS demande un suivi (un appel manqué ou un SMS reçu), Allo repasse la conversation en **Active**.

Allo n'ajoute jamais rien à une conversation marquée comme spam, et ouvre une nouvelle conversation quand la conversation existante est pleine (Help Scout accepte 100 messages par conversation).

### Quand un appel est modifié

Les modifications faites dans Allo après l'envoi d'un appel (résumé, résultat ou tags) ne sont pas envoyées à Help Scout.

## Comment les SMS sont synchronisés

Après chaque SMS envoyé ou reçu sur une ligne support, Allo l'ajoute comme note à la conversation Allo du client, ou ouvre une nouvelle conversation. Une note n'est visible que par votre équipe. Un SMS reçu laisse la conversation en **Active**, un SMS envoyé la laisse en **Closed**. La conversation reçoit le tag `allo-sms`.

Les SMS vont dans un seul sens : les réponses tapées dans Help Scout ne sont pas envoyées à votre client. Répondez depuis Allo.

## Click-to-call

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

## Dépannage

Vérifiez le statut 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 **admins** et **managers** d'un espace Allo peuvent connecter des intégrations. Si vous ne voyez pas l'option, demandez à l'admin ou au manager de votre espace de la configurer.
  </Accordion>

  <Accordion title="Un appel ou un SMS n'est pas synchronisé avec Help Scout">
    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 à Help Scout. Vérifiez **Lignes support**, ou choisissez **Toutes les lignes** pour tout envoyer.
    - **L'appelant n'est pas un client Help Scout.** Avec **Créer les appelants inconnus dans Help Scout** désactivé, les appels et SMS des numéros inconnus ne sont pas envoyés. Ajoutez le numéro au client Help Scout, ou activez le paramètre.
    - **L'utilisateur connecté ne voit pas la boîte.** Allo écrit en tant qu'utilisateur Help Scout qui a connecté l'intégration. Donnez-lui accès à la boîte, ou choisissez une autre boîte dans **Paramètres** \> **Intégrations** \> **Help Scout**.
    - **La connexion a été révoquée.** Allo semble toujours connecté mais les requêtes échouent. Déconnectez Help Scout dans Allo et reconnectez-le.
  </Accordion>

  <Accordion title="L'appel est dans la mauvaise boîte">
    Allo écrit dans la boîte choisie dans **Paramètres** \> **Intégrations** \> **Help Scout**, ou dans votre seule boîte (ou la plus ancienne) si aucune n'est choisie. Choisissez la boîte voulue et cliquez sur **Enregistrer**.
  </Accordion>

  <Accordion title="Un client Help Scout n'apparaît pas dans Allo">
    Vérifiez ces causes :

    - **Le client n'a pas de numéro dans Help Scout.** Allo importe seulement les clients avec un numéro. Ajoutez le numéro dans Help Scout ; Allo importe le client à la synchronisation suivante.
    - **La synchronisation n'a pas encore eu lieu.** Allo vérifie Help Scout toutes les heures pour les clients modifiés.
  </Accordion>

  <Accordion title="J'ai répondu à un SMS dans Help Scout et le client ne l'a pas reçu">
    Les SMS sont enregistrés dans Help Scout comme notes, qui sont internes. Les réponses tapées dans Help Scout ne sont pas envoyées par SMS. Répondez depuis Allo.
  </Accordion>
</AccordionGroup>
