# Modjo

> Envoyez chaque appel enregistré dans Allo vers Modjo, sur le commercial qui l'a traité

Connectez Modjo et chaque appel enregistré, passé ou reçu par votre équipe dans Allo, est envoyé dans Modjo, comme un appel du membre de l'équipe qui l'a traité. Modjo transcrit, résume et analyse l'enregistrement de son côté, pour que votre équipe puisse revoir l'appel et s'en servir pour le coaching, comme pour tout autre appel.

## Comment connecter

### Récupérez votre clé API Modjo

Seul un **Administrateur** ou un **Manager** Modjo peut créer une clé API.

<Steps>
  <Step title="Ouvrez les réglages de l'API publique">
    Dans Modjo, allez dans **Settings** > **Integrations** et ouvrez la carte **Public API**.
  </Step>
  <Step title="Créez la clé">
    Créez une clé et copiez-la tout de suite. Modjo ne l'affiche qu'une fois.
  </Step>
</Steps>

<Warning>
La clé API appartient à tout votre espace Modjo. Si quelqu'un la supprime plus tard, Allo n'envoie plus d'appels à Modjo. Reconnectez alors Modjo dans Allo avec une nouvelle clé.
</Warning>

### Connectez dans Allo

<Steps>
  <Step title="Ouvrez les intégrations">
    Allez sur [**web.withallo.com**](https://web.withallo.com) puis dans **Paramètres** > **Intégrations**.
  </Step>
  <Step title="Trouvez Modjo">
    Trouvez **Modjo** dans la liste et cliquez sur **Connecter**.
  </Step>
  <Step title="Collez votre clé">
    Collez la clé API.
  </Step>
  <Step title="Enregistrez et connectez">
    Cliquez sur **Enregistrer et Connecter**. Une seule connexion couvre toute votre équipe Allo.
  </Step>
</Steps>

### Avant votre premier appel

Allo envoie chaque appel à l'utilisateur Modjo qui a le même e-mail que le membre de l'équipe dans Allo. Vérifiez ces points pour chaque membre de l'équipe dont les appels doivent arriver dans Modjo :

1. **Le même e-mail dans les deux outils.** Chaque membre de l'équipe doit avoir un utilisateur Modjo avec l'e-mail qu'il utilise dans Allo.
2. **Une licence Modjo.** Modjo n'accepte que les appels d'un utilisateur qui a une des licences de votre espace. Un admin Modjo les attribue.

## Ce qui est envoyé à Modjo

Après chaque appel enregistré, Allo envoie à Modjo :

- L'enregistrement de l'appel, que Modjo télécharge et traite de son côté
- Le membre de l'équipe qui a traité l'appel, comme utilisateur Modjo propriétaire
- La date et l'heure de début de l'appel, et sa durée
- Le sens de l'appel : entrant ou sortant
- Le numéro de l'autre personne, et son e-mail quand le contact en a un dans Allo, pour que Modjo puisse le rapprocher de ses contacts
- Un titre : **Allo call with** suivi du nom du contact, ou de son numéro s'il n'a pas de nom. Un appel d'un numéro masqué s'appelle **Allo call with Unknown caller**
- Ceux de vos tags d'appel Allo qui existent déjà dans Modjo, rapprochés par leur nom

Allo ne crée jamais de tag dans Modjo. Pour voir un tag sur vos appels dans Modjo, créez d'abord un tag du même nom dans Modjo.

Avant chaque envoi, Allo vérifie si l'appel est déjà dans Modjo (même membre de l'équipe, même heure de début, même numéro), pour qu'un nouvel essai ne l'envoie pas une deuxième fois.

**Sens de la synchronisation :** dans un seul sens (Allo → Modjo). Rien ne revient de Modjo dans Allo.

### Ce qui n'est pas envoyé

- Les appels sans enregistrement, comme les appels manqués
- Les appels de numéros qui ne correspondent à aucun contact dans Allo
- Les appels avec un contact que vous avez mis en favori dans Allo
- Le résumé et la transcription d'Allo : Modjo écrit les siens à partir de l'enregistrement
- Les SMS et les contacts

### Modifications après l'envoi

Modjo ne permet pas à Allo de modifier un appel une fois envoyé. Si vous ajoutez ou changez des tags sur un appel déjà arrivé dans Modjo, le changement reste dans Allo.

<Note>
Modjo peut enregistrer les appels qu'il reçoit dans votre CRM. Si Allo est aussi connecté à ce CRM, vérifiez que le même appel n'y apparaît pas deux fois, et désactivez l'enregistrement des appels d'un des deux côtés si c'est le cas.
</Note>

## Troubleshooting

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 ne peux pas connecter mon intégration">
    Seuls les **admins** et les **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.

    Si Allo refuse la clé API, vérifiez que vous avez copié la clé en entier et qu'elle existe toujours dans Modjo, dans **Settings** > **Integrations** > **Public API**.
  </Accordion>

  <Accordion title="Un appel n'est pas dans Modjo">
    Vérifiez l'indicateur d'intégration de l'appel dans l'application web. Les causes les plus fréquentes :

    - **Aucun utilisateur Modjo pour ce membre.** L'e-mail Allo du membre ne correspond à aucun utilisateur Modjo. Ajoutez-le dans Modjo avec le même e-mail.
    - **Pas de licence Modjo.** Un admin Modjo doit attribuer une licence à ce membre.
    - **L'appel n'a pas d'enregistrement.** Modjo ne prend que des appels avec de l'audio, donc les appels manqués ou non enregistrés ne sont jamais envoyés.
    - **Le numéro ne correspond à aucun contact dans Allo.** Ajoutez l'appelant comme contact dans Allo.
    - **La clé API ne fonctionne plus.** Quelqu'un l'a supprimée dans Modjo. Déconnectez Modjo dans Allo et connectez-le à nouveau avec une nouvelle clé.

    Une fois la cause corrigée, relancez la synchronisation depuis l'appel dans l'application web.
  </Accordion>

  <Accordion title="L'appel est dans Modjo mais la transcription n'est pas encore là">
    Modjo télécharge l'enregistrement et le traite de son côté, ce qui prend en général 5 à 30 minutes. La transcription et le résumé apparaissent une fois que Modjo a fini de traiter l'appel.
  </Accordion>

  <Accordion title="Un tag manque sur l'appel dans Modjo">
    Allo n'ajoute que les tags qui existent déjà dans Modjo. Créez le tag dans Modjo avec le même nom que dans Allo. Les appels envoyés ensuite le portent.
  </Accordion>

  <Accordion title="L'appel est sur la mauvaise personne dans Modjo">
    Allo choisit l'utilisateur Modjo à partir du membre de l'équipe qui a traité l'appel, rapproché par e-mail. Vérifiez que l'e-mail Allo de chaque membre correspond à son propre utilisateur Modjo, et pas à un compte partagé ou admin.
  </Accordion>
</AccordionGroup>
