Integraciones, migración y claves de API

En Integraciones (/app/integrations) puede conectar reactive.chat con herramientas que su equipo ya utiliza. Las integraciones se aplican a todo el espacio de trabajo. Pueden configurarlas los propietarios y administradores; un administrador con acceso limitado a proyectos concretos no puede hacerlo.

Esta página describe para qué sirven las integraciones y cómo utilizarlas. Los detalles técnicos, por ejemplo sobre la firma de webhooks, se encuentran en la sección Integración técnica.

El estado actual, con transparencia

Hay conexiones disponibles con más de 30 servicios. La mayoría se han probado con servicios simulados, pero todavía no se han utilizado con el servicio real. La página de integraciones las identifica con «No verificado con el servicio real»; algunas muestran «En desarrollo». Los webhooks y Slack no llevan esta indicación. Configure una integración no verificada, pruébela con datos reales y avísenos mediante Enviar comentarios si algo no funciona bien.

Configurar una integración

1. Abra Integraciones. Arriba verá cuántas están conectadas, cuántas tienen un error o están pausadas y si ha habido entregas fallidas.
2. Busque en el catálogo (Buscar integraciones, filtro «Todas» o «No conectadas») y pulse Configurar.
3. Introduzca las credenciales que solicite el servicio, normalmente una clave de API o un token de su cuenta en ese servicio.
4. Conectar y activar comprueba la conexión de inmediato y activa la integración. Con Guardar sin activar puede dejarlo para más adelante.

Después puede Editar, Pausar, Reactivar o Eliminar una integración. Al eliminarla se borran las credenciales guardadas y no se puede deshacer. Las credenciales se almacenan cifradas.

Solo Google Drive dispone de un botón para iniciar sesión en el servicio. En todos los demás debe introducir las credenciales personalmente; en Slack, por ejemplo, los datos de una aplicación de Slack propia.

Cuando un servicio no responde

Cada integración funciona mediante una cola. Si un servicio no responde, se reintenta la entrega varias veces con intervalos cada vez mayores; tras fallos repetidos, se suspende durante un tiempo («Suspendido temporalmente: el servicio no ha respondido en varias ocasiones …»). Si un evento no se ha entregado al cabo de aproximadamente una hora, se descarta. En la sección Entregas fallidas verá las entregas fallidas más recientes, sin su contenido.

Un mensaje de chat nunca espera a una integración. Si un servicio se bloquea, el chat sigue funcionando sin interrupciones.

Opciones disponibles

Notificaciones para su equipo

• Slack – cada nueva conversación aparece como un hilo en un canal. Su equipo responde en el hilo y el visitante ve la respuesta en el chat. /rc muestra el estado. Puede asociar usuarios de Slack con agentes.
• Microsoft Teams, Discord – notificaciones mediante una dirección de webhook.
• Telegram – notificaciones a un chat mediante el token del bot y el ID del chat.
• Correo electrónico – notificaciones a un buzón del equipo.

Automatización

• Webhooks – reactive.chat envía eventos firmados a una dirección https:// que usted elija: nueva conversación, cada mensaje, solicitud de transferencia a una persona, valoración enviada y nuevo caso de error. Zapier, Make y n8n también se conectan de esta forma. Puede mostrar, copiar y regenerar el Secreto de firma; el nuevo secreto entra en vigor de inmediato y el anterior deja de ser válido.
• Zapier – mediante los REST hooks de la interfaz. Todavía no hay una aplicación lista para Make y n8n; utilice webhooks en esos servicios.

Contexto en el panel de agentes

Estas integraciones muestran tarjetas sobre el visitante en la columna de contexto del panel de agentes, por ejemplo sus pedidos o su contacto en el CRM, algunas con acciones:

• CRM – HubSpot, Pipedrive
• Tienda – Shopify, Shopware 6, WooCommerce
• Pagos – Stripe (con una clave de lectura restringida)
• Sitio web – WordPress
• Analítica – Matomo, Plausible, Google Analytics 4
• Errores – Sentry

La tarjeta identifica los datos que se basan en una declaración no firmada del visitante. Para realizar una acción, pulse Ejecutar y confirme.

Tickets, citas, teléfono

• Zendesk, Freshdesk, Jira, Linear, GitHub – crear tickets o incidencias a partir de una conversación o un caso de error.
• Cal.com – mostrar y reservar citas disponibles, también a través del asistente de IA.
• Twilio – SMS desde el panel de agentes y vía de envío para el canal de SMS.

Fuentes de conocimiento

• Notion, Confluence – incorporar contenido a la base de conocimiento.
• Google Drive – en la base de conocimiento, «Archivos y Google Drive» (véase Base de conocimiento y centro de ayuda).
• KB-Crawler – ajustes para el rastreo de su sitio web.

Canales

• WhatsApp Business, Facebook Messenger, Instagram Direct – véase Canales.

Migrar desde otro proveedor

En Migración (/app/migration) puede importar datos de otra herramienta de chat:

• Intercom y Crisp – mediante su interfaz o un archivo de exportación; en Crisp, también artículos de ayuda en Markdown,
• Tidio – mediante un archivo de exportación,
• Zendesk – mediante la exportación completa en JSON y la exportación del centro de ayuda.

Pasos que debe seguir:

1. Crear una nueva migración y elegir el destino (¿A qué proyecto?).
2. Conectar y ver qué hay – verá los datos disponibles y una muestra.
3. ¿Qué desea importar? – contactos, conversaciones, artículos.
4. Iniciar migración. Puede Detener o Descartar tarea.

Lo que debe saber:

• Las conversaciones importadas llegan al panel de agentes cerradas.
• Los contactos importados se consideran no verificados.
• Los datos sensibles de los textos se ocultan.
• Los archivos adjuntos se incorporan como enlaces, no como archivos.
• Una segunda ejecución no crea duplicados.
• Sus credenciales del proveedor anterior se eliminan después de la ejecución.
• Las interfaces de los proveedores se han probado sin cuentas reales en esos servicios; las importaciones de archivos se han probado de principio a fin con archivos de ejemplo.

Con Sustituir el código de inserción, la cuenta convierte un código de inserción existente de Intercom o Crisp en uno de reactive.chat. Los comandos JavaScript boot, open, identify y track conservan los mismos nombres que en Intercom.

Claves de API

En Claves de API (/app/api-keys, propietarios y administradores) puede crear claves para la interfaz REST. Una clave se muestra exactamente una vez; después, reactive.chat solo conserva una huella de ella. Por ello, cópiela de inmediato en un lugar seguro.

Al crearla, elige qué puede hacer la clave:

• solo lectura
• lectura y escritura
• solo importación de datos de clientes – para la importación descrita en Datos de clientes en el chat
• lectura + datos de visitantes o lectura, escritura + datos de visitantes – solo con estos permisos puede acceder la clave al nombre, correo electrónico y teléfono de los visitantes

La lista muestra el nombre, el prefijo, cuándo y quién creó la clave y cuándo se utilizó por última vez. Revocar tiene efecto inmediato y no se puede deshacer.

Con una clave también puede conectar reactive.chat con herramientas de IA compatibles con el Model Context Protocol (MCP); la página muestra ejemplos. El funcionamiento de la interfaz se describe en la sección Integración técnica.