Freddy AI Agent custom functions : configuration, forfaits, facturation
Kira
Katelin Teen
Dernière modification 12 novembre 2026

Les custom functions de Freddy AI Agent sont des extraits JavaScript qui remodèlent les données entre les étapes d'un workflow, pas un moyen d'appeler des systèmes externes. Freshworks les associe à Freshdesk Omni sur Growth, Pro et Enterprise, sans ligne de prix séparée sur la page de prix ; tu paies tout de même par session à $49 pour 100, après 500 incluses une fois par compte. Pour des recherches en direct, il faut d'abord une action API. Si tu préfères décrire la tâche plutôt que dessiner le workflow, eesel se connecte à Freshdesk et atteint tes propres API sans qu'il faille écrire une fonction. La CLI eesel permet à un agent de code de la configurer et de tester les réponses avant.
Que sont les custom functions de Freddy AI Agent ?
Les custom functions de Freddy AI Agent sont des extraits JavaScript réutilisables qui prennent des entrées, exécutent ta logique et renvoient un objet JSON que les blocs de workflow suivants peuvent lire. Freshworks les décrit comme un moyen de transformer et traiter les données, par exemple pour extraire une date de livraison d'une réponse complète de commande ou décider si une commande est encore dans la fenêtre de retour.

La bibliothèque de functions se trouve sous AI Agent Studio > Library > Functions. Elle a deux onglets : des functions prêtes à l'emploi pour les dates, le texte, les listes, l'arithmétique et le Base64, et My functions pour celles que tu écris. La capture d'écran ci-dessus, tirée du propre guide des functions de Freshworks, est la page où tu vivras.
Voici la partie facile à manquer. Une function ne parle jamais à ton système de commandes. J'ai lu tous les articles que Freshworks a publiés sur le sujet, et chacun décrit les functions comme de la transformation de données à l'intérieur du workflow. L'appel vers l'extérieur est un bloc différent, l'action API, et les deux sont enchaînés. La mise à jour produit de Freshworks de septembre liste les custom functions parmi les ajouts à Freddy AI Agent Studio, à côté de déclencheurs de workflow prédéfinis.
| Élément | Ce qu'il fait | Appelle-t-il un système externe ? |
|---|---|---|
| Pre-built function | Étape prête à l'emploi pour date, texte, liste, calcul ou Base64 | Non |
| Custom function | Ton propre JavaScript, renvoie du JSON | Non |
| Action API | Requête REST avec en-têtes, corps et authentification | Oui |
| App AI Actions | Opérations typées construites avec le SDK Freshworks | Oui, si tu codes le callback |
Comment les functions s'articulent-elles avec les actions API dans un workflow ?
Une function se place entre deux blocs qui, eux, parlent à tes systèmes : elle prend ce qu'une action API a renvoyé et donne à l'étape suivante quelque chose sur quoi se brancher. L'exemple de Freshworks lui-même est un workflow de commande où une action API renvoie la commande et les dates de livraison, une function vérifie l'éligibilité et une condition lit isEligibleForReturn.

Le constructeur de workflow montre la même séparation. Quand tu cliques sur l'icône plus, le menu de blocs liste Collect info, API Action, Execute Function, Condition paths, Custom response et Agent handoff comme des choses distinctes.

Les actions API sont la moitié qui coûte du temps de configuration. Tu donnes à chacune une URL, une méthode HTTP (GET, POST, PUT, PATCH ou DELETE), des en-têtes et un choix d'authentification parmi API Key, Bearer Token, Basic Auth ou OAuth 2.0. Les variables de sortie sont mappées avec JSON path, et la sortie d'une action peut alimenter la suivante. L'article sur les actions API de Freshworks note aussi que Ask for confirmation peut être activé pour des étapes à fort impact comme les remboursements.
"Test requests use real values and may affect your external system depending on the endpoint."
Comment crée-t-on une custom function ?
Tu crées une custom function en cinq étapes : la nommer, définir des entrées typées, écrire le code, la tester avec des valeurs d'exemple, et définir les sorties que le workflow peut utiliser. Le guide de création de custom functions de Freshworks détaille tout cela, et il te faut un accès administrateur à AI Agent Studio plus un workflow existant.
- Va dans AI Agent Studio > Library > Functions et clique sur Create.
- Sous General, ajoute un nom et une description.
- Ajoute des entrées. Chacune a un nom, un type texte, nombre, booléen ou liste, et un indicateur Required optionnel.
- Écris la logique dans l'éditeur de code. Elle doit renvoyer un objet JSON valide. Dans l'exemple de Freshworks, le corps de la réponse du workflow est lu depuis
data['Response_body']. - Clique sur Test function, saisis des valeurs d'exemple, exécute-la, puis vérifie la réponse et les journaux de console. Termine avec Define outputs et Create.

