Resumen
Una descripción general de la API del Asistente y la integración del widget integrable.
¿Qué es esto?
La plataforma de Asistente proporciona una API para construir asistentes conversacionales y un widget integrable que se puede colocar en sitios web. La arquitectura típica separa el código del servidor que porta secretos del código del navegador emitiendo tokens de widget de corta duración.
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.
Conceptos Principales
Understanding these core concepts will help you make the most of the Companin Widget:
- Asistentes: Personas configurables con conocimientos específicos y comportamientos.
- Sesiones: Contextos conversacionales que mantienen el estado a través de interacciones.
- Conocimiento: Base de datos de información indexada para respuestas precisas.
- Widget: Interfaz de chat integrable para sitios web.
- Auth: JWTs o pares de encabezados de clave 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.
Cómo funciona (alto nivel)
- Los puntos finales del servidor aceptan JWTs o pares de clave de encabezado API y aplican límites de tasa a nivel de organización.
- Los tokens de widget se emiten con vida corta para uso del navegador.
- Las conversaciones se mantienen con contexto completo a través de sesiones.
Próximos pasos
Sigue el Inicio Rápido para integrar el widget, luego consulta la Referencia API para detalles.