Panoramica
Una panoramica dell'API Assistente e dell'integrazione widget incorporabile.
Cos'è questo?
La piattaforma Assistente fornisce un'API per costruire assistenti guidati conversazione e un widget incorporabile che può essere piazzato su siti web. L'architettura tipica separa codice lato server segreto dal codice browser emettendo token widget di corta durata.
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.
Concetti Principali
Understanding these core concepts will help you make the most of the Companin Widget:
- API: Endpoint REST per gestire assistenti, sessioni, conversazioni e conoscenza.
- Widget: Componente lato client che si connette all'API per interazioni in tempo reale.
- Autenticazione: JWT o header coppie chiave API (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.
Come funziona (alto livello)
- Il server emette token widget di corta durata al browser.
- Il widget utilizza token per autenticare chiamate API e mantenere sessioni.
- Endpoint lato server accettano JWT o coppie header chiave API e applicano limiti tasso a livello organizzazione.
Prossimi passi
Segui la Guida Rapida per incorporare il widget, poi consulta il Riferimento API per dettagli.