diff --git a/agent/slack.mdx b/agent/slack.mdx index 5bf7c569b..ddeeec8a2 100644 --- a/agent/slack.mdx +++ b/agent/slack.mdx @@ -50,7 +50,28 @@ After you connect your Slack workspace, you can ask the agent in Slack to set up You must configure GitHub and GitLab through Mintlify, not Composio. Use the [GitHub app](/deploy/github) or [GitLab integration](/deploy/gitlab) to control which repositories the agent can access. -To add a new integration from Slack: +### One-click connect from the welcome DM + +When you first install the Mintlify Slack app, the agent sends you a welcome direct message. If your organization has the agent enabled, the message includes one-click **Connect** buttons for the most common integrations: + +- Notion +- Linear +- Gmail +- Salesforce +- Google Calendar + +To connect a service: + +1. Open the agent's direct message in Slack. +2. Click the **Connect** button for the service you want to add. +3. In the modal, click the authorization link, sign in to the third-party service, and approve the requested permissions. +4. Return to Slack. The agent confirms the connection and can immediately use the integration as context for future requests. + +The buttons only appear for services you have not connected yet. Once a connection becomes active, the corresponding button no longer shows up on subsequent prompts. + +### Ask the agent to connect any service + +For services that are not in the one-click list, ask the agent to set up the integration: 1. In a direct message or a thread that mentions `@mintlify`, ask the agent to set up the integration. For example: - "Connect Jira so you can read tickets." diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx index 80b6f9803..93f5f9f0b 100644 --- a/es/agent/slack.mdx +++ b/es/agent/slack.mdx @@ -44,7 +44,28 @@ Una vez conectado tu espacio de trabajo de Slack, puedes pedirle al agente en Sl GitHub y GitLab no se configuran a través de Composio. El acceso a los repositorios se gestiona mediante la [GitHub App de Mintlify](/es/deploy/github) o la [integración con GitLab](/es/deploy/gitlab) instalada desde tu panel. Una vez instalada, el agente puede leer el código fuente de cualquier repositorio al que la aplicación tenga acceso. -Para añadir una nueva integración desde Slack: +### Conexión con un clic desde el DM de bienvenida + +Cuando instalas la app de Slack de Mintlify por primera vez, el agente te envía un mensaje directo de bienvenida. Si tu organización tiene el agente habilitado, el mensaje incluye botones **Connect** de un solo clic para las integraciones más comunes: + +- Notion +- Linear +- Gmail +- Salesforce +- Google Calendar + +Para conectar un servicio: + +1. Abre el mensaje directo del agente en Slack. +2. Haz clic en el botón **Connect** del servicio que quieras añadir. +3. En el modal, haz clic en el enlace de autorización, inicia sesión en el servicio de terceros y aprueba los permisos solicitados. +4. Vuelve a Slack. El agente confirma la conexión y puede usar inmediatamente la integración como contexto para futuras solicitudes. + +Los botones solo aparecen para los servicios que aún no has conectado. Cuando una conexión está activa, su botón deja de mostrarse en los mensajes posteriores. + +### Pedirle al agente que conecte cualquier servicio + +Para servicios que no estén en la lista de un clic, pídele al agente que configure la integración: 1. En un mensaje directo o en un hilo que mencione `@mintlify`, pídele al agente que configure la integración. Por ejemplo: - "Conecta Jira para que puedas leer los tickets." diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx index 7119fbbb4..420532327 100644 --- a/fr/agent/slack.mdx +++ b/fr/agent/slack.mdx @@ -45,7 +45,28 @@ Une fois votre espace de travail Slack connecté, vous pouvez demander à l'agen GitHub et GitLab ne sont pas configurés via Composio. L'accès aux référentiels est géré par la [GitHub App Mintlify](/fr/deploy/github) ou l'[intégration GitLab](/fr/deploy/gitlab) installée depuis votre tableau de bord. Une fois installée, l'agent peut lire le code source de tout référentiel auquel l'application a accès. -Pour ajouter une nouvelle intégration depuis Slack : +### Connexion en un clic depuis le DM de bienvenue + +Lorsque vous installez pour la première fois l'application Slack Mintlify, l'agent vous envoie un message direct de bienvenue. Si votre organisation a l'agent activé, le message inclut des boutons **Connect** en un clic pour les intégrations les plus courantes : + +- Notion +- Linear +- Gmail +- Salesforce +- Google Calendar + +Pour connecter un service : + +1. Ouvrez le message direct de l'agent dans Slack. +2. Cliquez sur le bouton **Connect** pour le service que vous souhaitez ajouter. +3. Dans la fenêtre modale, cliquez sur le lien d'autorisation, connectez-vous au service tiers et approuvez les autorisations demandées. +4. Retournez dans Slack. L'agent confirme la connexion et peut immédiatement utiliser l'intégration comme contexte pour les futures demandes. + +Les boutons n'apparaissent que pour les services que vous n'avez pas encore connectés. Une fois la connexion active, le bouton correspondant ne s'affiche plus dans les messages suivants. + +### Demander à l'agent de connecter n'importe quel service + +Pour les services qui ne figurent pas dans la liste en un clic, demandez à l'agent de configurer l'intégration : 1. Dans un message direct ou dans un fil qui mentionne `@mintlify`, demandez à l'agent de configurer l'intégration. Par exemple : - « Connecte Jira pour que tu puisses lire les tickets. » diff --git a/zh/agent/slack.mdx b/zh/agent/slack.mdx index ad0271e44..1aac1aa62 100644 --- a/zh/agent/slack.mdx +++ b/zh/agent/slack.mdx @@ -41,7 +41,28 @@ keywords: ["Slack 集成", "Slack 机器人", "团队协作", "agent 集成", " GitHub 和 GitLab 不通过 Composio 配置。仓库访问由从控制台安装的 [Mintlify GitHub App](/zh/deploy/github) 或 [GitLab 集成](/zh/deploy/gitlab)管理。安装后，agent 可以读取该应用有权访问的任何仓库的源代码。 -要从 Slack 添加新的集成： +### 从欢迎私信一键连接 + +首次安装 Mintlify Slack 应用时，agent 会向你发送一条欢迎私信。如果你的组织已启用 agent，该消息会包含针对常用集成的一键 **Connect** 按钮： + +- Notion +- Linear +- Gmail +- Salesforce +- Google Calendar + +要连接某项服务： + +1. 在 Slack 中打开 agent 的私信。 +2. 点击你要添加的服务对应的 **Connect** 按钮。 +3. 在弹出的模态框中，点击授权链接，登录第三方服务，并批准所请求的权限。 +4. 返回 Slack。Agent 会确认连接成功，并立即可以将该集成用作后续请求的上下文。 + +按钮只会显示在你尚未连接的服务上。一旦某个连接变为活动状态，对应的按钮就不会出现在后续的提示中。 + +### 让 agent 连接任意服务 + +对于不在一键列表中的服务，让 agent 设置该集成： 1. 在私信中，或在提及 `@mintlify` 的线程中，让 agent 设置该集成。例如： - "连接 Jira，以便你可以读取工单。"