Oversikt
En oversikt over Assistant API og den innebyggbare widget-integrasjonen.
Hva er dette?
Assistant-plattformen tilbyr et API for å bygge samtale-drevne assistenter og en innebyggbar widget som kan plasseres på nettsteder. Den typiske arkitekturen skiller hemmelighetsbærende serverkode fra nettleserkode ved å utstede kortlivede 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.
Kjernekonsepter
Understanding these core concepts will help you make the most of the Companin Widget:
- Assistant: en konfigurert samtaleagent.
- Session: en midlertidig kontekst for en besøkende som samhandler med en assistent.
- Widget token: kortlevd JWT for å autentisere widgets i nettlesere.
- Auth: JWT-er eller API nøkkelpar headere (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.
Hvordan det fungerer (høyt nivå)
- Server holder klienthemmelighet og bytter den mot et kortlevd widget-token via /api/auth/widget-token.
- Nettleser mottar token og initialiserer widgeten; widgeten bruker tokenet til å kalle API-endepunkter.
- Server-side endepunkter aksepterer JWT-er eller API nøkkelpar og bruker organisasjonsnivå rate limits.
Neste steg
Følg Hurtigstart for å bygge inn widgeten, deretter konsulter API Referansen for detaljer.