Un guide pratique de l'API Freshdesk v2

Si vous gérez une équipe de support sur Freshdesk, vous êtes probablement toujours à la recherche de moyens pour rendre les choses un peu plus fluides. Vous avez sans doute entendu parler de l'API Freshdesk v2, un outil qui permet de créer des flux de travail personnalisés, des applications connectées et une dose massive d'automatisation. Mais qu'est-ce que cela signifie réellement pour vous, la personne qui gère l'équipe ?

Ce guide est destiné aux décideurs, pas aux développeurs. Nous allons laisser de côté le code dense pour nous concentrer sur ce que vous pouvez réellement accomplir avec l'API, ce dont vous avez besoin pour commencer et certains détails importants à garder à l'esprit. Nous examinerons également une voie rapide pour obtenir des résultats puissants en utilisant des outils complémentaires qui fonctionnent directement au sein de l'écosystème Freshdesk.

Qu'est-ce que l'API Freshdesk v2 ?

Considérez une API (Application Programming Interface ou interface de programmation d'application) comme un traducteur universel qui permet à différents programmes informatiques de discuter entre eux. L'API Freshdesk v2 est un ensemble spécifique de règles qui permet à d'autres applications d'interagir en toute sécurité avec vos données Freshdesk. Il s'agit d'une version moderne et fiable construite sur un standard appelé REST, ce qui signifie que la plupart des développeurs savent déjà comment travailler avec.

Essentiellement, elle vous permet, à vous ou à votre équipe, d'écrire des scripts qui effectuent des actions automatiquement à l'intérieur de Freshdesk. Ces actions sont réalisées sur le web à l'aide de quelques commandes de base :

• GET : Pour récupérer des informations (comme consulter les détails d'un ticket).

• POST : Pour créer quelque chose de nouveau (comme générer un nouveau ticket à partir d'un formulaire de site web).

• PUT : Pour mettre à jour quelque chose qui existe déjà (comme modifier la priorité d'un ticket).

• DELETE : Pour supprimer quelque chose (comme effacer un ticket de spam).

Cela ouvre la porte à la création d'outils personnalisés capables de rationaliser votre processus de support, de synchroniser les données clients avec votre CRM ou même de générer des rapports détaillés adaptés aux besoins spécifiques de votre entreprise.

Démarrer avec l'API Freshdesk v2

Avant de pouvoir faire quoi que ce soit avec l'API, vous devez vérifier vos permissions. C'est ce qu'on appelle l'authentification, et c'est ainsi que Freshdesk s'assure que seules les personnes ou applications autorisées peuvent accéder aux données de votre service d'assistance.

Trouver votre clé API Freshdesk v2

Votre clé API est un code unique qui fonctionne comme un mot de passe spécial pour vos automatisations. Voici où la trouver :

1. Connectez-vous à votre compte Freshdesk.

2. Cliquez sur votre photo de profil en haut à droite et sélectionnez Paramètres du profil.

3. Vous verrez votre clé API sur le côté droit de la page.

Traitez cette clé comme vous le feriez pour n'importe quel mot de passe. Elle offre un accès sécurisé à votre compte Freshdesk via l'API.

Comprendre l'authentification et les permissions de l'API Freshdesk v2

Pour utiliser la clé, il vous suffit de l'inclure dans l'en-tête de toute requête API. Les permissions de la clé sont directement liées à l'utilisateur auquel elle appartient.

Ainsi, si vous utilisez la clé API d'un agent et que son rôle ne lui permet pas de supprimer des tickets, tout script API utilisant cette clé sera également empêché de supprimer des tickets. C'est une fonctionnalité de sécurité pratique qui garantit que vos automatisations respectent les règles établies de votre service d'assistance.

Fonctionnalités clés de l'API Freshdesk v2

L'API vous donne le contrôle sur presque chaque élément de votre service d'assistance. Bien que la documentation API complète soit très exhaustive, la plupart des utilisations se classent dans trois grandes catégories.

Gestion des tickets et des conversations

C'est, de loin, l'une des utilisations les plus courantes de l'API. Vous pouvez créer des flux de travail personnalisés qui complètent les règles intégrées de Freshdesk.

• Créer des tickets automatiquement : Vous pouvez configurer le système pour qu'un ticket Freshdesk soit instantanément créé à partir d'une source externe, comme un formulaire « Contactez-nous » sur votre site web ou une alerte de votre outil de surveillance de serveur.

• Mettre à jour des tickets depuis d'autres applications : Modifiez le statut, la priorité ou l'attribution d'un agent en fonction de déclencheurs provenant d'autres systèmes. Par exemple, vous pourriez automatiquement augmenter la priorité d'un ticket si votre CRM indique que ce client vient de devenir un VIP.

• Lister et filtrer les tickets pour des vues personnalisées : Extrayez des listes de tickets correspondant à des critères très spécifiques pour alimenter des tableaux de bord personnalisés ou des rapports spécialisés.

• Ajouter des notes et des réponses par programmation : Ajoutez automatiquement des notes privées avec un contexte supplémentaire pour vos agents ou envoyez même des réponses publiques basées sur certains déclencheurs.

Automatisation de la gestion des contacts et des entreprises

Vous pouvez utiliser l'API pour maintenir vos informations clients parfaitement synchronisées entre Freshdesk et d'autres outils, tels que votre CRM ou votre système de facturation.

• Créer ou mettre à jour des contacts : Lorsqu'un nouvel utilisateur s'inscrit à votre produit, un script peut automatiquement créer son profil de contact dans Freshdesk, garantissant que vos dossiers sont toujours à jour.

• Gérer les entreprises : Liez les contacts à leurs entreprises respectives et maintenez à jour les détails au niveau de l'entreprise, comme les forfaits d'abonnement.

• Synchroniser vos données : Assurez-vous que lorsqu'une information client change à un endroit, elle est mise à jour partout. Cela donne à vos agents le contexte complet et correct à chaque fois.

Intégration de votre base de connaissances

L'API n'est pas seulement destinée aux tickets ; elle peut également gérer vos articles d'aide dans Freshdesk. C'est très utile si vous souhaitez rationaliser vos opérations de contenu.

• Créer ou mettre à jour des articles : Imaginez un flux de travail où la mise à jour d'un document interne dans Confluence ou Google Docs déclenche automatiquement une mise à jour de l'article correspondant dans le centre d'aide public.

• Lister les articles et les dossiers : Vous pouvez extraire le contenu de votre base de connaissances pour l'afficher ailleurs, par exemple à l'intérieur de votre propre application, pour une expérience plus unifiée.

Défis et limites courants de l'API Freshdesk v2

Bien que l'API soit puissante, son utilisation directe implique certaines considérations techniques importantes pour la planification de vos ressources.

Naviguer dans les limites de débit de l'API Freshdesk v2

Freshdesk utilise des limites de débit (rate limits) pour garantir la stabilité et les performances de la plateforme pour tous les utilisateurs. La limite dépend de votre forfait d'abonnement. Par exemple, le forfait Growth autorise 200 appels par minute, tandis que le forfait Enterprise en autorise 700.

Forfait	Limite de débit API (par minute)
Growth	200
Pro	400
Enterprise	700

Source : Documentation API Freshdesk

Si vous atteignez votre limite, Freshdesk gère temporairement le volume de requêtes pour maintenir la santé du système. Pour une équipe de support occupée, cela signifie simplement que vos développeurs devront tenir compte de ces paliers lors de la création de vos scripts personnalisés.

Le besoin de ressources de développement

L'utilisation directe de l'API est une tâche technique. Elle nécessite généralement qu'un développeur :

• Écrive le code : Quelqu'un construit et teste les scripts qui interagissent avec l'API.

• Héberge le code : Ces scripts s'exécutent sur un serveur pour rester connectés.

• Le maintienne : À mesure que votre entreprise évolue, votre code personnalisé peut nécessiter des mises à jour pour rester aligné avec vos derniers flux de travail.

C'est une partie standard de la création de toute intégration personnalisée et c'est un excellent moyen d'obtenir exactement la fonctionnalité dont vous avez besoin.

Complexité dans la récupération du contexte complet

L'API Freshdesk est incroyablement détaillée, et parfois, obtenir les données exactes que vous souhaitez nécessite de connaître des paramètres spécifiques. Par exemple, si vous recherchez des statistiques de ticket spécifiques comme le « Temps de première réponse », vous devez simplement vous rappeler d'inclure le paramètre include=stats dans votre requête. Les forums de la communauté Freshdesk et la documentation sont d'excellentes ressources pour trouver ces conseils utiles.

Une méthode plus rapide pour automatiser Freshdesk avec l'IA

Si vous souhaitez bénéficier rapidement des avantages de l'automatisation, il existe des outils spécialisés qui fonctionnent aux côtés de Freshdesk pour améliorer votre flux de travail. Les plateformes d'IA modernes pour l'automatisation du support client peuvent vous aider à obtenir ces résultats sans repartir de zéro.

Par exemple, eesel AI est une option qui fonctionne au sein de l'écosystème Freshdesk grâce à une intégration Freshdesk transparente.

Soyez opérationnel en quelques minutes

Au lieu d'un projet de codage personnalisé, vous pouvez connecter des outils comme eesel AI à votre compte Freshdesk très rapidement. Ces types d'intégrations sont souvent en libre-service, vous permettant de commencer à automatiser des parties de votre flux de travail en quelques minutes seulement.

Créez des flux de travail sans écrire de code

Avec des options comme l'Agent IA d'eesel, vous pouvez configurer des automatisations à l'aide d'un constructeur visuel. Vous pouvez définir comment l'IA aide au marquage (tagging) ou aux changements de statut, tout en travaillant dans les paramètres que vous avez définis pour votre instance Freshdesk.

Unifiez toutes vos sources de connaissances instantanément

Alors qu'une intégration API se concentre sur les données à l'intérieur de Freshdesk, les outils complémentaires peuvent également se connecter à d'autres sources comme Confluence, Google Docs ou Slack. Cela donne à votre écosystème de support une base de connaissances plus large dans laquelle puiser, aidant à fournir des réponses complètes à vos clients.

Dernières réflexions sur l'API Freshdesk v2

L'API Freshdesk v2 est un outil puissant et fiable pour toute équipe cherchant à personnaliser son service d'assistance. Elle offre un contrôle approfondi sur vos tickets, contacts et base de connaissances, ce qui en fait un standard d'excellence pour la création de flux de travail de classe entreprise sur mesure.

Créer des intégrations personnalisées directement avec l'API est un choix solide lorsque vous disposez de ressources de développement spécifiques pour les maintenir. Pour les équipes à la recherche d'une approche plus immédiate ou sans code, la place de marché et l'écosystème Freshdesk proposent de nombreux outils complémentaires.

Des plateformes comme eesel AI constituent un excellent complément qui se superpose directement à Freshdesk. Elles vous permettent de connecter vos connaissances et de créer des flux de travail intelligents rapidement, vous aidant à détourner les tickets (ticket deflection) efficacement et donnant à vos agents plus de temps pour se concentrer sur les besoins complexes des clients.

Prêt à voir comment vous pouvez améliorer votre flux de travail Freshdesk en 2026 ?

Commencez votre essai gratuit avec eesel AI ou réservez une démo pour le voir en action.