Nous construisons encore des choses ici !Aidez-nous à nous améliorer en signalant des bogues ici.Nous construisons encore des choses ici !Vous pourriez remarquer quelques imperfections pendant que nous travaillons sur des améliorations. Aidez-nous à nous améliorer en signalant des bogues ici.
Un aperçu de l'API Agent et de l'intégration du widget intégrable.
Qu'est-ce que c'est ?
La plateforme AI Agent de support client fournit une API pour construire des agents basés sur des conversations et un widget intégrable qui peut être placé sur des sites Web. L'architecture typique sépare le code serveur portant des secrets du code du navigateur en émettant des jetons de widget à durée de vie courte.
The Companin Widget is more than just a chat interface—it's a complete conversational AI platform that seamlessly integrates into your website. Built with modern web technologies (Next.js, React, TypeScript), it provides enterprise-grade reliability while maintaining simplicity for developers.
Unlike traditional chat widgets that require complex backend setup, Companin handles all the infrastructure for you. Authentication, message storage, conversation management, and AI processing are all managed through our secure API, allowing you to focus on creating great user experiences.
Concepts de base
Comprendre ces concepts fondamentaux vous aidera à tirer le meilleur parti du widget Companin :
Agent : un agent conversationnel configuré.
Session : un contexte temporaire pour un visiteur interagissant avec un agent.
Jeton de widget : JWT à durée de vie courte pour authentifier les widgets dans les navigateurs.
Auth : JWT ou paires d'en-têtes de clé API (X-API-Key + X-API-Secret).
🔑 Insight clé
La configuration du widget agit comme la seule source de vérité pour tous les paramètres d'apparence et de comportement. Cela signifie que vous pouvez mettre à jour l'apparence et la convivialité de votre widget sans changer de code sur votre site Web — il suffit de mettre à jour la configuration dans votre tableau de bord et les changements prennent effet immédiatement.
Comment ça fonctionne (niveau élevé)
Le serveur détient le secret client et l'échange contre un jeton de widget à durée de vie courte via /api/v1/auth/widget-token.
Le navigateur reçoit le jeton et initialise le widget ; le widget utilise le jeton pour appeler les points de terminaison API.
Les points de terminaison côté serveur acceptent les JWT ou les paires d'en-têtes de clé API et appliquent des limites de taux au niveau de l'organisation.
Prochaines étapes
Suivez le guide de démarrage rapide pour intégrer le widget, puis consultez la référence API pour plus de détails.