Documentación
Guías de implementación para las soluciones de IA seguras y conformes de ContentCloud. La integración web que se muestra a continuación está disponible públicamente hoy mismo. Las API de ingesta, administración y plataforma se habilitan actualmente con nuestro equipo durante el onboarding, los proyectos piloto o el diseño de la solución.
Inicio rápido: integrar CCBot en su sitio web
Estos son los mismos pasos que utilizamos para el widget de este sitio. Necesitará una clave API de su tenant de ContentCloud para el paso 3.
Solicitar acceso y una clave API
Las claves API se entregan durante el onboarding o un proyecto piloto. Póngase en contacto con nosotros y configuraremos su tenant y su clave.
Instalar el paquete del widget
El widget de React está publicado en npm. Se monta dentro de un Shadow DOM e incluye sus propios estilos para no entrar en conflicto con el CSS de su sitio.
npm install @eworx-org/ccbot-reactIntercambiar su clave API en el servidor por un token de sesión
Mantenga la clave API en el servidor. Su endpoint la intercambia por un token de sesión de corta duración (Chat Session Token), de modo que la clave nunca llega al navegador. Pase la dirección IP del visitante en la cabecera X-Visitor-IP (utilizando la última entrada X-Forwarded-For añadida por su propio proxy) para que el límite de peticiones se aplique por visitante. Reenvíe el cuerpo de la petición del widget y devuelva la respuesta del intercambio sin cambios: contiene el secreto anónimo que mantiene el usuario de chat de cada visitante entre cargas de página.
// POST /api/ccbot/token (server-side only)
const visitorIp = req.headers.get('x-forwarded-for')?.split(',').pop().trim();
const res = await fetch(
'https://www.contentcloud.com/services/chat-token-service/exchange',
{
method: 'POST',
headers: {
'X-Api-Key': process.env.CONTENT_CLOUD_API_KEY,
'Content-Type': 'application/json',
...(visitorIp && { 'X-Visitor-IP': visitorIp }),
},
body: await req.text(), // { anonymousSecret? } from the widget
},
);
return Response.json(await res.json()); // { token, anonymousSecret }Montar el widget
Apunte el widget a su endpoint de token. Así es exactamente como está configurado el widget en este sitio web.
import { CCbotWidget } from '@eworx-org/ccbot-react';
<CCbotWidget auth={{ tokenEndpoint: '/api/ccbot/token' }} />Sitios Drupal: utilice el módulo de Drupal de ContentCloud en lugar del paquete de React; se encarga de la ubicación y configuración del widget en Drupal 9, 10 y 11. Solicítenos el módulo y las notas de instalación.
Qué trabajamos junto con su equipo
Los siguientes temas se abordan durante el onboarding, los proyectos piloto y el diseño de la solución. La documentación correspondiente se comparte directamente con su equipo.
Onboarding e ingesta de contenido
Normalmente 1–2 sesionesConfiguración de su proyecto e incorporación de sus primeras fuentes junto con nuestro equipo.
- Configuración del proyecto y del tenant
- Selección de fuentes y planificación de la ingesta
- Alcance, listas permitidas/excluidas y políticas de respuesta
- Validación de respuestas frente a sus fuentes originales
Módulo de Drupal
Normalmente medio díaInstalar el módulo de ContentCloud en Drupal 9/10/11 y colocar el widget.
- Instalación del módulo mediante Composer
- Configuración de la clave API
- Ubicación y personalización visual del widget
- Sincronización de contenidos
Integración en React / JavaScript
Normalmente 1–2 horasIntegrar el widget con el paquete público de npm (como en este sitio web).
- Instalar @eworx-org/ccbot-react
- Añadir un endpoint de servidor para el intercambio de token
- Montar el componente del widget
- Ajustes de estilo en el Shadow DOM
Despliegue Enterprise
Definido por despliegueNube dedicada en la UE o despliegue en sus instalaciones (on-premises), diseñado con nuestros ingenieros.
- Integración SSO (SAML/OIDC, EU Login)
- Instalación on-premises o en nube privada
- Dimensionamiento de hardware y opciones de GPU dedicada
- Supervisión y operaciones
Revisión de seguridad y cumplimiento
Proporcionado bajo solicitudDocumentación para EIPD (DPIA), revisiones de seguridad y contratación pública.
- Residencia de datos, cifrado y conservación
- Controles de acceso y registro de auditoría
- Acuerdo de encargo de tratamiento (DPA) e información de subencargados
- Documentación sobre la Ley de IA de la UE y el RGPD
Configuración del piloto de Memory
Onboarding pilotoPuesta en marcha en escritorio, móvil y portal para los participantes en el piloto de Memory.
- Instalación de Memory Sidekick y Memory Mobile
- Elección de fuentes de captura por dispositivo
- Políticas de espacio de trabajo y conservación
- Autoalojamiento con Docker Compose
API de la plataforma
Las API de ingesta, administración y consulta existen en la plataforma y se utilizan para integraciones de clientes, pero aún no se publican como una API pública de autoservicio. Los endpoints, los detalles de autenticación y los límites de uso se facilitan dentro del alcance de su tenant durante el onboarding o un proyecto piloto.
Una API pública con documentación de referencia forma parte de nuestra hoja de ruta. Si su evaluación depende de ello, háganoslo saber.
¿Necesita ayuda?
Soporte técnico
Ayuda con la integración, resolución de problemas y consultas de despliegue por correo electrónico en horario laboral europeo.
Contactar con soporte →Preguntas frecuentes
Respuestas sobre despliegue, tratamiento de datos, tarifas, proyectos piloto, CCBot Mobile y Memory.
Ver las FAQ →