> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Freshservice

> Enregistrez chaque appel et SMS Allo dans Freshservice comme note privée sur un ticket Téléphone du demandeur correspondant, et synchronisez vos demandeurs et départements Freshservice dans Allo

L'intégration Freshservice enregistre chaque appel et SMS Allo sur un ticket Freshservice de l'appelant, un **Incident** avec la source **Phone**. Les détails de l'appel, le résumé IA, la transcription et un lien vers l'enregistrement sont dans une note privée, visible uniquement par vos agents. Un appel et les SMS qui l'entourent restent dans le même ticket.

Vos demandeurs (requesters) et départements Freshservice sont synchronisés dans Allo, modifications comprises : vos appelants apparaissent avec leur nom et leur département Freshservice.

## Comment connecter

L'intégration Freshservice se connecte avec votre domaine Freshservice et une clé API Freshservice. Il faut être administrateur ou manager Allo pour connecter l'intégration.

> [!NOTE]
>
> L'API Freshservice est disponible sur tous les abonnements Freshservice payants (Starter, Growth, Pro et Enterprise) et pendant l'essai Freshservice. Freshservice n'a pas d'abonnement gratuit.

### Comment obtenir votre clé API Freshservice

La clé API appartient à un agent Freshservice. Allo écrit les tickets et les notes avec cette clé API, et le rôle de l'agent définit ce qu'Allo peut faire : ce rôle doit permettre de voir et de créer des tickets, et de voir les demandeurs.

**1. Ouvrir les paramètres du profil**

Dans Freshservice, cliquez sur votre photo de profil en haut à droite, puis sur **Profile settings**.

**2. Trouver Your API Key**

La section **Your API Key** est dans la colonne de droite des paramètres du profil.

**3. Copier la clé API**

Copiez la clé API. Vous collez la clé API dans Allo à l'étape suivante.

> [!WARNING]
>
> Si la section **Your API Key** affiche « Your API key is disabled. Please contact your admin to enable it », votre agent ne peut pas encore utiliser l'API. Demandez à l'administrateur de votre compte Freshservice d'activer la clé API pour votre agent, puis copiez à nouveau la clé API depuis **Profile settings**. Allo ne peut pas activer la clé API à votre place.

> [!TIP]
>
> Un administrateur Freshservice peut aussi créer un utilisateur d'intégration nommé « Allo » et utiliser sa clé API plutôt qu'une clé personnelle : la connexion ne dépend alors pas d'un seul agent. Les utilisateurs d'intégration se créent dans **Global Settings** > **User Management** > **Integration Users** et ont besoin d'un rôle qui permet de voir et de créer des tickets, et de voir les demandeurs. Freshservice for MSPs n'a pas d'utilisateurs d'intégration : utilisez la clé API d'un agent.

Votre domaine Freshservice est la partie avant `.freshservice.com` dans l'adresse de votre service desk. Pour `votreentreprise.freshservice.com`, le domaine est `votreentreprise`. Utilisez l'adresse `freshservice.com` même si votre portail utilise un domaine personnalisé : l'API Freshservice ne répond que sur `freshservice.com`.

### Connecter dans Allo

**1. Aller dans les intégrations**

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

**2. Trouver Freshservice**

Trouvez **Freshservice** dans la section **Support** et cliquez sur **Connecter**.

**3. Saisir le domaine et la clé API**

Saisissez votre domaine Freshservice dans le champ **Domaine Freshservice** et collez la clé API dans le champ **Clé API**.

**4. Enregistrer et connecter**

Cliquez sur **Enregistrer et Connecter**. Allo vérifie la clé API auprès de Freshservice et connecte l'intégration.

**5. Attendre l'import des contacts**

Allo importe vos demandeurs et départements Freshservice. 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éfinissent quelles lignes Allo envoient leurs appels et SMS à Freshservice. 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 donc jamais dans votre service desk.

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

Pour choisir vos lignes support, allez dans **Paramètres** > **Intégrations** > **Freshservice**, 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 auquel il a écrit. Pour un appel ou un 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 Freshservice.

### Créer les appelants inconnus dans Freshservice (facultatif)

Le réglage **Créer les appelants inconnus dans Freshservice** définit ce qui se passe quand l'appelant ou l'expéditeur du SMS n'est pas encore un demandeur Freshservice.

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

Le réglage est désactivé par défaut.

> [!NOTE]
>
> Sur Freshservice for MSPs, un demandeur doit avoir un e-mail. Allo ne peut pas créer un appelant inconnu qui n'a pas d'e-mail dans Allo : cet appel ou ce SMS n'est alors pas envoyé à Freshservice.

## Ce qui est synchronisé

**De Freshservice vers Allo :**

* Les demandeurs qui ont un numéro de téléphone professionnel ou mobile, avec leur nom, e-mail principal, numéros professionnel et mobile, poste et nom de département
* Les départements, avec leur nom, site web (à partir du premier domaine) et description

