Visión general
Las Integraciones conectan Conversa Labs 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.
- Proveedores por credencial: conecta traducción, video, CRM, IA, voz y búsqueda con tus propias claves o cuentas de servicio.
- Webhooks: recibe eventos de la plataforma en tu propio endpoint, en tiempo real.
- Aplicaciones de panel (Dashboard Apps): incrusta tu aplicación web en la conversación o barra lateral de la cuenta, con audiencia, orden y compatibilidad nativos cuando están habilitados.
- 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. En los formularios por credencial, los accesos directos sobre los campos
incluyen el nombre del proveedor:
- Obtener credenciales de proveedor abre la página oficial de claves o cuentas de servicio;
- Abrir la consola de proveedor abre la API o consola que debe habilitarse, cuando aplique;
- Ver documentación de configuración de proveedor abre la guía oficial correspondiente.
- Completa los campos con datos del mismo proyecto/cuenta y finaliza la creación.
- 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, Google Translate, Dyte, LeadSquared y proveedores de IA, voz o búsqueda): 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.