Saltar al contenido principal

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.

1

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.

2

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-react
3

Intercambiar 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 }
4

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 sesiones

Configuració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
Solicitar acceso o asesoramiento →

Módulo de Drupal

Normalmente medio día

Instalar 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
Solicitar acceso o asesoramiento →

Integración en React / JavaScript

Normalmente 1–2 horas

Integrar 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
Solicitar acceso o asesoramiento →

Despliegue Enterprise

Definido por despliegue

Nube 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
Solicitar acceso o asesoramiento →

Revisión de seguridad y cumplimiento

Proporcionado bajo solicitud

Documentació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
Solicitar acceso o asesoramiento →

Configuración del piloto de Memory

Onboarding piloto

Puesta 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
Solicitar acceso o asesoramiento →

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 →