L'exemple de la documentation filtre les commandes dont le total_price dépasse un seuil de 160 et renvoie les ID de commande et les noms d'articles. C'est typique de ce à quoi servent ces functions : réduire une grosse réponse d'API aux deux champs dont une phrase destinée au client a besoin.
Freshworks indique dans l'introduction que tu peux écrire ou générer la logique de la function. Les étapes numérotées ne décrivent que l'écriture, donc je n'ai pas pu confirmer à quoi ressemble l'option de génération. Son propre conseil vaut la peine d'être suivi dans tous les cas : tester avec des entrées valides, invalides et vides.
Comment utilise-t-on une function à l'intérieur d'un workflow ?
Tu ajoutes un bloc Execute Function, choisis une function dans My functions ou Pre-built functions, mappes des valeurs du workflow à ses paramètres et, éventuellement, mappes ses sorties sur des propriétés de contact ou de ticket. Le panneau affiche un aperçu des détails de la function avant de valider.

Deux détails du guide de gestion et d'utilisation des functions font gagner du temps de débogage. D'abord, capture les entrées avec un bloc Collect info avant de les mapper, ou mappe-les directement depuis des propriétés de contact ou de ticket, surtout pour l'e-mail ou le téléphone. Ensuite, tu peux cloner une function prête à l'emploi et la modifier, la voie la plus rapide vers ta propre variante.
Voici trois tâches où je préférerais une function à une instruction dans le prompt :
- Fenêtre de retour : calculer les jours depuis la livraison et renvoyer un booléen, pour que la branche de condition soit déterministe.
- Vérifications de promo ou de coupon : comparer la date d'expiration à aujourd'hui avant que l'agent n'affirme qu'un code est valide.
- Réduire une charge utile : renvoyer seulement le numéro de suivi et le statut d'une longue réponse d'expédition.
La liste de functions prêtes à l'emploi de Freshworks couvre déjà les deux premières (Get Days Between, Compare Dates), donc une custom function ne se justifie que lorsque ta règle est spécifique à ton activité.
Quels forfaits incluent les custom functions ?
Les articles sur les functions de Freshworks portent une bannière de forfait pour Freshdesk Omni avec des coches sur Growth, Pro et Enterprise, et la mention "Not available in previous plans." Ils indiquent aussi que si tu t'es inscrit avant décembre 2025, ton expérience Freshdesk Omni peut différer. Les forfaits actuels sur la page de prix sont à $19, $55 et $89 par agent et par mois avec facturation annuelle.
Voir les guides du forfait Growth de Freshdesk et du forfait Pro pour ce que chaque niveau contient par ailleurs, et la comparaison des forfaits Freshdesk pour les voir côte à côte.
Une clôture voisine : la voie développeur pour les opérations personnalisées, les apps AI Actions, ne peut actuellement être publiée que comme app personnalisée, et elle est listée comme indisponible sur Freshdesk Legacy, Freshcaller, Freshsales Classic et Freshservice MSP.
Combien coûtent les custom functions Freddy ?
Freshworks ne liste pas de prix séparé pour les custom functions, donc le compteur que tu surveilleras vraiment est la session AI Agent. La page de prix donne les 500 premières sessions gratuites sur Growth, Pro et Enterprise, une fois par compte, puis $49 pour 100 sessions. Une session e-mail est une fenêtre de 72 heures à partir du premier e-mail du client, quel que soit le nombre de réponses envoyées à l'intérieur.

