Skip to main content
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.
La app de Mintlify para Slack es independiente de las integraciones de terceros 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, pero puedes seleccionarlo como activador de una automatización personalizada una vez instalada la app de Slack.

​
Alcance de la conexión

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

​
Conectar una integración

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

​
Integraciones compatibles

El dashboard muestra las integraciones disponibles actualmente para tu organización. Algunas pueden publicarse de forma gradual. Pylon es una integración compartida y de solo lectura para atención al cliente. Úsala para buscar tickets de soporte y recuperar mensajes de tickets, detalles de cuentas, contactos o usuarios. Conecta Pylon desde la página Integrations. Después, úsala con el agente de Slack o selecciónala en Tools de una automatización.

​
Usar integraciones con el agente de Slack

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.

​
Usar integraciones como herramientas de automatización

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.

​
Activar una automatización desde una integración

  1. Crea o abre una automatización personalizada.
  2. En Trigger, selecciona Integration.
  3. Selecciona o conecta una integración compartida, o selecciona Slack.
  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. Cuando ocurre el evento, Mintlify inicia la automatización e incluye los datos del evento como contexto.

​
Activadores por mensaje de canal de Slack

Selecciona Slack como integración de activador para ejecutar una automatización personalizada cuando alguien publique un nuevo mensaje en un canal que elijas. Requiere que la app de Mintlify para Slack esté instalada y añadida a cada canal seleccionado.
  • Solo los mensajes de nivel superior en los canales seleccionados inician una ejecución. Se ignoran las respuestas en hilos y los mensajes que mencionan al agente de Mintlify.
  • El agente recibe el texto del mensaje, el canal, el remitente y un enlace permanente como contexto, y luego decide si el mensaje justifica una acción como actualizar la documentación. No todos los mensajes generan un cambio.
  • Puedes seleccionar varios canales en una misma automatización. Cada canal debe ser público o un canal privado al que se haya añadido la app de Mintlify.

​
Permisos y acceso

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.

​
Desconectar una integración

  1. Ve a la página 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.

​
Solucionar problemas de 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.