Visión general
Las Integraciones conectan ConversaLabs con el resto de tu ecosistema. Desde el área de integraciones activas conexiones listas y creas tus propios puntos de extensión:
- Slack: refleja conversaciones en un canal de Slack y responde desde allí.
- Dialogflow: conecta un bot de Dialogflow para respuestas automáticas.
- Notion y Linear: lleva el contexto de la conversación a tus herramientas de productividad y desarrollo.
- Shopify: trae datos de pedidos/cliente de tu tienda a la atención.
- Webhooks: recibe eventos de la plataforma en tu propio endpoint, en tiempo real.
- Aplicaciones de panel (Dashboard Apps): incrusta tu propia aplicación web junto a la conversación.
- API: automatiza e integra mediante tokens de acceso.
Requisitos previos
- Rol de Administrador para configurar integraciones.
- Credenciales/cuentas de las herramientas que vas a conectar (por ejemplo, workspace de Slack, proyecto de Dialogflow, tienda Shopify).
- Para webhooks/API: un endpoint accesible y/o un token de acceso generado en la cuenta.
Paso a paso
- Abre el área de Integraciones en Configuración.
- Elige la integración y sigue el flujo de conexión (normalmente login/autorización o introducción de claves).
- Para webhooks, registra la URL de tu endpoint y selecciona los eventos de interés; valida la recepción en tu sistema.
- Para la API, genera un token de acceso (perfil/agente) y úsalo en las llamadas autenticadas.
- Prueba la integración con una conversación real antes de ponerla en producción.
Configuración y opciones
- Conexiones por autorización (Slack, Shopify, etc.): siguen el login de la herramienta externa.
- Conexiones por clave/proyecto (Dialogflow): requieren credenciales del proveedor.
- Webhooks por evento: tú eliges qué eventos quieres recibir.
- Tokens de API: trátalos como contraseñas; revócalos si se filtran o quedan en desuso.
Casos de uso
- Notificar a un canal de Slack cuando llega una nueva conversación.
- Triaje automático con un bot de Dialogflow antes de llegar al agente.
- Crear un ticket en Linear a partir de un error reportado por el cliente.
- Mostrar datos del pedido de Shopify directamente en la pantalla de la conversación.
- Sincronizar eventos con tu CRM o ERP mediante webhooks.
Consejos, límites y buenas prácticas
- Empieza por una integración, valida el flujo y luego añade otras.
- Para webhooks, implementa idempotencia y responde rápido (procesa en segundo plano).
- Guarda los tokens en variables de entorno de tu sistema — nunca en el código fuente público.
- Revisa integraciones y tokens periódicamente; elimina lo que ya no se usa.
Solución de problemas
- La integración no conecta: revisa credenciales/permisos e intenta reautorizar.
- El webhook no llega: verifica que la URL sea pública, responda con éxito (2xx) y esté suscrita a los eventos correctos.
- Error 401 en la API: el token es incorrecto, expiró o fue revocado — genera uno nuevo.
- No veo la integración que quiero: puede depender del plan o de una habilitación específica.