La même page liste deux autres compteurs d'usage : les tâches d'app connecteur à $80 pour 5 000, et les actions MCP à $15 pour 1 000. Ce que je n'ai pas pu trouver, c'est une déclaration sur le fait qu'une exécution de function, ou une action API à l'intérieur du workflow, fasse augmenter l'un ou l'autre. Traite ça comme une question pour ton contact Freshworks avant de concevoir un workflow à fort volume. Pour le calcul des sessions en pratique, mon arithmétique : une équipe qui a déjà utilisé ses 500 gratuites et qui traite ensuite 2 500 sessions en un trimestre achète 25 lots, soit $1 225. Le guide de consommation des sessions montre quelles conversations comptent, et l'article prix de Freddy AI par agent couvre le côté des postes.
Quelles sont les limites et les pièges ?
Les limites pratiques viennent de la façon dont les functions sont partagées et dont les canaux se comportent, pas d'un quota publié. Je n'ai trouvé aucune limite déclarée de temps d'exécution, de mémoire ou de nombre d'appels pour les functions, donc teste avec des tailles de charge utile réalistes.
- La logique partagée change partout. Freshworks prévient que modifier une action API partagée affecte tous les workflows qui l'utilisent, donc teste d'abord dans un environnement hors production.
- Impossible de supprimer une function en production. Tu ne peux pas supprimer une function utilisée dans un workflow actif.
- Le chat est synchrone. Dans le chat, les blocs d'action API s'exécutent pendant la conversation et le champ de texte reste indisponible jusqu'à ce qu'ils se terminent ; un délai dépassé ou un échec dirige vers le chemin Fallback.
- L'e-mail saute la confirmation. Les blocs de confirmation sont ignorés pour les agents e-mail, donc Freshworks recommande de placer les garde-fous pour les opérations à fort impact au niveau de l'API. Le guide de l'agent IA e-mail Freshdesk couvre ce canal.
- Les règles vont dans le code, pas dans la prose. Une function te donne une vérification déterministe, c'est son véritable atout face à une instruction donnée au modèle.
Là où la documentation de Freshworks se contredit elle-même, voici ce que j'ai trouvé :
- Connexion MCP. L'article sur les workflows dit que la couche MCP "uses OAuth-based authentication". L'article de sécurité MCP dit qu'OAuth n'est actuellement pas pris en charge pour les intégrations MCP de Freshdesk, et l'article de configuration MCP dit que seule l'API key fonctionne. Ces pages décrivent le propre serveur MCP de Freshworks, qui n'est peut-être pas la même chose qu'un serveur MCP que tu relies à l'intérieur d'une action API, donc je traiterais les deux comme non confirmées.
- Période de quota MCP. Le tableau de l'article de configuration donne des actions incluses "per account, annually" (
1 200sur Growth,6 000sur Pro,12 000sur Enterprise), alors que l'article de sécurité parle de quotas mensuels. - Prérequis. L'article sur les actions API dit que ton compte doit être sur Freshdesk Omni "or have AI Agent Studio enabled", alors que la page de prix liste Freddy AI Agent sur les trois forfaits Freshdesk.
- Nombre de functions. La documentation liste
13functions prêtes à l'emploi répartie en cinq groupes, pourtant la capture de la page Functions en montre14dans l'onglet prêtes à l'emploi.
Comment les functions de Freddy se comparent-elles aux appels d'API personnalisés d'eesel ?
Les functions de Freddy te donnent une logique déterministe que tu dessines et codes ; eesel te donne un coéquipier qui décide quand appeler tes API à partir des instructions. Elles résolvent deux moitiés différentes de "mon agent a besoin de données en direct".

Dans eesel, Your APIs permet au coéquipier d'atteindre n'importe quelle API REST. Tu autorises le domaine, tu ajoutes l'en-tête que l'API attend (Bearer, Basic ou une API key), et les identifiants restent dans tes paramètres et ne sont jamais montrés à l'IA. Il peut faire des requêtes GET, POST, PATCH et DELETE. Freshdesk lui-même est une intégration native : avec une connexion complète (sous-domaine plus API key), le coéquipier lit ton centre d'aide, tes réponses prédéfinies et tes anciens tickets, et peut répondre, laisser des notes internes, étiqueter, assigner et clôturer. Chaque action peut être réglée sur activée, demander d'abord ou désactivée, selon le guide des actions et des approbations.
Là où Freddy est meilleur : la vérification de la fenêtre de retour est du code, donc elle se comporte toujours de la même façon, et le workflow visuel rend le chemin auditable. Dans eesel, cette règle vit dans tes instructions, qu'un modèle suit bien mais qui ne sont pas une garantie compilée. Là où eesel est meilleur : il n'y a pas de function à écrire ni à versionner, un seul workspace couvre les tickets et le chat en direct, et un développeur ou un agent de code peut faire tourner toute la configuration depuis un terminal avec la CLI eesel. La page eesel pour Freshdesk sur docs.eesel.ai liste le tableau des actions.
Je construis des intégrations Freshdesk pour eesel depuis des années, et les surprises sont rarement dans les appels API. Une qui nous a coûté des heures : Freshdesk ne déclenche pas ses règles d'automatisation pour les tickets créés par un agent, donc un déclencheur dont tu supposais qu'il réveillerait le coéquipier n'arrive tout simplement jamais. La logique que tu contrôles dans le code ne résout pas ça ; connaître la plateforme, si.
Deux clients montrent le schéma. SamCart fait tourner un agent eesel sur les tickets Freshdesk et un autre sur le chat de son site, les deux répondant à partir d'environ 280 articles du centre d'aide, et l'agent s'efface dès qu'une personne est assignée. Timengo utilise eesel sur Freshdesk pour le support technique en danois, rédigeant des réponses à partir d'environ 5 300 tickets et articles passés, un ingénieur envoyant chacune d'elles. Aucun des deux n'a eu besoin d'une custom function ; le travail était dans la connaissance et les règles de transfert.
Pour la vue d'ensemble, voir Freddy AI contre eesel AI, les alternatives à Freddy AI et les alternatives IA à Freshdesk.
Où aller ensuite avec Freddy et Freshdesk ?
Si tu restes sur Freddy, construis d'abord l'action API, ajoute une function seulement là où une règle doit être du code, et surveille ton nombre de sessions. Trois guides voisins aident ici : les sources de connaissance de Freddy, l'aperçu de l'AI Agent Freshdesk et les actions conversationnelles de Freddy.
Si tu relies Freshdesk à un système de commandes, les articles sur les webhooks Freshdesk et Freshdesk Shopify montrent la plomberie.
Les limites de débit de l'API Freshdesk expliquent ce qui te freine.
Le guide intégration API d'agent IA couvre le schéma en général.
Pour plus de contexte, lis ajouter de l'IA à Freshdesk, puis automatisation Freshdesk et le guide chatbot Freshdesk.
Tu pèses le helpdesk lui-même ? Freshdesk contre Zendesk et le test de Freshdesk sont les points de départ, et Freddy Copilot couvre l'assistant côté agent.
Essaie eesel pour Freshdesk
Si ton objectif est un agent Freshdesk qui répond à partir de ton centre d'aide et de ton propre système de commandes, eesel fonctionne comme un nouveau coéquipier qui rejoint ta file en quelques minutes. Connecte Freshdesk avec un sous-domaine et une API key, commence par des brouillons sous forme de notes internes, et élargis son accès à mesure qu'il gagne ta confiance. Avec la CLI eesel, un agent de code IA peut téléverser des connaissances approuvées comme des articles de solution exportés, ajuster les instructions du coéquipier et poser des questions de test pour vérifier les réponses avant que quoi que ce soit passe en direct, même si une personne avec un accès administrateur continue d'approuver la connexion Freshdesk elle-même. Voir l'intégration Freshdesk ou les prix d'eesel.

