# Zoho Desk

> Enregistrez chaque appel et SMS Allo dans Zoho Desk sur un ticket Téléphone du contact correspondant, avec une fiche d'appel, et synchronisez vos contacts et comptes Zoho Desk dans Allo

L'intégration Zoho Desk enregistre chaque appel et SMS Allo sur un ticket Zoho Desk de l'appelant, avec le canal **Phone**. Chaque appel est ajouté au ticket comme **fiche d'appel** (une activité Call) avec les détails de l'appel, le résumé IA, la transcription et un lien vers l'enregistrement. Les SMS sont ajoutés comme **commentaires privés**, visibles uniquement par vos agents. Un appel et les SMS qui l'entourent restent dans le même ticket.

Vos contacts et comptes Zoho Desk sont synchronisés dans Allo, modifications comprises, pour que vos appelants s'affichent avec leur nom et leur compte Zoho Desk.

## Comment se connecter

L'intégration Zoho Desk se connecte avec votre compte Zoho. Un administrateur ou manager Allo doit connecter l'intégration, et nous recommandons de la connecter avec un administrateur Zoho Desk, pour qu'Allo voie tous les contacts, tickets et départements.

<Note>
  Les fiches d'appel (activités Call) sont incluses dans les éditions Zoho Desk Professional et Enterprise, et pendant l'essai. Sur les éditions Free, Express et Standard, Allo ajoute chaque appel au ticket en commentaire privé, avec le même contenu. Voir [Éditions sans fiches d'appel](#éditions-sans-fiches-dappel).
</Note>

### Trouvez votre région Zoho

Zoho garde chaque compte dans un seul centre de données. L'adresse de votre Zoho Desk vous l'indique :

| Adresse de votre Zoho Desk | Région à choisir dans Allo |
| --- | --- |
| `desk.zoho.eu` | Europe |
| `desk.zoho.com` | États-Unis |
| `desk.zoho.in` | Inde |
| `desk.zoho.com.au` | Australie |

### Connectez-vous dans Allo

<Steps>
  <Step title="Allez dans Intégrations">
    Dans Allo, allez dans **Paramètres** \> **Intégrations**.
  </Step>
  <Step title="Trouvez Zoho Desk">
    Trouvez **Zoho Desk** dans la section **Support** et cliquez sur **Connecter**.
  </Step>
  <Step title="Choisissez votre région">
    Sélectionnez la région de votre compte Zoho Desk et cliquez sur **Connecter**.
  </Step>
  <Step title="Connectez-vous à Zoho et acceptez">
    Connectez-vous avec votre compte Zoho. Si vous avez accès à plusieurs portails Zoho Desk, choisissez celui à connecter. Cliquez sur **Accept** pour donner à Allo l'accès à Zoho Desk.
  </Step>
  <Step title="Attendez l'import des contacts">
    Allo importe vos contacts et comptes Zoho Desk. L'intégration affiche l'import en cours jusqu'à la fin de la première synchronisation.
  </Step>
</Steps>

### Choisissez un département (optionnel)

Allo crée ses tickets dans le **département par défaut** de votre portail. Pour utiliser un autre département, allez dans **Paramètres** \> **Intégrations** \> **Zoho Desk**, choisissez un département sous **Département** et cliquez sur **Enregistrer**. Seuls les départements actifs sont listés.

### Choisissez vos lignes support (optionnel)

Les lignes support décident quelles lignes Allo envoient leurs appels et SMS à Zoho Desk. 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, pour que les conversations commerciales ou personnelles n'arrivent jamais dans votre file support.

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

Pour choisir vos lignes support, allez dans **Paramètres** \> **Intégrations** \> **Zoho Desk**, 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 ce soit enregistré dans Zoho Desk.
</Note>

### Créer les appelants inconnus dans Zoho Desk (optionnel)

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

- **Activé :** Allo crée l'appelant comme nouveau contact Zoho Desk et enregistre l'appel ou le SMS sur ce contact. Le nouveau contact 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 contacts Zoho Desk ne sont pas envoyés à Zoho Desk.

## Ce qui est synchronisé

**De Zoho Desk vers Allo :**
- Les contacts qui ont un numéro de téléphone ou de mobile, avec leur nom, e-mail, numéros de téléphone et de mobile, fonction et nom de compte
- Les comptes, avec leur nom, téléphone, site web, secteur et description

**D'Allo vers Zoho Desk :**
- Les appels, enregistrés comme fiches d'appel sur les tickets Téléphone du contact Zoho Desk correspondant
- Les SMS, enregistrés comme commentaires privés sur les tickets Téléphone du contact Zoho Desk correspondant
- Les nouveaux contacts, quand **Créer les appelants inconnus dans Zoho Desk** est activé

**Sens de synchronisation :** Bidirectionnel. Les appels et SMS sont envoyés à Zoho Desk en temps réel. La première synchronisation importe tous vos contacts et comptes Zoho Desk. Ensuite, Allo vérifie toutes les heures les contacts et comptes créés ou modifiés dans Zoho Desk, pour que les modifications faites dans Zoho Desk arrivent dans Allo.

Un contact mis à la corbeille ou marqué comme spam dans Zoho Desk est retiré d'Allo à la synchronisation suivante. Un contact dont le dernier numéro de téléphone est supprimé dans Zoho Desk est aussi retiré d'Allo. Les contacts Zoho Desk 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 contact Zoho Desk existant.

Allo trouve le contact Zoho Desk par son numéro de téléphone, dans les champs **Phone** et **Mobile**. Les formats national et international d'un même numéro correspondent : un contact enregistré avec `(415) 555-1234` ou `06 12 34 56 78` est trouvé pour un appel de `+14155551234` ou `+33612345678`. Les champs de téléphone personnalisés ne sont pas vérifiés.

<Note>
  Si vous utilisez aussi l'intégration Zoho CRM, une même personne peut arriver dans Allo depuis Zoho CRM et depuis Zoho Desk. Allo regroupe les contacts qui partagent un numéro de téléphone dans votre équipe.
</Note>

## Comment les appels sont synchronisés

Après chaque appel sur une ligne support, Allo crée un ticket Zoho Desk pour le contact correspondant, ou ajoute l'appel au ticket Allo récent du contact (voir [Comment les appels et SMS de suivi sont regroupés dans un ticket](#comment-les-appels-et-sms-de-suivi-sont-regroupés-dans-un-ticket)). Le ticket a :

- Le canal **Phone** et le statut **Open**
- Votre département par défaut, ou le département choisi dans Allo
- Les tags `allo` et `allo-call`
- Un objet avec les détails de l'appel, par exemple `Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)`
- Une description d'une ligne : `Phone call with US Support (+18885550100) on Nov 6, 2026, 16:35 UTC (logged by Allo)`

L'appel lui-même est enregistré dans une **fiche d'appel** liée au ticket et au contact, datée du vrai début de l'appel, avec son sens et sa durée. Sa description contient :

- Le sens et le résultat de l'appel, l'heure de début (UTC), la durée, et les numéros appelant et appelé
- La ligne Allo et l'utilisateur Allo qui a traité l'appel, et les tags de l'appel
- Le résumé IA
- La transcription de l'appel, avec le nom des intervenants quand il est disponible
- Un lien vers l'enregistrement de l'appel

Le ticket et la fiche d'appel sont attribués à l'agent Zoho Desk dont l'e-mail correspond à celui de l'utilisateur Allo. Si aucun agent Zoho Desk n'a cet e-mail, le ticket reste non attribué.

Quand le résumé IA, les tags ou le résultat de l'appel changent dans Allo après l'appel, Allo met à jour la fiche d'appel.

### Éditions sans fiches d'appel

Sur les éditions Free, Express et Standard, Zoho Desk n'a pas de fiches d'appel. Allo le détecte et ajoute l'appel au ticket en **commentaire privé**, avec le même contenu. Tout le reste fonctionne de la même façon.

### 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 file. Allo ne résout ni ne ferme jamais un ticket : c'est le rôle de vos agents.

### Comment les appels et SMS de suivi sont regroupés dans un ticket

Les appels et SMS avec un même contact partagent un ticket. Un nouvel appel ou SMS rejoint le ticket Allo du contact quand ce ticket est Open ou On Hold, est dans le même département, 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 comme nouvelle fiche d'appel ou nouveau commentaire privé.
- Allo renomme le ticket selon son contenu : `Allo calls with <nom du contact> 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à sur le ticket sont conservés.
- La fenêtre d'une heure repart de cet appel ou SMS.

Une fois le ticket fermé par un agent, l'appel ou SMS suivant ouvre un nouveau ticket. Allo reconnaît ses tickets à leur canal **Phone** et à leur objet qui commence par `Allo`. Allo n'ajoute jamais d'appels ou de SMS à un ticket venu d'un autre canal, comme un e-mail.

<Warning>
  Ne renommez pas les tickets Allo avec un objet qui ne commence plus par `Allo …`. Allo ne les reconnaîtrait plus, et l'appel ou SMS suivant ouvrirait un nouveau ticket.
</Warning>

Utilisez les tags `allo`, `allo-call` et `allo-sms` pour filtrer les tickets Allo dans vos vues et règles de workflow Zoho Desk.

## Comment les SMS sont synchronisés

Après chaque SMS envoyé ou reçu sur une ligne support, Allo crée un ticket Zoho Desk pour le contact correspondant, ou ajoute le SMS au ticket Allo récent du contact. Le ticket a le canal **Phone** (Zoho Desk n'a pas de canal SMS pour les autres applications), les tags `allo` et `allo-sms`, et un objet comme `Allo Inbound SMS to US Support (+18885550100) - Leo`.

Le SMS est enregistré dans un commentaire privé qui contient :

- Le sens du SMS, l'heure d'envoi (UTC), 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

Le ticket est **Open**, pour les SMS entrants et sortants. Aucun SMS n'est envoyé à votre client depuis Zoho Desk.

## 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 **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 Zoho échoue, vérifiez ces causes :

    - **La région est incorrecte.** Choisissez la région qui correspond à l'adresse de votre Zoho Desk (voir [Trouvez votre région Zoho](#trouvez-votre-région-zoho)). Un compte Europe ne peut pas se connecter par la région États-Unis, et inversement.
    - **Votre utilisateur Zoho n'a pas accès à Zoho Desk.** Connectez-vous avec un utilisateur qui est agent du portail Zoho Desk à connecter.
    - **Trop d'applications connectées.** Zoho limite le nombre de connexions actives par application et par utilisateur. Si vous avez connecté et déconnecté Allo de nombreuses fois, supprimez les anciennes entrées Allo dans **Connected Apps** des paramètres de votre compte Zoho, puis reconnectez-vous.
  </Accordion>

  <Accordion title="Un appel ou SMS n'est pas synchronisé dans Zoho Desk">
    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 à Zoho Desk. Vérifiez **Paramètres** \> **Intégrations** \> **Zoho Desk** \> **Lignes support**, ou choisissez **Toutes les lignes** pour tout envoyer.
    - **Le contact n'est pas un contact Zoho Desk.** Avec **Créer les appelants inconnus dans Zoho Desk** désactivé, les appels et SMS des numéros inconnus ne sont pas envoyés. Ajoutez le numéro au contact Zoho Desk, ou activez le paramètre.
    - **Le numéro est dans un champ personnalisé.** Allo cherche uniquement dans les champs **Phone** et **Mobile**.
    - **Le département choisi a été désactivé ou supprimé.** Choisissez un autre département dans **Paramètres** \> **Intégrations** \> **Zoho Desk**, ou revenez au **Département par défaut**.
    - **Vos crédits API Zoho Desk sont épuisés.** Zoho Desk limite les appels API par jour pour tout le portail, et l'édition Free et l'essai ont le plus petit budget. Enregistrer un appel utilise environ 10 à 15 crédits. Quand le budget du jour est épuisé, les appels et SMS ne sont pas synchronisés avant le lendemain : synchronisez-les à nouveau depuis la liste des appels.
  </Accordion>

  <Accordion title="Un contact Zoho Desk n'apparaît pas dans Allo">
    Vérifiez ces causes :

    - **Le contact n'a pas de numéro de téléphone ou de mobile dans Zoho Desk.** Allo n'importe que les contacts avec un numéro. Ajoutez le numéro dans Zoho Desk ; Allo importe le contact à la synchronisation horaire suivante.
    - **La synchronisation n'a pas encore eu lieu.** Allo vérifie Zoho Desk toutes les heures. Un contact créé ou modifié dans Zoho Desk apparaît dans Allo après la synchronisation suivante.
    - **Le premier import est encore en cours.** Sur un grand portail Zoho Desk, le premier import peut prendre du temps. L'intégration affiche l'import en cours jusqu'à la fin.
  </Accordion>

  <Accordion title="Contacts en double">
    Avec **Créer les appelants inconnus dans Zoho Desk** activé, Allo cherche d'abord un contact Zoho Desk existant par e-mail, puis par numéro de téléphone, et ne crée un contact que s'il n'en trouve aucun. Un doublon apparaît quand la même personne est enregistrée dans Zoho Desk avec un autre e-mail et un numéro dans un champ de téléphone personnalisé. Fusionnez les contacts dans Zoho Desk.
  </Accordion>

  <Accordion title="Les appels apparaissent en commentaires privés, pas en fiches d'appel">
    Votre édition Zoho Desk n'a pas de fiches d'appel (Free, Express et Standard). Allo ajoute alors les appels en commentaires privés. Passez à Professional ou Enterprise pour avoir les fiches d'appel ; les nouveaux appels les utilisent alors automatiquement.
  </Accordion>

  <Accordion title="Un appel ou SMS de suivi a ouvert un nouveau ticket">
    Un appel ou SMS de suivi rejoint un ticket existant seulement quand toutes ces conditions sont vraies :

    - Le ticket a été créé par Allo, a le canal **Phone** et un objet qui commence par `Allo`.
    - Le ticket est Open ou On Hold, pas Closed.
    - Le ticket est dans le département utilisé par Allo.
    - Le ticket a été mis à jour moins d'une heure avant le nouvel appel ou SMS.

    Si l'une de ces conditions est fausse, Allo ouvre un nouveau ticket.
  </Accordion>

  <Accordion title="Mon client a reçu un e-mail à propos d'un ticket Allo">
    Allo écrit les détails des appels dans des fiches d'appel et des commentaires privés, qui ne sont jamais envoyés par e-mail. Un e-mail vient de votre propre configuration Zoho Desk. Vérifiez :

    - **Les règles de workflow et de notification** dans **Setup** \> **Automation** qui envoient un e-mail sur les nouveaux tickets. Excluez les tickets avec le tag `allo`.
    - **L'e-mail d'accusé de réception** du département, s'il est configuré pour répondre à chaque nouveau ticket.
  </Accordion>

  <Accordion title="Le ticket n'est pas attribué">
    Allo attribue le ticket à l'agent Zoho Desk dont l'e-mail correspond à celui de l'utilisateur Allo. Si les e-mails sont différents, le ticket reste non attribué. Utilisez le même e-mail dans Allo et Zoho Desk, ou attribuez les tickets Allo avec une règle d'attribution Zoho Desk sur le tag `allo-call` ou `allo-sms`.
  </Accordion>
</AccordionGroup>
