> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-mintlify-999c9ea9.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraciones del agente

> Conecta Slack, Notion, Linear, Jira, Confluence y otras apps para que el agente use contexto en vivo al responder preguntas y actualizar contenido.

Las integraciones del agente dan al agente acceso al contexto de otras herramientas que utiliza tu equipo. Una vez conectadas, el agente puede buscar en hilos de Slack, leer páginas de Notion, consultar incidencias de Linear y obtener contexto desde otras aplicaciones para fundamentar sus respuestas y actualizaciones de contenido.

<div id="connection-scope">
  ## Alcance de la conexión
</div>

Las integraciones se conectan de una de dos formas:

* **Las integraciones compartidas** se conectan una sola vez para toda tu organización. Cualquier miembro del equipo puede pedirle al agente que las use. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom y Plain se conectan todas de esta manera.
* **Las integraciones personales** se conectan por usuario. Cada miembro autoriza su propia cuenta, y el agente solo puede usar una integración personal en nombre del usuario que la conectó. Google Calendar es personal.

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.

<div id="connect-an-integration">
  ## Conectar una integración
</div>

1. Ve a la página [Integraciones del agente](https://app.mintlify.com/settings/organization/integrations) en 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, y los proveedores basados en clave API como Plain te piden que pegues una clave API.

Los administradores y editores pueden conectar integraciones compartidas en nombre de la organización. Cada miembro del equipo conecta las integraciones personales individualmente: conectar Google Calendar solo lo habilita para tus propias solicitudes, no para el resto de tu organización.

<div id="supported-integrations">
  ## Integraciones compatibles
</div>

| Integración     | Alcance    |
| --------------- | ---------- |
| Confluence      | Compartida |
| Google Calendar | Personal   |
| Intercom        | Compartida |
| Jira            | Compartida |
| Linear          | Compartida |
| Notion          | Compartida |
| Plain           | Compartida |
| Salesforce      | Compartida |
| Slack           | Compartida |

<div id="how-the-agent-uses-integrations">
  ## Cómo usa el agente las integraciones
</div>

El agente usa las integraciones conectadas como herramientas. Cuando le haces una pregunta al agente o le asignas una tarea, puede buscar y recuperar contenido de tus aplicaciones conectadas para construir contexto.

Por ejemplo:

* "Resume el hilo de Slack sobre la migración a la API v2 y redáctalo para la base de conocimientos."
* "Revisa el ticket de Linear para esta funcionalidad y documenta su comportamiento."
* "¿Qué decidió el equipo sobre los límites de velocidad? Revisa Slack."

El agente solo accede a los datos de las integraciones cuando son relevantes para la solicitud. No lee de forma proactiva desde las aplicaciones conectadas.

<div id="permissions-and-access">
  ## Permisos y acceso
</div>

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 tendrá el agente, 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.

<div id="what-the-agent-can-read-from-each-app">
  ### Qué puede leer el agente de cada aplicación
</div>

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).

<div id="data-retention-after-disconnect">
  ## Retención de datos tras la desconexión
</div>

Cuando desconectas una integración, el agente pierde 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 solicitud 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 respuestas anteriores del agente o en pull requests permanece en su lugar (transcripciones de chat, páginas publicadas, historial de PR). Si también quieres eliminar ese contenido, edita o borra las páginas y conversaciones directamente.

<div id="troubleshoot-a-failed-connection">
  ## Solucionar problemas de una conexión fallida
</div>

Si una integración deja de funcionar o muestra un error en el dashboard, normalmente el token de OAuth subyacente ha expirado, ha sido revocado en la aplicación conectada o se han modificado los scopes requeridos.

Para restaurar el acceso:

1. Ve a la página [Integraciones del agente](https://app.mintlify.com/settings/organization/integrations) en tu dashboard.
2. Busca la integración afectada y haz clic en **Configure**.
3. Haz clic en **Disconnect**, luego en **Connect** de nuevo, y 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 el agente sigue 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.

<div id="disconnect-an-integration">
  ## Desconectar una integración
</div>

1. Ve a la página [Integraciones del agente](https://app.mintlify.com/settings/organization/integrations) en 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 el agente pierde el acceso a esa herramienta de inmediato.

Desconectar una integración personal solo elimina tu propia conexión. Los demás miembros del equipo que hayan conectado la misma integración conservan su acceso, y el agente puede seguir usando la integración en su nombre.