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

# Integraciones para el agente y las automatizaciones

> Conecta aplicaciones de terceros para que el agente de Mintlify use contexto en Slack, en ejecuciones de automatizaciones o como activador.

Las integraciones conectan el agente de Mintlify con las herramientas que ya usa tu equipo. El agente puede usar aplicaciones conectadas al responder en Slack o al ejecutar una automatización. Los eventos de algunas integraciones compartidas también pueden iniciar una automatización personalizada.

| Dónde se usa                      | Cómo funciona                                                                                             |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Agente de Slack**               | Usa las integraciones compartidas y las integraciones personales del miembro que habla con el agente.     |
| **Herramienta de automatización** | Proporciona contexto de solo lectura desde las integraciones compartidas seleccionadas en **Tools**.      |
| **Activador de automatización**   | Inicia una automatización personalizada cuando ocurre un evento compatible en una integración compartida. |

<Note>
  La [app de Mintlify para Slack](/es/agent/slack) es independiente de las integraciones de esta página. Instalarla añade el agente a tu espacio de trabajo y da al agente y a las ejecuciones de automatizaciones acceso al contenido de Slack que la app puede leer. Slack no se conecta desde **Integrations** ni se selecciona en **Tools**.
</Note>

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

* Las **integraciones compartidas** se conectan una vez para toda la organización. El agente de Slack puede usarlas, puedes añadirlas como herramientas de automatización y, si proporcionan eventos, pueden activar automatizaciones personalizadas.
* Las **integraciones personales** se conectan por miembro. El agente de Slack usa la cuenta personal de quien habla con él. No pueden añadirse a automatizaciones como herramientas ni activadores.

Por ejemplo, si dos miembros conectan cuentas distintas de Google Drive, cada uno recibe resultados de su propia cuenta al pedir información al agente en Slack.

No hay límite en la cantidad de miembros que pueden conectar sus propias cuentas. En un hilo de Slack con varios participantes, el agente usa las integraciones personales del remitente de cada mensaje.

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

Los administradores y editores pueden conectar integraciones compartidas para la organización. Cada miembro conecta sus propias integraciones personales.

### Desde el dashboard

1. Ve a la página [Integrations](https://app.mintlify.com/settings/organization/integrations) en la configuración.
2. Busca la integración y haz clic en **Connect**.
3. Completa el flujo de autorización.

También puedes seleccionar una aplicación no conectada en el campo **Tools** de una automatización y autorizarla desde allí.

### Desde el agente de Slack

Pide al agente que conecte una aplicación, por ejemplo: «Conecta mi Google Drive». Completa el enlace de autorización que devuelve y envía otro mensaje en el mismo hilo para que el agente confirme y use la conexión.

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

El dashboard muestra las integraciones disponibles actualmente para tu organización. Algunas pueden publicarse de forma gradual.

| Integración  | Alcance    | Activador de automatización |
| ------------ | ---------- | --------------------------- |
| Confluence   | Compartida | Sí                          |
| Contentful   | Compartida | No                          |
| Excel        | Personal   | No                          |
| Figma        | Compartida | No                          |
| Gmail        | Personal   | No                          |
| Google Drive | Personal   | No                          |
| HubSpot      | Compartida | No                          |
| Intercom     | Compartida | No                          |
| Jira         | Compartida | Sí                          |
| Linear       | Compartida | Sí                          |
| Notion       | Compartida | Sí                          |
| OneDrive     | Personal   | No                          |
| OneNote      | Personal   | No                          |
| Outlook      | Personal   | No                          |
| Plain        | Compartida | No                          |
| Salesforce   | Compartida | No                          |
| Zendesk      | Compartida | Sí                          |

<div id="use-integrations-with-the-slack-agent">
  ## Usar integraciones con el agente de Slack
</div>

Después de instalar la [app de Mintlify para Slack](/es/agent/slack), el agente puede usar integraciones al responder preguntas o actualizar tu documentación. No tienes que seleccionar integraciones para cada conversación.

El agente puede usar:

* Integraciones compartidas conectadas a tu organización.
* Integraciones personales conectadas por quien envía la solicitud.
* Canales e hilos de Slack que la app de Mintlify tenga permiso para leer.

El agente solo accede a los datos cuando son relevantes para la solicitud.

<div id="use-integrations-as-automation-tools">
  ## Usar integraciones como herramientas de automatización
</div>

Las herramientas proporcionan contexto adicional después de iniciar una automatización. Solo se pueden seleccionar integraciones compartidas.

1. Abre la configuración de la automatización.
2. En **Tools**, selecciona las integraciones que puede usar.
3. Conecta cualquier integración seleccionada que aún no esté conectada.
4. Guarda la automatización.

La integración utilizada como activador se incluye automáticamente como herramienta para que el agente pueda recuperar más detalles después de recibir el evento.

<div id="trigger-an-automation-from-an-integration">
  ## Activar una automatización desde una integración
</div>

1. Crea o abre una automatización personalizada.
2. En **Trigger**, selecciona **Integration**.
3. Selecciona o conecta una integración compartida.
4. Selecciona el **Trigger event** y completa los campos adicionales.
5. Guarda y activa la automatización.

Cada automatización tiene un solo activador. Seleccionar **Integration** reemplaza un activador de actualización de contenido, cambio de código o programación personalizada.

| Integración | Eventos                                                                                         |
| ----------- | ----------------------------------------------------------------------------------------------- |
| Confluence  | Página creada; contenido añadido a un espacio                                                   |
| Jira        | Incidencia creada; incidencia actualizada; proyecto creado                                      |
| Linear      | Incidencia creada; incidencia actualizada; proyecto creado; actualización de proyecto publicada |
| Notion      | Página creada; contenido de página actualizado                                                  |
| Zendesk     | Ticket creado                                                                                   |

Cuando ocurre el evento, Mintlify inicia la automatización e incluye los datos del evento como contexto.

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

Las herramientas de integraciones de terceros disponibles para el agente son de solo lectura. El agente puede buscar y recuperar contenido, pero no crear, editar ni eliminar datos en la aplicación conectada.

El agente hereda el acceso de la cuenta que autorizó la conexión. Para limitarlo, restringe los permisos de esa cuenta o concede acceso a la app de Mintlify solo a recursos específicos. Revisa la pantalla de autorización para ver los permisos exactos antes de conectar una aplicación.

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

1. Ve a la página [Integrations](https://app.mintlify.com/settings/organization/integrations).
2. Haz clic en **Configure** para la integración.
3. Haz clic en **Disable integration**.

Desconectar una integración compartida la elimina para toda la organización y detiene los nuevos eventos de las automatizaciones que la usan como activador. Desconectar una integración personal solo elimina tu conexión.

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

Confirma que la cuenta autorizada aún puede acceder al contenido, desconecta y vuelve a conectar la integración, y completa de nuevo la autorización. Si la conexión es para el agente de Slack, envía otro mensaje en el hilo original. Si la autorización está bloqueada, pide a tu administrador de aplicaciones o del espacio de trabajo que apruebe Mintlify.
