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. |
La app de Mintlify para 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.
- 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.
Los administradores y editores pueden conectar integraciones compartidas para la organización. Cada miembro conecta sus propias integraciones personales.
Desde el dashboard
- Ve a la página Integrations en la configuración.
- Busca la integración y haz clic en Connect.
- 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.
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í |
Después de instalar la app de Mintlify para 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.
Las herramientas proporcionan contexto adicional después de iniciar una automatización. Solo se pueden seleccionar integraciones compartidas.
- Abre la configuración de la automatización.
- En Tools, selecciona las integraciones que puede usar.
- Conecta cualquier integración seleccionada que aún no esté conectada.
- 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.
- Crea o abre una automatización personalizada.
- En Trigger, selecciona Integration.
- Selecciona o conecta una integración compartida.
- Selecciona el Trigger event y completa los campos adicionales.
- 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.
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.
- Ve a la página Integrations.
- Haz clic en Configure para la integración.
- 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.
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.