Översikt
En översikt över Assistant API och den inbäddade widget-integrationen.
Vad är detta?
Assistant-plattformen tillhandahåller ett API för att bygga konversationsdrivna assistenter och en inbäddad widget som kan placeras på webbplatser. Den typiska arkitekturen separerar hemliga serverside-kod från webbläsarkod genom att utfärda kortlivade widget-tokens.
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.
Kärnkoncept
Understanding these core concepts will help you make the most of the Companin Widget:
- API: REST-slutpunkter för att hantera assistenter, sessioner, konversationer och kunskap.
- Widget: Klientside-komponent som ansluter till API för realtidsinteraktioner.
- Autentisering: JWTs eller API-nyckelpar headers (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.
Hur det fungerar (högnivå)
- Servern utfärdar kortlivade widget-tokens till webbläsaren.
- Widgeten använder tokens för att autentisera API-anrop och upprätthålla sessioner.
- Serverside-slutpunkter accepterar JWTs eller API-nyckel header-par och tillämpar organisationsnivå hastighetsbegränsningar.
Nästa steg
Följ Snabbstart för att bädda in widgeten, sedan konsultera API-referensen för detaljer.