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.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.Ouvrir les paramètres du profil
Trouver Your API Key
Copier la clé API
.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
Aller dans les intégrations
Trouver Freshservice
Saisir le domaine et la clé API
Enregistrer et connecter
Attendre l'import des contacts
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.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.
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
- 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é
+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
alloetallo-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)
- 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
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 …ouAllo calls and SMS with …. - Allo ajoute le tag
allo-callouallo-smsau 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.
allo-call ou allo-sms. Allo ne les ajoute jamais à un ticket venu d’un autre canal, comme un e-mail.
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 tagsallo 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
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. Chaque appel affiche un indicateur d’intégration avec son état de synchronisation.Je n'arrive pas à connecter mon intégration
Je n'arrive pas à connecter mon intégration
- 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 exemplevotreentreprise, 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.
Appel ou SMS non synchronisé dans Freshservice
Appel ou SMS non synchronisé dans Freshservice
- 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.
Un demandeur Freshservice n'apparaît pas dans Allo
Un demandeur Freshservice n'apparaît pas dans Allo
- 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.
Demandeurs en double
Demandeurs en double
Un rappel ou un SMS a ouvert un nouveau ticket
Un rappel ou un SMS a ouvert un nouveau ticket
- Le ticket a été créé par Allo et porte toujours le tag
allo-callouallo-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.
Mon demandeur a reçu un e-mail pour un ticket Allo
Mon demandeur a reçu un e-mail pour un ticket Allo
- 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é.
Le ticket n'est pas assigné
Le ticket n'est pas assigné
allo-call ou allo-sms.