Integraciones y canales (aspectos técnicos)

Los canales incorporan mensajes de otros servicios al mismo panel de agentes que el chat del sitio web; las integraciones envían eventos a otros servicios u obtienen conocimiento de ellos. Esta página describe la tecnología. El Manual explica cómo utilizarlos en su cuenta.

Estado: los canales y la mayoría de las integraciones se han probado con respuestas simuladas de los proveedores, pero todavía no con todas las cuentas reales. El webhook firmado está terminado (con la limitación indicada allí); para los demás proveedores, compruebe el registro de la integración tras activarla. Trátelos como beta.

Reglas comunes

• Las direcciones de callback tienen la forma https://reactive.chat/kanal/<kanal>/<SITE_KEY>. La clave del sitio está en Proyecto → Instalación de su cuenta.
• Cada ruta entrante verifica la firma del proveedor. Sin el secreto del proveedor no se acepta nada.
• Las credenciales se almacenan cifradas y separadas del resto de la configuración.
• Las respuestas de su equipo se envían al proveedor mediante una cola de salida; una plataforma bloqueada no detiene ningún chat.
• Longitud de los mensajes: los mensajes entrantes que superan el límite del plan se acortan y se marcan con [...] (Límites).
• Los archivos adjuntos de los canales (correo, fotos de Telegram) pasan por la misma comprobación que en el widget (tipo, tamaño y cuota). Los archivos rechazados aparecen en el texto como «[Archivo adjunto no aceptado: …]», en el idioma predeterminado del proyecto (de, en, pl; en los demás casos, inglés).

WhatsApp, Messenger, Instagram

Se configuran en Integraciones de su cuenta. Necesita su propia aplicación en Meta Developer Dashboard; sus mensajes no pasan por una cuenta nuestra.

• Callback URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY o …/kanal/instagram/SITE_KEY
• Verify Token: una cadena aleatoria larga que debe introducir de forma idéntica en Meta y con nosotros (comparación en tiempo constante).
• App Secret: lo utilizamos para verificar la firma de cada callback. Sin App Secret, la ruta entrante no acepta nada.
• Access Token: lo utilizamos para enviar en su nombre.

Reglas de las plataformas que hacen que las entregas fallen en silencio:

• WhatsApp: durante las 24 horas siguientes al último mensaje del cliente puede responder libremente; después, solo con una plantilla aprobada (tipo UTILITY, exactamente un marcador {{1}}). Introduzca su nombre en la configuración; fuera de esa ventana no enviamos mensajes libres.
• Instagram: el cliente debe escribir primero.
• Messenger: de las etiquetas de mensaje solo se mantiene HUMAN_AGENT; rechazamos las demás.

Meta espera la respuesta a un callback en cinco segundos; nuestra ruta entrante solo lo acepta y lo pone en cola.

Telegram, SMS y correo electrónico

Estos canales pertenecen al proyecto y se configuran en Proyecto → Canales.

• Telegram: su propio bot. Al guardar el token del bot, registramos la dirección de callback https://reactive.chat/kanal/telegram/SITE_KEY mediante setWebhook, con un secret_token aleatorio que debe incluir cada callback. De forma predeterminada, el asistente también responde.
• SMS: mediante su cuenta de Twilio (integración Twilio). Para el número, introduzca https://reactive.chat/kanal/sms/SITE_KEY en «A message comes in»; se verifica X-Twilio-Signature. De forma predeterminada, el asistente también responde.
• Correo electrónico: se consulta su buzón mediante IMAP cada minuto; las respuestas se envían por su SMTP (en su defecto, por nuestro servicio de envío con Reply-To). Al activarlo no se recuperan correos antiguos. Se asignan a la conversación mediante In-Reply-To/References o, en su defecto, por remitente y asunto de los últimos 30 días. No se incorporan avisos de ausencia, informes de entrega, listas de correo, correos marcados como spam ni más de 20 correos por remitente y hora (300 por proyecto). De forma predeterminada, el asistente no responde al correo; si se activa, sus respuestas incluyen Auto-Submitted: auto-replied.

Carencia conocida: si una entrega al proveedor falla definitivamente (número bloqueado, ventana cerrada), el motivo figura en el registro de la integración, pero todavía no en la conversación.

Integraciones

Active las integraciones en Integraciones de su cuenta. Cada una tiene sus propias credenciales (clave, token, dirección o inicio de sesión con el proveedor). Los eventos (conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt) pasan por una cola con reintentos:

• hasta cinco reintentos con intervalos crecientes (de 1 s a poco más de 10 minutos),
• un mecanismo de corte por proveedor y espacio de trabajo: tras 5 errores en 60 segundos, una pausa de 30 segundos,
• los eventos de más de una hora de antigüedad dejan de entregarse,
• el chat nunca espera a una integración.

Proveedores en el código:

• Eventos a sus propios sistemas: webhooks (firmados, véase Webhooks), Zapier, Make y n8n (mediante REST hooks)
• Chat del equipo: Slack, Microsoft Teams, Discord
• Tickets y CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• Tiendas: Shopify, WooCommerce, Shopware, Stripe
• Conocimiento: rastreador web, WordPress, Notion, Confluence, Google Drive
• Analítica y errores: Google Analytics 4, Matomo, Plausible, Sentry
• Citas: Cal.com
• Canales: WhatsApp, Messenger, Instagram, Telegram, Twilio, correo electrónico

No puede registrar proveedores propios. Para conexiones propias, utilice webhooks, la API de servidor o MCP.

Las funciones de tienda en el chat (como «Añadir al carrito» para WooCommerce, Shopify y Shopware) las habilita reactive.chat por proyecto; solo funcionan en el host de tienda registrado y no tienen una API de JavaScript propia.

Aplicaciones móviles

Para aplicaciones no hay un SDK nativo, pero sí una página de inserción para WebViews: Aplicaciones móviles.

Siguiente: Aplicaciones móviles