Übersicht
Eine Übersicht über die Assistenten-API und die Integration des einbettbaren Widgets.
Was ist das?
Die Assistentenplattform bietet eine API zum Erstellen von konversationsbasierten Assistenten und ein einbettbares Widget, das auf Websites platziert werden kann. Die typische Architektur trennt geheimbeladeten Servercode von Browsercode, indem kurzlebige Widget-Token ausgegeben werden.
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.
Kernkonzepte
Understanding these core concepts will help you make the most of the Companin Widget:
- Assistent: ein konfigurierter konversationeller Agent.
- Sitzung: ein temporärer Kontext für einen Besucher, der mit einem Assistenten interagiert.
- Widget-Token: kurzlebiges JWT zur Authentifizierung von Widgets in Browsern.
- Auth: JWTs oder API-Schlüssel-Paar-Header (X-API-Key + X-API-Secret).
💡 Key Insight
The widget configuration acts as the single source of truth for all appearance and behavior settings. This means you can update your widget's look and feel without changing any code on your website—just update the configuration in your dashboard and changes take effect immediately.
Wie es funktioniert (hochlevel)
- Server hält Client-Geheimnis und tauscht es für kurzlebiges Widget-Token über /api/auth/widget-token aus.
- Browser erhält Token und initialisiert Widget; Widget verwendet Token, um API-Endpunkte aufzurufen.
- Serverseitige Endpunkte akzeptieren JWTs oder API-Schlüssel-Paar-Header und wenden organisationsweite Ratenbegrenzungen an.
Nächste Schritte
Folgen Sie dem Schnellstart, um das Widget einzubetten, dann konsultieren Sie die API-Referenz für Details.