## 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

1. Abre el área de **Integraciones** en Configuración.
2. Elige la integración y sigue el flujo de conexión (normalmente login/autorización o introducción
   de claves).
3. Para **webhooks**, registra la URL de tu endpoint y selecciona los eventos de interés; valida la
   recepción en tu sistema.
4. Para la **API**, genera un token de acceso (perfil/agente) y úsalo en las llamadas autenticadas.
5. 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.

## Ver también

- [Custom Scripts: inyectar JS/CSS](/hc/ajuda/articles/administration-custom-scripts-es)
- [Roles personalizados y gobernanza (RBAC)](/hc/ajuda/articles/administration-custom-roles-governanca-rbac-es)
- [Registros de auditoría](/hc/ajuda/articles/administration-auditoria-es)
- [Visión general de Administración](/hc/ajuda/articles/administration-overview-es)