Guide du développeur pour l'API de session ChatKit : Qu'est-ce que c'est et ses limites

Stevia Putri
Written by

Stevia Putri

Stanley Nicholas
Reviewed by

Stanley Nicholas

Last edited 12 octobre 2025

Expert Verified

Si vous créez un agent IA, ChatKit d'OpenAI a probablement attiré votre attention. C'est une interface de chat préconçue censée vous épargner énormément de travail de développement frontend. Et à première vue, ça a l'air génial.

Le piège ? Pour que tout fonctionne de manière sécurisée, il faut se débattre avec le backend et l'API de session de ChatKit.

Dans ce guide, nous allons lever le voile sur ce qu'est ChatKit, comment son API de session fonctionne réellement, et nous pencher sur les complexités cachées que vous devriez connaître avant de vous engager. Nous verrons également pourquoi une plateforme plus intégrée pourrait être une meilleure option pour les entreprises, notamment pour des applications comme le support client.

Qu'est-ce que ChatKit d'OpenAI et l'API de session ChatKit ?

Alors, qu'est-ce que ChatKit exactement ? Considérez-le comme le visage amical de votre agent IA. C'est une bibliothèque JavaScript d'OpenAI qui vous offre une fenêtre de chat personnalisable que vous pouvez intégrer directement dans votre application.

Au lieu de créer une interface de chat à partir de zéro (et de gérer tous les tracas liés à l'historique des messages, à la diffusion en continu des réponses et au téléchargement de fichiers), vous pouvez simplement utiliser leur composant web. Il est conçu pour se connecter à un flux de travail d'IA que vous créez dans l'Agent Builder d'OpenAI.

L'objectif est de vous permettre de vous concentrer sur le cerveau de votre agent (la logique) plutôt que sur son visage (l'interface utilisateur). C'est pratique pour toutes sortes d'applications, des bots d'aide internes au support client. Mais, comme vous le verrez, connecter cette jolie interface à votre application de manière sécurisée est là où le vrai travail commence, et tout cela est géré par l'API de session ChatKit.

Comment fonctionne l'API de session ChatKit

Bon, entrons dans le vif du sujet. L'API de session ChatKit est essentiellement le gardien de sécurité de votre widget de chat. Évidemment, vous ne pouvez pas simplement coller votre clé API secrète d'OpenAI dans votre code frontend, ce serait une catastrophe annoncée. À la place, ChatKit vous oblige à utiliser un flux d'authentification côté serveur pour créer des jetons temporaires. Cela garantit que seuls les utilisateurs réels et autorisés de votre site web peuvent communiquer avec votre agent IA.

Explication du flux d'authentification de l'API de session ChatKit

Avant même que cette bulle de chat puisse apparaître à l'écran, un petit ballet doit s'opérer entre le navigateur de l'utilisateur, votre serveur et les serveurs d'OpenAI. Voici une description étape par étape :

  1. Le navigateur demande une autorisation : Le frontend de votre site web contacte votre serveur backend et dit : « Hé, j'ai besoin d'un jeton pour démarrer une conversation. »

  2. Votre serveur parle à OpenAI : Votre backend reçoit la demande. Il effectue ensuite un appel sécurisé de serveur à serveur à l'API d'OpenAI, en utilisant votre clé API secrète, pour créer une nouvelle session ChatKit.

  3. OpenAI renvoie une clé temporaire : L'API d'OpenAI génère un « client_secret » à courte durée de vie et le renvoie à votre serveur.

  4. La clé est envoyée au navigateur : Votre backend transmet ensuite cette clé temporaire au navigateur de l'utilisateur. Le navigateur l'utilise pour lancer le composant ChatKit, et voilà, la fenêtre de chat apparaît.

Tout ce processus est conçu pour garder votre clé API principale d'OpenAI en toute sécurité sur votre serveur.

Composants clés que vous devez développer pour l'API de session ChatKit

Pour y parvenir, vous ne pouvez pas simplement copier-coller un bout de code. Vous devez construire et gérer trois éléments d'infrastructure distincts :

  • Un flux de travail d'agent : D'abord, il vous faut un agent. Vous devez concevoir et publier un flux de travail dans l'Agent Builder d'OpenAI. Cela vous donnera un identifiant unique (qui ressemble à « wf_... ») dont vous aurez besoin plus tard.

  • Un point de terminaison backend : C'est le plus gros morceau. C'est à vous de créer et d'héberger votre propre point de terminaison d'API backend (quelque chose comme « /api/chatkit/session »). Ce serveur est l'endroit où vous stockerez en toute sécurité votre clé API OpenAI et écrirez la logique pour gérer l'échange de jetons.

  • Une implémentation frontend : Enfin, vous devez ajouter le JavaScript de ChatKit à votre site, écrire le code qui appelle votre nouveau point de terminaison backend, puis utiliser le jeton qu'il renvoie pour afficher réellement le widget de chat.

Cette configuration signifie que même pour un « simple » widget de chat, vous devenez un développeur full-stack, gérant et déployant à la fois du code frontend et backend. Cela ajoute une couche de complexité que les solutions tout-en-un n'ont tout simplement pas.

