> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-d7deecde.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Integraciones de automatizaciones
> Conecta Slack, Notion, Linear, Jira, Confluence y otras apps para que las automatizaciones obtengan contexto en vivo desde las herramientas que usa tu equipo.
Las integraciones de automatizaciones requieren un [plan Enterprise](https://mintlify.com/pricing?ref=automation-integrations).
Las integraciones dan a las [automatizaciones](/es/automations/index) acceso al contexto de otras herramientas que utiliza tu equipo. Una vez conectadas, una automatización puede buscar en hilos de Slack, leer páginas de Notion, consultar incidencias de Linear y obtener contexto desde otras aplicaciones para fundamentar sus actualizaciones de contenido.
## Alcance de la conexión
Las integraciones se conectan de una de dos formas:
* **Las integraciones compartidas** se conectan una sola vez para toda tu organización y están disponibles para tus automatizaciones. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot y Plain se conectan todas de esta manera.
* **Las integraciones personales** se conectan por usuario. Cada miembro autoriza su propia cuenta. Google Calendar y Google Drive son personales.
Las integraciones personales mantienen los datos específicos del usuario, como los eventos del calendario, acotados al usuario que conectó la integración en lugar de compartirse en toda la organización.
## Conectar una integración
Los administradores y editores pueden conectar integraciones compartidas en nombre de la organización.
1. Ve a la página [Integraciones](https://app.mintlify.com/settings/organization/integrations) en la configuración de tu dashboard.
2. Busca la integración que quieres conectar.
3. Haz clic en **Connect**.
4. Sigue las indicaciones de OAuth para autorizar a Mintlify a acceder a tu cuenta.
Algunas integraciones abren un paso adicional de configuración antes de completar la conexión. Jira, Confluence y Salesforce piden la URL o el subdominio de tu espacio de trabajo antes de que comience el flujo de OAuth. Los proveedores basados en clave API como Plain te piden que pegues una clave API.
## Integraciones compatibles
| Integración | Alcance |
| --------------- | ---------- |
| Confluence | Compartida |
| Google Calendar | Personal |
| Google Drive | Personal |
| HubSpot | Compartida |
| Intercom | Compartida |
| Jira | Compartida |
| Linear | Compartida |
| Notion | Compartida |
| Plain | Compartida |
| Salesforce | Compartida |
| Slack | Compartida |
## Cómo usan las automatizaciones las integraciones
Las automatizaciones usan las integraciones conectadas como herramientas. Cuando se ejecuta una automatización, el agente puede buscar y recuperar contenido de las aplicaciones conectadas que hayas habilitado para esa automatización con el fin de construir contexto para sus actualizaciones.
Para habilitar integraciones en una automatización, abre su configuración y selecciona las integraciones que quieres que el agente use en la sección **Available integrations**. Solo aparecen en la lista las integraciones ya conectadas para tu organización. Consulta [Gestionar automatizaciones](/es/automations/manage#integrations) para más detalles.
El agente solo accede a los datos de las integraciones cuando son relevantes para la tarea de la automatización. No lee de forma proactiva desde las aplicaciones conectadas.
## Permisos y acceso
Cada integración solicita los scopes de OAuth (o los permisos de clave API) que necesita para buscar y recuperar contenido de la aplicación conectada. Mintlify solicita scopes de solo lectura siempre que el proveedor los ofrezca.
Revisa los scopes exactos en la pantalla de consentimiento de OAuth antes de autorizar la conexión. La pantalla de consentimiento lista cada permiso que recibe la integración, y puedes revocar la conexión en cualquier momento desde el dashboard o desde la propia configuración de integraciones de la aplicación conectada.
Si tu organización restringe qué aplicaciones pueden autorizar los usuarios, pide al administrador correspondiente (como tu administrador de Slack o Google Workspace) que permita la integración de Mintlify antes de conectarla.
### Qué puede leer el agente de cada aplicación
El agente hereda el acceso de la cuenta que autorizó la conexión. Solo puede leer contenido al que el usuario que autoriza (para integraciones personales) o la cuenta del espacio de trabajo conectada (para integraciones compartidas) ya tiene acceso en la aplicación de origen.
| Integración | Contenido al que el agente puede acceder |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Confluence | Páginas y archivos adjuntos en los espacios que la cuenta conectada pueda leer |
| Google Calendar | Eventos en los calendarios que el usuario conectado pueda ver |
| Google Drive | Archivos y carpetas que el usuario conectado pueda ver, incluidas las unidades compartidas |
| HubSpot | Registros del CRM (contactos, empresas, ofertas, tickets) que la cuenta conectada pueda leer |
| Intercom | Conversaciones, contactos y artículos del centro de ayuda que la cuenta conectada pueda leer |
| Jira | Incidencias y comentarios en los proyectos que la cuenta conectada pueda leer |
| Linear | Incidencias, proyectos y comentarios en los equipos que la cuenta conectada pueda leer |
| Notion | Páginas y bases de datos compartidas explícitamente con la integración de Mintlify |
| Plain | Hilos y registros de clientes accesibles con la clave API proporcionada |
| Salesforce | Objetos estándar y personalizados que la cuenta conectada pueda leer |
| Slack | Canales públicos a los que el espacio de trabajo dé acceso, además de los canales privados a los que se invite a la app de Mintlify |
Para limitar lo que el agente puede ver, restringe los permisos de la cuenta conectada en la aplicación de origen. Por ejemplo, invita a la app de Slack de Mintlify solo a canales específicos o comparte solo páginas seleccionadas de Notion con la integración.
### Aprobar la app de Mintlify en Atlassian (Jira y Confluence)
Si tu organización de Atlassian restringe las apps del marketplace o las apps personalizadas, tu administrador de Atlassian debe aprobar la app de Mintlify antes de que alguien pueda conectar Jira o Confluence. Los usuarios que intenten conectarse sin aprobación verán un error de autorización en la pantalla de consentimiento de OAuth.
**Identidad de la app:**
* **Nombre de la app:** Mintlify
* **ID de la app:** `872a4b8e-9e83-474d-99f9-dc79112da145`
**Pasos para el administrador:**
1. Ve a [admin.atlassian.com](https://admin.atlassian.com) y abre tu organización.
2. Ve a **Security** > **Data protection** > **Data security policy**.
3. Revisa la opción **Marketplace and custom app access control**. Si aparece como **Blocked** o **Custom**, hay que permitir la app de Mintlify.
4. Edita la política y establece el control en **Allowed** o añade una excepción para la app de Mintlify usando el ID de la app indicado arriba.
5. Haz clic en **Activate** para aplicar la política.
Una vez que la política esté activa, un administrador o editor puede completar la conexión de Jira o Confluence desde la página de [Integraciones](https://app.mintlify.com/settings/organization/integrations).
#### Scopes de OAuth que Mintlify solicita
Mintlify usa el flujo de OAuth 2.0 (3LO) de Atlassian y solicita scopes de solo lectura para que el agente de automatización pueda buscar y leer los tickets o páginas que necesita para fundamentar sus actualizaciones. Mintlify no solicita scopes de escritura, eliminación ni de administrador.
**Scopes de Jira:**
| Scope | Por qué lo necesita Mintlify |
| ---------------- | ------------------------------------------------------------------------------------------------ |
| `read:jira-user` | Resolver a autores, asignados y comentaristas de incidencias a nombres legibles |
| `read:jira-work` | Leer incidencias, comentarios, proyectos y resultados de búsqueda JQL que ve la cuenta conectada |
| `offline_access` | Renovar el token de acceso de OAuth para que la conexión siga funcionando sin volver a autorizar |
**Scopes de Confluence:**
| Scope | Por qué lo necesita Mintlify |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `read:confluence-content.all` | Leer el contenido y los archivos adjuntos de las páginas en los espacios a los que la cuenta conectada tiene acceso |
| `read:confluence-content.summary` | Buscar y previsualizar páginas antes de obtener el contenido completo |
| `read:confluence-space.summary` | Listar y resolver los espacios a los que la cuenta conectada tiene acceso |
| `read:confluence-user` | Resolver a autores y editores de páginas a nombres legibles |
| `offline_access` | Renovar el token de acceso de OAuth para que la conexión siga funcionando sin volver a autorizar |
La lista completa de scopes concedidos a la conexión se muestra en la pantalla de consentimiento de OAuth de Atlassian cuando un usuario autoriza la integración por primera vez, y puede consultarse en cualquier momento en tu consola de administración de Atlassian en **Connected apps**.
#### Qué hace Mintlify con los datos
* **El acceso es de solo lectura.** Mintlify nunca crea, edita, transiciona ni elimina incidencias, comentarios, páginas ni archivos adjuntos.
* **El acceso se hereda del usuario que autoriza.** El agente solo puede ver proyectos y espacios a los que la cuenta de Atlassian conectada ya tiene acceso. Para limitar la visibilidad, restringe los permisos de proyecto y espacio de la cuenta conectada en Atlassian.
* **El acceso es bajo demanda.** El agente lee de Atlassian solo cuando una ejecución de automatización necesita ese contexto. Mintlify no rastrea ni replica Jira o Confluence en una copia duradera.
* **La revocación es inmediata.** Desconectar la integración en el dashboard de Mintlify, o revocar la app en la consola de administración de Atlassian, corta inmediatamente el acceso futuro.
## Retención de datos tras la desconexión
Cuando desconectas una integración, las automatizaciones pierden inmediatamente la capacidad de leer desde esa aplicación. Mintlify no conserva una copia duradera del contenido de las integraciones. El agente obtiene los datos en cada ejecución a través del token de OAuth activo o de la clave API, de modo que desconectar corta el acceso futuro.
El contenido que apareció en ejecuciones anteriores de automatizaciones o en pull requests permanece en su lugar (páginas publicadas, historial de PR). Edita o borra las páginas directamente si también quieres eliminar ese contenido.
## Solucionar problemas de una conexión fallida
Si una integración deja de funcionar o muestra un error en el dashboard, normalmente el token de OAuth subyacente expiró, la aplicación conectada lo revocó o sus scopes requeridos cambiaron.
Para restaurar el acceso:
1. Ve a la página [Integraciones](https://app.mintlify.com/settings/organization/integrations) en la configuración de tu dashboard.
2. Busca la integración afectada y haz clic en **Configure**.
3. Haz clic en **Disconnect**.
4. Haz clic en **Connect**.
5. Completa el flujo de OAuth.
Para proveedores basados en clave API como Plain, genera una nueva clave API en la aplicación de origen y pégala en la configuración de la integración. Si las automatizaciones siguen sin poder acceder a los datos después de reconectar, confirma que el usuario que autoriza tiene permiso para ver el contenido correspondiente en la aplicación de origen.
## Desconectar una integración
1. Ve a la página [Integraciones](https://app.mintlify.com/settings/organization/integrations) en la configuración de tu dashboard.
2. Busca la integración conectada que quieres desconectar.
3. Haz clic en **Configure**.
4. Haz clic en **Disconnect**.
Desconectar una integración compartida la elimina para todos los miembros de tu organización, y las automatizaciones pierden inmediatamente el acceso a esa herramienta.
Desconectar una integración personal solo elimina tu propia conexión. Otros compañeros que hayan conectado la misma integración conservan su acceso.