From aee1dcf968f24820b9b31d2bbcd5640c80b88c96 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 12 Nov 2026 00:52:01 +0000 Subject: [PATCH] docs: translate Slack Integrations page connect steps (es, fr, zh) --- es/agent/slack.mdx | 21 +++++++++++++-------- es/automations/integrations.mdx | 4 +++- fr/agent/slack.mdx | 21 +++++++++++++-------- fr/automations/integrations.mdx | 4 +++- zh/agent/slack.mdx | 21 +++++++++++++-------- zh/automations/integrations.mdx | 4 +++- 6 files changed, 48 insertions(+), 27 deletions(-) diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 773bd58df9..80ca64d394 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -21,33 +21,34 @@ El agente de Slack funciona con [Autopilot](/es/autopilot). Cuando Autopilot pub + El agente de Slack no está disponible para proyectos en [Bitbucket Cloud](/es/deploy/bitbucket). + Si el propietario de tu espacio de trabajo de Slack requiere aprobación de administrador para instalar aplicaciones, pídele que apruebe la aplicación de Mintlify antes de conectarla. Cada espacio de trabajo de Slack solo puede conectarse a una organización de Mintlify a la vez. Si intentas instalar el agente en un espacio de trabajo que ya está conectado a otra organización, la instalación falla con un error de «wrong organization». Desinstala primero la app de la otra organización, o utiliza un espacio de trabajo de Slack diferente. Puedes instalar el agente de Slack incluso si no tienes un proyecto alojado en Mintlify. El agente sigue funcionando para responder preguntas y mantener conversaciones. Las funciones que abren solicitudes de extracción requieren un repositorio conectado. + + Si tu proveedor Git está detrás de una lista de IPs permitidas, autoriza la IP de salida `54.242.90.151` de Mintlify para que el agente pueda clonar tu repositorio. Contacta con soporte para activarlo. 1. Abre la configuración de [Automatizaciones](https://app.mintlify.com/settings/project/automations). 2. Haz clic en **Connect Slack**. 3. Sigue las indicaciones de Slack para instalar la app `mintlify` en tu espacio de trabajo y conceder los permisos solicitados. -4. Confirma en tu panel de Mintlify la conexión con tu espacio de trabajo de Slack. -5. Verifica que el agente esté funcionando y responda cuando: +4. Verifica que el agente responda cuando: - Le envíes un mensaje en su pestaña **Chat**. - Menciones al agente con `@mintlify` en un canal. + + En los planes Enterprise, también puedes empezar desde la página de [Integraciones](https://app.mintlify.com/settings/organization/integrations) en la configuración de tu panel. Haz clic en **Connect** junto a Slack y continúa desde el paso 3. + + En Slack Enterprise Grid, debes instalar la app en el espacio de trabajo específico en el que quieras usar el agente. Si omites este paso, el agente aparece como disponible a nivel de organización, pero no responde en tu espacio de trabajo. Para añadir la app a un espacio de trabajo, abre la página de gestión de apps de tu organización (una URL como `https://app.slack.com/manage//integrations/installed`). Busca la app `mintlify` e instálala en tu espacio de trabajo. - - El agente de Slack no está disponible para proyectos en [Bitbucket Cloud](/es/deploy/bitbucket). - - Si tu proveedor Git está detrás de una lista de IPs permitidas, autoriza la IP de salida `54.242.90.151` de Mintlify para que el agente pueda clonar tu repositorio. Contacta con soporte para activarlo. - -
### Desconectar el agente
@@ -60,6 +61,10 @@ Para eliminar el agente de tu espacio de trabajo de Slack: 4. En Slack, ve a **Manage apps**. 5. Haz clic en **Remove** en la app de Mintlify. + + En los planes Enterprise, también puedes empezar desde la página de [Integraciones](https://app.mintlify.com/settings/organization/integrations). Haz clic en **Configure** junto a Slack, haz clic en **Disconnect** y confirma, y luego continúa desde el paso 4. + + Cuando desconectas la app de Slack, el agente deja de responder a menciones y mensajes directos, y las automatizaciones que publican en Slack dejan de entregar notificaciones.
diff --git a/es/automations/integrations.mdx b/es/automations/integrations.mdx index 942a2214b4..e14faebee9 100644 --- a/es/automations/integrations.mdx +++ b/es/automations/integrations.mdx @@ -18,7 +18,7 @@ Las integraciones conectan el agente de Mintlify con las herramientas que ya usa | **Activador de automatización** | Inicia una automatización personalizada cuando ocurre un evento compatible en una integración compartida, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. | - La [app de Mintlify para Slack](/es/agent/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 el campo **Integrations** de una automatización, pero puedes seleccionarlo como activador de una automatización personalizada una vez instalada la app de Slack. + La [app de Mintlify para Slack](/es/agent/slack) funciona de forma distinta a 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. Puedes instalarla desde la página de configuración **Integrations**, pero no puedes seleccionar Slack en el campo **Integrations** de una automatización. Una vez instalada la app de Slack, puedes seleccionarla como activador de una automatización personalizada.
@@ -169,6 +169,8 @@ El agente hereda el acceso de la cuenta que autorizó la conexión. Para limitar 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. +Para desconectar Slack, consulta [Desconectar el agente](/es/agent/slack#disconnect-the-agent). +
## Solucionar problemas de conexión
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 8fff12e04f..a739b1dad8 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -21,33 +21,34 @@ L'agent Slack fonctionne avec [Autopilot](/fr/autopilot). Lorsque Autopilot publ
+ L'agent Slack n'est pas disponible pour les projets [Bitbucket Cloud](/fr/deploy/bitbucket). + Si le propriétaire de votre espace de travail Slack exige l'approbation d'un administrateur pour installer des applications, demandez-lui d'approuver l'application Mintlify avant de la connecter. Chaque espace de travail Slack ne peut être connecté qu'à une seule organisation Mintlify à la fois. Si vous tentez d'installer l'agent dans un espace de travail déjà connecté à une autre organisation, l'installation échoue avec une erreur « wrong organization ». Désinstallez d'abord l'application de l'autre organisation, ou utilisez un autre espace de travail Slack. Vous pouvez installer l'agent Slack même si vous n'avez pas de projet hébergé par Mintlify. L'agent fonctionne toujours pour répondre aux questions et tenir des conversations. Les fonctionnalités qui ouvrent des pull requests nécessitent un dépôt connecté. + + Si votre fournisseur Git se trouve derrière une liste d'IP autorisées, autorisez l'IP de sortie Mintlify `54.242.90.151` afin que l'agent puisse cloner votre dépôt. Contactez le support pour activer cette option. 1. Ouvrez les paramètres [Automatisations](https://app.mintlify.com/settings/project/automations). 2. Cliquez sur **Connect Slack**. 3. Suivez les instructions Slack pour installer l'application `mintlify` dans votre espace de travail et accorder les autorisations demandées. -4. Confirmez dans votre dashboard Mintlify la connexion à votre espace de travail Slack. -5. Vérifiez que l'agent fonctionne et répond lorsque vous : +4. Vérifiez que l'agent répond lorsque vous : - Lui envoyez un message dans son onglet **Chat**. - Mentionnez l'agent avec `@mintlify` dans un canal. + + Avec les forfaits Enterprise, vous pouvez aussi commencer depuis la page [Intégrations](https://app.mintlify.com/settings/organization/integrations) des paramètres de votre dashboard. Cliquez sur **Connect** à côté de Slack, puis reprenez à l'étape 3. + + Sur Slack Enterprise Grid, vous devez installer l'application dans l'espace de travail spécifique où vous souhaitez utiliser l'agent. Si vous omettez cette étape, l'agent apparaît comme disponible au niveau de l'organisation, mais ne répond pas dans votre espace de travail. Pour ajouter l'application à un espace de travail, ouvrez la page de gestion des applications de votre organisation (une URL telle que `https://app.slack.com/manage//integrations/installed`). Trouvez l'application `mintlify` et installez-la dans votre espace de travail. - - L'agent Slack n'est pas disponible pour les projets [Bitbucket Cloud](/fr/deploy/bitbucket). - - Si votre fournisseur Git se trouve derrière une liste d'IP autorisées, autorisez l'IP de sortie Mintlify `54.242.90.151` afin que l'agent puisse cloner votre dépôt. Contactez le support pour activer cette option. - -
### Déconnecter l'agent
@@ -60,6 +61,10 @@ Pour supprimer l'agent de votre espace de travail Slack : 4. Dans Slack, accédez à **Manage apps**. 5. Cliquez sur **Remove** pour l'application Mintlify. + + Avec les forfaits Enterprise, vous pouvez aussi commencer depuis la page [Intégrations](https://app.mintlify.com/settings/organization/integrations). Cliquez sur **Configure** à côté de Slack, cliquez sur **Disconnect** et confirmez, puis reprenez à l'étape 4. + + Lorsque vous déconnectez l'application Slack, l'agent cesse de répondre aux mentions et aux messages directs, et les automatisations qui publient dans Slack cessent de délivrer des notifications.
diff --git a/fr/automations/integrations.mdx b/fr/automations/integrations.mdx index 6dfdaad65e..fddd59e75b 100644 --- a/fr/automations/integrations.mdx +++ b/fr/automations/integrations.mdx @@ -18,7 +18,7 @@ Les intégrations connectent l'agent Mintlify aux outils déjà utilisés par vo | **Déclencheur d'automatisation** | Lance une automatisation personnalisée lorsqu'un événement pris en charge se produit dans une intégration partagée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. | - L'[application Slack Mintlify](/fr/agent/slack) est distincte des intégrations tierces de cette page. Son installation ajoute l'agent à votre espace de travail et donne à l'agent et aux exécutions d'automatisations accès au contenu Slack que l'application peut lire. Slack ne se connecte pas depuis **Integrations** et ne se sélectionne pas dans le champ **Integrations** d'une automatisation, mais vous pouvez le sélectionner comme déclencheur d'une automatisation personnalisée une fois l'application Slack installée. + L'[application Slack Mintlify](/fr/agent/slack) fonctionne différemment des intégrations tierces de cette page. Son installation ajoute l'agent à votre espace de travail et donne à l'agent et aux exécutions d'automatisations accès au contenu Slack que l'application peut lire. Vous pouvez l'installer depuis la page de paramètres **Integrations**, mais vous ne pouvez pas sélectionner Slack dans le champ **Integrations** d'une automatisation. Une fois l'application Slack installée, vous pouvez la sélectionner comme déclencheur d'une automatisation personnalisée.
@@ -169,6 +169,8 @@ L'agent hérite des accès du compte qui a autorisé la connexion. Pour les limi La déconnexion d'une intégration partagée la supprime pour toute l'organisation et arrête les nouveaux événements des automatisations qui l'utilisent comme déclencheur. La déconnexion d'une intégration personnelle ne supprime que votre connexion. +Pour déconnecter Slack, consultez [Déconnecter l'agent](/fr/agent/slack#disconnect-the-agent). +
## Résoudre un problème de connexion
diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index 54d56c4825..e3c9887249 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -21,33 +21,34 @@ Slack agent 基于 [Autopilot](/zh/autopilot) 运行。当 Autopilot 在 Slack
+ Slack agent 不支持 [Bitbucket Cloud](/zh/deploy/bitbucket) 项目。 + 如果你的 Slack 工作区所有者要求安装应用需先经管理员批准，请先请他们批准 Mintlify 应用，然后再进行连接。 每个 Slack 工作区一次只能连接到一个 Mintlify 组织。如果你尝试将 agent 安装到已经连接到其他组织的工作区，安装会失败并提示 “wrong organization” 错误。请先从其他组织卸载该应用，或使用其他 Slack 工作区。 即使你没有 Mintlify 托管的项目，也可以安装 Slack agent。agent 仍可用于问答和对话。会打开 pull request 的功能需要已连接的仓库。 + + 如果你的 Git 提供方位于 IP 允许列表之后，请允许 Mintlify 出站 IP `54.242.90.151`，以便 agent 能够克隆你的仓库。请联系支持团队以启用。 1. 打开你的 [Automations](https://app.mintlify.com/settings/project/automations) 设置。 2. 点击 **Connect Slack**。 3. 按照 Slack 的提示将 `mintlify` 应用安装到你的工作区，并授予所请求的权限。 -4. 在你的 Mintlify dashboard 中确认与 Slack 工作区的连接。 -5. 测试 agent 是否正常工作，并在你执行以下操作时是否会响应： +4. 测试 agent 在你执行以下操作时是否会响应： - 在它的 **Chat** 标签页中向它发送消息。 - 在频道中使用 `@mintlify` 提及 agent。 + + 在 Enterprise 套餐中，你也可以从 dashboard 设置中的 [Integrations](https://app.mintlify.com/settings/organization/integrations) 页面开始。点击 Slack 旁边的 **Connect**，然后从第 3 步继续。 + + 在 Slack Enterprise Grid 上，你必须将应用安装到你想要使用 agent 的具体工作区。如果跳过此步骤，agent 会在组织级别显示为可用，但不会在你的工作区中响应。 要将应用添加到工作区，请打开你组织的应用管理页面（URL 类似 `https://app.slack.com/manage//integrations/installed`）。找到 `mintlify` 应用并将其安装到你的工作区。 - - Slack agent 不支持 [Bitbucket Cloud](/zh/deploy/bitbucket) 项目。 - - 如果你的 Git 提供方位于 IP 允许列表之后，请允许 Mintlify 出站 IP `54.242.90.151`，以便 agent 能够克隆你的仓库。请联系支持团队以启用。 - -
### 断开 agent 连接
@@ -60,6 +61,10 @@ Slack agent 基于 [Autopilot](/zh/autopilot) 运行。当 Autopilot 在 Slack 4. 在 Slack 中，前往 **Manage apps**。 5. 在 Mintlify 应用上点击 **Remove**。 + + 在 Enterprise 套餐中，你也可以从 [Integrations](https://app.mintlify.com/settings/organization/integrations) 页面开始。点击 Slack 旁边的 **Configure**，点击 **Disconnect** 并确认，然后从第 4 步继续。 + + 断开 Slack 应用连接后，agent 将停止响应提及和私信，向 Slack 发布消息的自动化也将停止发送通知。
diff --git a/zh/automations/integrations.mdx b/zh/automations/integrations.mdx index 8d5557c614..1c18efb0a6 100644 --- a/zh/automations/integrations.mdx +++ b/zh/automations/integrations.mdx @@ -18,7 +18,7 @@ keywords: ["集成", "Slack agent", "Notion", "Linear", "Jira", "LaunchDarkly", | **自动化触发器** | 当受支持的共享集成中发生所选事件时，或当在所选 Slack 频道中发布新的顶层消息时，启动自定义自动化。 | - [Mintlify Slack 应用](/zh/agent/slack)与本页中的第三方集成相互独立。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你不需要在 **Integrations** 中连接 Slack，也不需要在自动化的 **Integrations** 字段中选择它，但在安装 Slack 应用后，你可以将其选为自定义自动化的触发器。 + [Mintlify Slack 应用](/zh/agent/slack)的工作方式与本页中的第三方集成不同。安装 Slack 应用会将 agent 添加到工作区，并让 agent 和自动化运行访问该应用获准读取的 Slack 内容。你可以从 **Integrations** 设置页面安装它，但不能在自动化的 **Integrations** 字段中选择 Slack。安装 Slack 应用后，你可以将其选为自定义自动化的触发器。
@@ -169,6 +169,8 @@ Agent 会继承授权连接的账户所拥有的访问权限。若要缩小访 断开共享集成会为整个组织移除该集成，并停止将其用作触发器的自动化接收新事件。断开个人集成只会移除你自己的连接。 +要断开 Slack 连接，请参阅[断开 agent 连接](/zh/agent/slack#disconnect-the-agent)。 +
## 排查连接问题