Integración: referencia técnica para desarrolladores

Esta referencia está dirigida a desarrolladores que integran reactive.chat en un sitio web, una aplicación o un backend. Describe las interfaces y los flujos tal como están implementados en el código, con nombres, tipos, valores predeterminados y casos de error.

En Personalización se describe cómo configurar el aspecto, los textos, la pantalla de inicio, las reglas, los recorridos, las pruebas A/B y la personalidad de la IA. El Manual describe el uso de su cuenta y del panel de agentes.

De un vistazo

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

En el cliente, inserte una etiqueta de script y, opcionalmente, controle el widget mediante window.ReactiveChat. En el servidor, firme la identidad de los usuarios con sesión iniciada, responda a las solicitudes de datos de clientes si es necesario, reciba webhooks y utilice la API REST.

Capítulos

Fundamentos

• Arquitectura y funcionamiento – los componentes, cómo se coordinan, versiones y distribución
• Inicio rápido – insertar, añadir su dominio, CSP y comprobar

En el navegador

• Referencia de la etiqueta de script – todos los atributos data-rc-* y las fuentes de configuración
• API de JavaScript – todos los comandos de ReactiveChat(…)
• Eventos – on/off y eventos DOM
• Identificar visitantes y transmitir contexto – identify, userHash, exp, track
• Aplicaciones de una sola página y cambios de página
• Seguridad y política de seguridad de contenido

Conexión y distribución

• Dominio propio y proxy first-party – nginx, Apache, Caddy
• Transporte: WebSocket, alternativa HTTP y reconexión – protocolo, códigos de error y cierre

En su servidor

• Endpoint de datos de clientes – consulta e importación de pedidos
• Webhooks – eventos, firma, reintentos y REST hooks
• API de servidor (REST v1) y MCP
• Integraciones y canales – WhatsApp, Messenger, Instagram, Telegram, SMS y correo electrónico

Otros lugares de integración

• Aplicaciones móviles – el chat en una WebView
• Smart Answer – respuesta de IA en la búsqueda de su sitio web

Funcionamiento

• Integración de privacidad – consentimiento, almacenamiento y texto de privacidad
• Límites y cuotas
• Solución de problemas y lista de comprobación

Otras páginas sobre el tema

• Insertar el widget – la versión breve
• Detalles técnicos – mediciones de tamaño, accesibilidad y contraste
• Abrir el chat desde un enlace o botón propio
• La tarjeta promocional en el chat
• Datos de clientes en el chat
• Dominio propio (first-party)
• Alternativa HTTP
• Insertar automáticamente el texto de privacidad

Términos

• Clave del sitio – clave pública de un proyecto (24 caracteres), incluida en el código de inserción. No es secreta.
• Proyecto – un sitio web o una aplicación con ajustes propios; varios proyectos forman un espacio de trabajo.
• Panel de agentes – la interfaz en la que responde su equipo.
• Usuario confirmado – visitante cuya identidad ha firmado su servidor mediante userHash.
• Cargador / núcleo – el pequeño cargador loader.js y el componente principal core.<hash>.js que se carga después.

Todas las partes de la documentación de un vistazo: Documentación.