Freshdesk | ElevenLabs Documentation

Grâce à un outil webhook, votre réceptionniste peut ouvrir un ticket Freshdesk lorsqu’un appelant signale un problème ou demande de l’aide, afin que votre équipe puisse le traiter. Avec les forfaits Growth, Pro et Enterprise, vous pouvez également connecter le serveur MCP de Freshdesk pour rechercher des tickets existants.

Créer des tickets

Obtenir votre clé API

Dans Freshdesk, sélectionnez votre photo de profil, ouvrez Paramètres du profil, puis sélectionnez Afficher la clé API. Copiez la clé. Elle sert de compte à votre agent, les tickets sont donc créés avec vos autorisations.

Créer l’en-tête d’autorisation

Freshdesk utilise la clé API comme nom d’utilisateur et X comme mot de passe. Encodez-la dans un terminal en remplaçant YOUR_API_KEY par votre clé :

printf 'YOUR_API_KEY:X' | base64

La valeur de l’en-tête est Basic suivi du résultat.

Ne collez pas votre clé API dans un encodeur en ligne. Toute personne disposant de la clé ou de l’en-tête encodé peut lire et modifier vos tickets.

Créer l’outil webhook

Accédez à Intégrations, sélectionnez Ajouter une intégration, puis choisissez Outil webhook.

Champ	Valeur
Nom	`create_freshdesk_ticket`
Description	”Ouvrir un ticket d’assistance lorsqu’un appelant signale un problème ou a besoin de l’aide de l’équipe.”
Méthode	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
En-têtes de requête	`Authorization` : `Basic` suivi de la clé encodée
Paramètres du corps	`name` (chaîne, requis) : “Le nom complet de l’appelant.” `phone` (chaîne) : “Le numéro de téléphone de l’appelant.” `email` (chaîne) : “L’adresse email de l’appelant, s’il l’a fournie.” `subject` (chaîne, requis) : “Un bref résumé du problème.” `description` (chaîne, requis) : “Ce que l’appelant a signalé, avec ses propres mots et tous les détails fournis.” `status` (nombre, requis) : “Toujours la valeur exacte `2`.” `priority` (nombre, requis) : “Toujours la valeur exacte `1`.” `source` (nombre, requis) : “Toujours la valeur exacte `3`.”
Attribuer aux agents	Réceptionniste

Remplacez YOURDOMAIN par votre sous-domaine Freshdesk. Sélectionnez Activer.

Le tester

Testez votre réceptionniste en signalant un problème. Le ticket apparaît dans Freshdesk.

Les valeurs fixes créent le ticket avec le statut Ouvert (statut 2), la priorité Faible (priorité 1) et l’indiquent comme provenant du Téléphone (source 3). Pour permettre à la réceptionniste de définir la priorité, décrivez plutôt les valeurs, par exemple : “1 pour faible, 2 pour moyenne, 3 pour élevée, 4 pour urgente.”

Freshdesk a besoin d’un numéro de téléphone ou d’une adresse email pour trouver ou créer le demandeur. Demandez à votre réceptionniste de toujours recueillir le numéro de téléphone de l’appelant.

Rechercher des tickets avec le serveur MCP

Le serveur MCP de Freshdesk est disponible avec les forfaits Growth, Pro et Enterprise. Il permet à votre réceptionniste de rechercher les tickets existants d’un appelant. Les actions MCP sont décomptées d’une allocation annuelle qui dépend de votre forfait.

Dans Reception.ai, accédez à Intégrations, sélectionnez Ajouter une intégration, puis choisissez Serveur MCP.

Champ	Valeur
Nom	Freshdesk
Type de serveur	HTTP diffusé
URL du serveur	`https://YOURDOMAIN.freshdesk.com/mcp`
En-têtes HTTP	`Authorization` : votre clé API, sans préfixe

Laissez Jeton secret vide, afin que Reception.ai envoie votre en-tête Authorization exactement tel qu’il a été saisi. Utilisez votre sous-domaine freshdesk.com, même si vous avez un domaine personnalisé. Sélectionnez Activer.

Ouvrez l’onglet Outils et attribuez les outils de recherche de tickets, tels que fetchSearchTickets et fetchTicket, au Client (réceptionniste). Ne laissez attribués aucun outil qui met à jour des tickets, des agents, des groupes ou des articles.

Résolution des problèmes

Problème	Vérification à effectuer
Erreur 401 de Freshdesk	Encodez la clé avec `:X` à la suite, puis commencez la valeur de l’en-tête par `Basic` et une espace.
Erreur 400 concernant le demandeur	Le ticket nécessite un numéro de téléphone ou une adresse email, ainsi que le nom. Assurez-vous que la réceptionniste les recueille.
Erreur 400 concernant le statut ou la priorité	`status`, `priority` et `source` doivent être des paramètres numériques, et non des chaînes.
Le serveur MCP ne répertorie aucun outil	Utilisez votre sous-domaine `freshdesk.com` et placez la clé API brute dans l’en-tête `Authorization`, sans `Basic` ni `Bearer`.