Les défis et les limites de l'API de session ChatKit

ChatKit peut vous éviter d'écrire du code frontend, mais il introduit une toute nouvelle série de maux de tête, surtout si vous essayez de créer un agent de support IA fiable pour une entreprise. Sa flexibilité est une arme à double tranchant ; c'est un composant, pas une solution complète.

Beaucoup de travail à mettre en place et à maintenir

Comme nous venons de le voir, ce n'est pas un simple travail de copier-coller. Vous devez :

  • Construire et héberger un serveur juste pour créer et rafraîchir les jetons de session.

  • Vous battre avec les paramètres de sécurité comme la liste blanche de domaines. C'est un piège courant où le widget ne se charge tout simplement pas, souvent sans message d'erreur utile.

  • Écrire du code d'intégration à la fois pour votre frontend et votre nouveau backend.

Tout cela prend du temps de développement et crée un autre système que vous devez maintenir. Comparez cela à une plateforme comme eesel AI, qui est conçue pour être en libre-service. Vous pouvez être opérationnel avec une intégration de service d'assistance en un clic en quelques minutes, sans aucun développement backend personnalisé nécessaire.

Vos connaissances sont coincées dans l'univers d'OpenAI

ChatKit est conçu pour fonctionner avec les agents de l'Agent Builder d'OpenAI. C'est très bien si votre agent n'a besoin que des connaissances qui vivent au sein d'OpenAI. Mais ce n'est pas comme ça que la plupart des entreprises fonctionnent, n'est-ce pas ?

Vos connaissances sont probablement éparpillées partout :

  • Vos articles d'aide sont dans Zendesk.

  • Vos documents internes sont dans Confluence ou Google Docs.

  • Votre équipe répond aux questions dans Slack.

  • Vos agents de support ont des années de contexte dans les conversations Intercom.

ChatKit et Agent Builder ne vous offrent pas vraiment un moyen propre de rassembler tout cela. Un agent IA vraiment utile a besoin d'accéder à toutes les connaissances de votre entreprise, où qu'elles se trouvent. C'est pourquoi eesel AI se connecte à plus de 100 sources dès le départ. Vous pouvez unifier vos connaissances instantanément sans avoir besoin d'un projet de migration de données massif.

Il manque les fonctionnalités dont les équipes de support ont réellement besoin

En fin de compte, ChatKit n'est qu'une fenêtre de chat. Ce n'est pas une plateforme de support client complète. Il lui manque un tas de choses sur lesquelles les équipes de support comptent pour utiliser l'IA de manière efficace et sûre :

  • Aucun moyen de le tester : Il n'y a pas de mode de simulation pour voir comment votre agent aurait géré les conversations passées. Vous naviguez essentiellement à l'aveugle, sans moyen réel de prédire sa précision avant de le lâcher sur les clients.

  • Aucune aide pour vos agents humains : C'est tout ou rien. Il n'y a pas de fonction copilote pour aider vos agents humains à rédiger des réponses plus rapidement lorsqu'une conversation doit être escaladée.

  • Pas d'automatisation backend : Il ne peut pas faire des choses comme étiqueter automatiquement les tickets, acheminer les conversations vers la bonne équipe, ou gérer d'autres tâches en coulisses qui font gagner un temps fou.

eesel AI a été conçu spécifiquement pour les équipes de support. Vous pouvez utiliser son mode de simulation puissant pour tester votre IA sur des milliers de vos vrais tickets passés, obtenir des rapports clairs sur ses performances, puis déployer l'automatisation en toute confiance.

Tarifs pour les flux de travail d'agents OpenAI

Alors, combien tout cela coûte-t-il ? La bibliothèque ChatKit est gratuite, mais l'exécution de l'agent lui-même ne l'est pas. Vos coûts proviendront des appels API aux modèles et aux outils que votre agent utilise. Cela peut rendre votre facture mensuelle assez imprévisible.

Pour la plupart des usages professionnels, vous aurez besoin d'un plan ChatGPT Business ou Enterprise pour obtenir les fonctionnalités de sécurité et d'administration dont vous avez besoin. Voici un aperçu rapide de leurs plans standards.

FonctionnalitéChatGPT BusinessChatGPT Enterprise
Tarifs25 $/utilisateur/mois (facturation annuelle)Contacter le service commercial
Accès aux modèlesMessages GPT-5 illimités (avec un accès généreux à GPT-5 thinking et GPT-5 pro)Tout ce qui est inclus dans Business, plus des fenêtres de contexte étendues
SécuritéEspace de travail sécurisé, SSO SAML, données exclues de l'entraînement par défautSécurité de niveau entreprise, SCIM, analyses des utilisateurs, rétention des données personnalisée
IntégrationsConnecteurs pour Google Drive, SharePoint, Notion, etc.Tout ce qui est inclus dans Business
Fonctionnalités clésAnalyse de données, projets partagés, GPTs d'espace de travail personnalisésSupport prioritaire 24/7, SLAs, accès à un conseiller en IA

Ces informations sont basées sur les tarifs publics et sont sujettes à modification. Pour les derniers détails, il est toujours préférable de consulter la page officielle des tarifs de ChatGPT.

