Nous construisons encore des choses ici !Aidez-nous à nous améliorer en signalant des bugs. 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 bugs. ici.
Un aperçu de l'API de l'Agent et de l'intégration du widget intégrable.
Qu'est-ce que c'est ?
La plateforme d'Agent de Support Client IA 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 navigateur en émettant des tokens 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.
Token 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 token de widget à durée de vie courte via /api/v1/auth/widget-token.
Le navigateur reçoit le token et initialise le widget ; le widget utilise le token pour appeler les points de terminaison API.
Les points de terminaison côté serveur acceptent des JWT ou des paires d'en-têtes de clé API et appliquent des limites de taux au niveau de l'organisation.
Prochaines étapes
Suivez le Démarrage Rapide pour intégrer le widget, puis consultez la Référence API pour les détails.