**D'Allo vers Freshservice :**

* Les appels et SMS, enregistrés comme notes privées sur des tickets Téléphone du demandeur Freshservice correspondant
* Les nouveaux demandeurs, quand **Créer les appelants inconnus dans Freshservice** est activé

**Sens de synchronisation :** bidirectionnel. Les appels et SMS sont envoyés à Freshservice au fil de l'eau. La première synchronisation importe tous vos demandeurs et départements Freshservice. Ensuite, Allo vérifie toutes les heures les demandeurs modifiés dans Freshservice, et relit vos départements.

Un demandeur désactivé dans Freshservice est retiré d'Allo quand la synchronisation horaire voit la modification. Un demandeur dont le dernier numéro de téléphone est retiré dans Freshservice est aussi retiré d'Allo. Les demandeurs sans numéro de téléphone ne sont pas importés, car Allo ne peut pas les associer à un appel ou un SMS. Les agents Freshservice ne sont pas importés comme contacts. Allo ne modifie jamais un demandeur Freshservice existant.

Allo retrouve le demandeur Freshservice par numéro de téléphone, sur les champs **Work phone** et **Mobile phone**. Allo cherche le numéro dans plusieurs formats nationaux et internationaux, comme `+33612345678`, `06 12 34 56 78` ou `(415) 555-1234`. Les champs de téléphone personnalisés ne sont pas vérifiés.

## Comment les appels sont synchronisés

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