Questions fréquentes
Que sont les custom functions de Freddy AI Agent ?
Ce sont des extraits JavaScript que tu écris dans AI Agent Studio : ils prennent des entrées, renvoient un objet JSON et alimentent l'étape suivante du workflow. Ils remodèlent les données, par exemple en transformant deux dates en un indicateur d'éligibilité. Ils n'appellent pas de systèmes externes, ce sont les actions API qui s'en chargent. Le guide des agents Freddy AI couvre le produit dans son ensemble.
Quels forfaits Freshdesk incluent les custom functions de Freddy ?
Les articles d'aide de Freshworks associent les functions à Freshdesk Omni sur Growth, Pro et Enterprise, et précisent qu'elles ne sont pas disponibles sur les forfaits précédents. Si tu t'es inscrit avant décembre 2025, ta configuration peut différer. Compare les prix des forfaits dans le guide des prix Freshdesk.
Combien coûtent les custom functions de Freddy AI Agent ?
La page de prix de Freshworks ne liste pas de ligne de prix séparée pour les functions. L'unité facturée pour l'agent est la session : les 500 premières sont incluses une fois par compte, puis $49 pour 100 sessions. Voir comment les sessions sont comptées et la décomposition des prix Freddy AI.
Une custom function Freddy peut-elle appeler une API externe ?
Les articles de Freshworks décrivent les functions uniquement comme de la transformation de données, et font passer les appels vers des systèmes externes par les actions API. Si tu as besoin d'une recherche de commande en direct, construis une action API et passe sa sortie à la function. Un exemple d'API de ticket Freshdesk montre la forme de la requête.
Dois-je connaître JavaScript pour construire une custom function Freddy ?
Freshworks indique qu'une compréhension de base de JavaScript est nécessaire si tu écris une custom function manuellement. Des functions prêtes à l'emploi pour les dates, le texte, les listes, les calculs et le Base64 couvrent les cas courants sans code. Pour une voie sans code, voir la bibliothèque de skills prêtes à l'emploi de Freddy.
Quelle est la différence entre une custom function Freddy et une API personnalisée eesel ?
Une function Freddy est du code que tu écris à l'intérieur d'un workflow que tu dessines toi-même. Dans eesel, tu autorises un domaine d'API, tu ajoutes l'en-tête d'authentification, et tu décris dans les instructions quand le coéquipier doit vérifier quelque chose. Lis la comparaison Freddy AI contre eesel ou regarde l'intégration eesel pour Freshdesk.
Puis-je supprimer une custom function déjà utilisée ?
Non. Freshworks indique que tu ne peux pas supprimer une function utilisée dans un workflow actif, retire donc d'abord la dépendance. Cloner une function est la façon sûre de modifier la logique sans toucher à une function en production, ce qui compte quand tu suis les bonnes pratiques de l'agent IA Freshdesk pour les déploiements.