Une voie plus simple pour les équipes de support : eesel AI

Pour toute entreprise, mais surtout pour les équipes de support, ChatKit n'est qu'une pièce d'un puzzle beaucoup plus grand. Il vous donne la fenêtre de chat, mais vous devez encore construire le backend, trouver les intégrations, et ajouter toutes les fonctionnalités qui font vraiment la différence.

eesel AI est une plateforme tout-en-un qui gère tout cela pour vous, vous permettant de lancer un agent IA réellement utile en quelques minutes. Voici en quoi c'est différent :

  • Soyez opérationnel en quelques minutes, pas en plusieurs mois : Au lieu de construire un backend pour gérer les jetons, il vous suffit de connecter votre service d'assistance (comme Zendesk ou Freshdesk) en un clic. La plateforme est véritablement en libre-service, ce qui signifie que vous pouvez commencer sans parler à un commercial.

  • Connectez toutes vos connaissances : Ne cloisonnez pas votre IA. eesel AI tire des informations de votre service d'assistance, de vos wikis internes comme Confluence et Google Docs, et même d'outils de collaboration comme Slack. Elle peut également apprendre de vos anciens tickets de support pour adopter le ton de votre marque dès le premier jour.

  • Une boîte à outils complète pour l'automatisation du support : eesel AI est bien plus qu'un chatbot. La plateforme vous offre un Agent IA pour une automatisation complète, un Copilote IA pour aider votre équipe humaine, et un Triage IA pour organiser automatiquement votre file d'attente de support.

  • Testez en toute confiance et obtenez des informations réelles : Utilisez le mode de simulation pour voir exactement comment l'IA se serait comportée sur vos tickets passés avant même de l'activer. Les rapports ne se contentent pas de vous bombarder de mesures vaniteuses ; ils vous montrent où se situent vos lacunes en matière de connaissances et vous donnent une voie claire pour vous améliorer.

Devriez-vous utiliser l'API de session ChatKit ?

ChatKit d'OpenAI est un outil solide si vous êtes un développeur qui souhaite une interface de chat personnalisable et que vous êtes prêt à remonter vos manches pour construire le backend nécessaire pour la supporter. L'API de session ChatKit offre un moyen sécurisé de gérer l'authentification, mais c'est un véritable projet de développement, pas une solution miracle.

Pour les entreprises à la recherche d'une solution de support IA rapide, puissante et complète, une plateforme dédiée est presque toujours le meilleur choix. Au lieu de tout assembler vous-même, vous obtenez un système intégré qui gère tout, de la gestion des connaissances au déploiement, avec des tarifs prévisibles et un objectif clair axé sur les résultats.

Prêt à voir ce qu'une plateforme de support IA entièrement intégrée peut faire ? Commencez gratuitement avec eesel AI.

Foire aux questions

L'objectif principal de l'API de session ChatKit est de gérer de manière sécurisée l'authentification pour votre widget ChatKit. Elle garantit que vos clés API OpenAI sensibles ne sont jamais exposées dans le code côté client, en créant à la place des jetons temporaires pour les sessions utilisateur.

L'API de session ChatKit utilise un flux d'authentification côté serveur. Votre serveur backend, qui détient votre clé API secrète, communique directement avec OpenAI pour générer un « client_secret » à courte durée de vie, qui est ensuite transmis au navigateur de l'utilisateur.

Pour implémenter correctement l'API de session ChatKit, les développeurs doivent créer et héberger un point de terminaison d'API backend dédié. Ce point de terminaison gère en toute sécurité le processus d'échange de jetons, ce qui nécessite une logique côté serveur personnalisée et du code d'intégration côté client.

La maintenance d'une solution construite avec l'API de session ChatKit implique la gestion continue du serveur et des mises à jour de sécurité pour votre backend personnalisé. Vous devrez également gérer les listes blanches de domaines et intégrer continuellement les changements du frontend.

L'API de session ChatKit elle-même n'offre pas d'intégrations directes avec des bases de connaissances externes. Sa fonction principale est l'authentification pour les agents construits dans l'Agent Builder d'OpenAI, ce qui peut limiter la facilité avec laquelle elle accède à diverses sources de données d'entreprise.

Bien que la bibliothèque de l'API de session ChatKit soit gratuite, les appels API sous-jacents effectués par l'agent qu'elle authentifie entraîneront des coûts de la part d'OpenAI. Ces coûts dépendent des modèles et des outils que votre agent utilise pendant les conversations.

Pour les équipes de support, se fier uniquement à l'API de session ChatKit et à l'Agent Builder signifie passer à côté de fonctionnalités telles qu'un mode de simulation pour les tests, des capacités de copilote IA pour les agents humains, et l'automatisation du backend pour le routage ou l'étiquetage des tickets. Elle fournit une fenêtre de chat, pas une plateforme de support complète.

Partager cet article

Stevia undefined

Article by

Stevia Putri

Stevia Putri is a marketing generalist at eesel AI, where she helps turn powerful AI tools into stories that resonate. She’s driven by curiosity, clarity, and the human side of technology.