* Le type **Incident**, la source **Phone** et la priorité **Low**
* 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)`
* 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 dans une **note privée** du ticket. La note privée 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 est assigné à l'agent Freshservice dont l'e-mail correspond à celui de l'utilisateur Allo, et la note privée est écrite au nom de cet agent. Si aucun agent Freshservice actif n'a cet e-mail, le ticket reste non assigné et la note est écrite au nom du propriétaire de la clé API.

La note privée indique toujours l'heure réelle de début de l'appel.

Allo crée les tickets dans votre espace de travail principal. Sur Freshservice for MSPs, le ticket va au client du demandeur.

### Statut du ticket

Chaque ticket Allo est **Open**, pour les appels répondus comme pour les appels manqués et les messages vocaux : votre équipe voit chaque conversation téléphonique dans sa file. Allo ne résout et ne ferme jamais un ticket : cela reste le rôle de vos agents.

Allo crée chaque ticket en Closed puis l'ouvre aussitôt, pour que Freshservice ne le traite pas comme un nouveau ticket du demandeur. Si votre compte rend certains champs obligatoires pour fermer un ticket, Allo crée directement le ticket en Open. Les notes privées ne sont jamais envoyées par e-mail au demandeur.

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

Les appels et SMS avec un même demandeur partagent un ticket. Un nouvel appel ou SMS rejoint le ticket Allo du demandeur quand ce ticket est Open ou Pending et que sa dernière mise à jour date de moins d'1 heure. Cela vaut quand le client rappelle ou réécrit, comme quand votre équipe le rappelle ou lui répond.

Quand un appel ou un SMS rejoint un ticket existant :

* Allo l'ajoute comme nouvelle note privée.
* Allo renomme le ticket selon ce qu'il contient : `Allo calls with <nom du demandeur> 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` au ticket s'il ne le porte pas encore. Les tags déjà présents sur le ticket sont conservés.
* La fenêtre d'1 heure repart de cet appel ou SMS.

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

> [!WARNING]
>
> Ne supprimez pas les tags `allo-call` et `allo-sms` des tickets Allo. Sans eux, chaque appel et SMS ouvre un nouveau ticket.

Utilisez les tags `allo`, `allo-call` et `allo-sms` pour filtrer les tickets Allo dans les vues et les workflows Freshservice.

## Comment les SMS sont synchronisés

Après chaque SMS envoyé ou reçu sur une ligne support, Allo crée un ticket Freshservice pour le demandeur correspondant, ou ajoute le SMS au ticket Allo récent du demandeur. Le ticket est un **Incident** avec la source **Phone** (Freshservice n'a pas de source SMS), les tags `allo` et `allo-sms`, et un titre comme `Allo Inbound SMS to US Support (+18885550100) - Leo`.

Le SMS est dans une note privée 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 comme sortants. Aucun SMS n'est envoyé à votre client depuis Freshservice.

## 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 affiche un indicateur d'intégration avec son état de synchronisation.

> [accordion] 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 Freshservice, vérifiez ces causes :
>
> * **La clé API est désactivée pour votre agent.** Freshservice affiche « Your API key is disabled. Please contact your admin to enable it » dans **Profile settings**. Demandez à l'administrateur de votre compte Freshservice d'activer la clé API, puis copiez-la à nouveau.
> * **Le domaine est incorrect.** Saisissez seulement la partie avant `.freshservice.com`, par exemple `votreentreprise`, et non le domaine personnalisé de votre portail.
> * **La clé API a été régénérée.** Une nouvelle clé API remplace l'ancienne. Copiez la clé API actuelle depuis **Profile settings** > **Your API Key**.

> [accordion] Appel ou SMS non synchronisé dans Freshservice
>
> 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 à Freshservice. Vérifiez **Paramètres** > **Intégrations** > **Freshservice** > **Lignes support**, ou choisissez **Toutes les lignes** pour tout envoyer.
> * **L'appelant n'est pas un demandeur Freshservice.** Quand **Créer les appelants inconnus dans Freshservice** est désactivé, les appels et SMS des numéros inconnus ne sont pas envoyés. Ajoutez le numéro au demandeur Freshservice, ou activez le réglage.
> * **L'appelant est un agent Freshservice.** Allo ne compare que les demandeurs. L'appel d'un numéro d'agent est traité comme celui d'un appelant inconnu.
> * **Le numéro est dans un champ personnalisé.** Allo ne compare que les champs **Work phone** et **Mobile phone**.
> * **Le rôle de la clé API est trop limité.** Freshservice refuse les requêtes que le rôle n'autorise pas. Donnez à l'agent ou à l'utilisateur d'intégration un rôle qui permet de voir et de créer des tickets, et de voir les demandeurs.
> * **La clé API ne fonctionne plus.** Si la clé API a été désactivée ou régénérée, Allo semble toujours connecté mais les requêtes échouent. Déconnectez Freshservice dans Allo et reconnectez-le avec la clé API actuelle.
> * **Les limites de débit Freshservice.** Freshservice limite le nombre d'appels API par minute pour tout le compte (100 par minute sur Starter). Nango réessaie plusieurs fois les requêtes limitées. Si la limite est toujours atteinte, l'appel ou le SMS n'est pas synchronisé : attendez une minute et synchronisez-le à nouveau depuis la liste des appels.

> [accordion] Un demandeur Freshservice n'apparaît pas dans Allo
>
> Vérifiez ces causes :
>
> * **Le demandeur n'a pas de numéro professionnel ou mobile dans Freshservice.** Allo n'importe que les demandeurs qui ont un numéro de téléphone. Ajoutez le numéro dans Freshservice : Allo importe le demandeur à la synchronisation horaire suivante.
> * **La synchronisation n'est pas encore passée.** Allo vérifie Freshservice toutes les heures. Un demandeur créé ou modifié dans Freshservice apparaît dans Allo après la synchronisation suivante.
> * **Le premier import est encore en cours.** Sur un grand compte Freshservice, le premier import peut prendre plusieurs minutes. L'intégration affiche l'import en cours jusqu'à sa fin.

> [accordion] Demandeurs en double
>
> Quand **Créer les appelants inconnus dans Freshservice** est activé, Allo cherche d'abord un demandeur Freshservice existant par e-mail, puis par numéro de téléphone, et ne crée un demandeur que s'il n'en trouve aucun. Un doublon apparaît quand la même personne est enregistrée dans Freshservice avec un autre e-mail et un numéro dans un champ de téléphone personnalisé. Fusionnez les demandeurs dans Freshservice.

> [accordion] Un rappel ou un SMS a ouvert un nouveau ticket
>
> Un rappel ou un SMS rejoint un ticket existant seulement quand les trois conditions sont réunies :
>
> * Le ticket a été créé par Allo et porte toujours le tag `allo-call` ou `allo-sms`.
> * Le ticket est Open ou Pending, pas Resolved ni Closed.
> * La dernière mise à jour du ticket date de moins d'1 heure avant le nouvel appel ou SMS.
>
> Si une de ces conditions manque, Allo ouvre un nouveau ticket.

> [accordion] Mon demandeur a reçu un e-mail pour un ticket Allo
>
> Les notes privées ne sont jamais envoyées par e-mail. Un e-mail pour un ticket Allo vient de vos réglages de notification ou de vos workflows Freshservice. Vérifiez :
>
> * Les **workflows** du Workflow Automator qui envoient un e-mail sur les tickets créés ou modifiés. Excluez les tickets avec le tag `allo`.
> * Les **notifications au demandeur** dans vos réglages de notification par e-mail Freshservice, comme les notifications de ticket créé, rouvert ou fermé.

> [accordion] Le ticket n'est pas assigné
>
> Allo assigne le ticket à l'agent Freshservice dont l'e-mail correspond à celui de l'utilisateur Allo. Si les e-mails diffèrent, ou si l'agent est désactivé, le ticket reste non assigné. Utilisez le même e-mail dans Allo et Freshservice, ou assignez les tickets Allo avec un workflow Freshservice sur le tag `allo-call` ou `allo-sms`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.