> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Freshdesk Grâce à un [outil webhook](/docs/fr/reception-ai/integrations/webhooks), 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](#look-up-tickets-with-the-mcp-server) 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é : ```bash printf 'YOUR_API_KEY:X' | base64 ``` La valeur de l'en-tête est `Basic ` suivi du résultat. > **Warning** > > 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](/docs/fr/reception-ai/receptionist/testing) 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](/docs/fr/reception-ai/integrations/mcp-server) 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`. |