Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Automation integrations"
sidebarTitle: "Integrations"
description: "Connect Slack, Notion, Linear, Jira, Confluence, and other apps so automations can pull live context from the tools your team uses."
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "HubSpot", "Plain", "Pylon", "context", "automations", "Nango"]
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "OneDrive", "OneNote", "Excel", "Gmail", "Outlook", "HubSpot", "Contentful", "Figma", "Plain", "Pylon", "context", "automations", "Nango"]

Check warning on line 5 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L5

Did you really mean 'Contentful'?

Check warning on line 5 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L5

Did you really mean 'Figma'?
---

<Info>
Expand All @@ -15,14 +15,16 @@

Integrations connect in one of two ways:

- **Shared integrations** connect once for your entire organization and are available to your automations. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Plain, and Pylon all connect this way.
- **Personal integrations** connect per user. Each teammate authorizes their own account. Google Calendar and Google Drive are personal.
- **Shared integrations** connect once for your entire organization and are available to every automation and teammate. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Contentful, Figma, Plain, and Pylon all connect this way.

Check warning on line 18 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L18

Did you really mean 'Contentful'?

Check warning on line 18 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L18

Did you really mean 'Figma'?
- **Personal integrations** connect per user. Each teammate authorizes their own account, and the agent acts as whoever the current request is running for. Google Calendar, Google Drive, OneDrive, OneNote, Excel, Gmail, and Outlook are personal.

Personal integrations keep user-specific data, like calendar events, scoped to the user who connected the integration instead of shared across the organization.
Personal integrations keep user-specific data, like calendar events and inbox contents, scoped to the user who connected the integration instead of shared across the organization. There is no cap on the number of teammates who can connect a personal integration.

When the Slack agent handles a message, it uses the sender's own personal connections and switches per sender across a thread. If the sender has not connected a personal integration that the agent needs, the agent asks them to connect it before continuing.

## Connect an integration

Admins and editors can connect shared integrations on behalf of the organization.
Admins and editors can connect shared integrations on behalf of the organization. Any teammate can connect a personal integration for themselves.

1. Go to the [Integrations](https://app.mintlify.com/settings/organization/integrations) page in your dashboard settings.
2. Find the integration you want to connect.
Expand All @@ -36,13 +38,20 @@
| Integration | Scope |
| --- | --- |
| Confluence | Shared |
| Contentful | Shared |

Check warning on line 41 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L41

Did you really mean 'Contentful'?
| Excel | Personal |
| Figma | Shared |

Check warning on line 43 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L43

Did you really mean 'Figma'?
| Gmail | Personal |
| Google Calendar | Personal |
| Google Drive | Personal |
| HubSpot | Shared |
| Intercom | Shared |
| Jira | Shared |
| Linear | Shared |
| Notion | Shared |
| OneDrive | Personal |
| OneNote | Personal |
| Outlook | Personal |
| Plain | Shared |
| Pylon | Shared |
| Salesforce | Shared |
Expand Down Expand Up @@ -71,13 +80,20 @@
| Integration | Content the agent can access |
| --- | --- |
| Confluence | Pages and attachments in spaces the connected account can read |
| Contentful | Spaces, environments, entries, and assets the connected account can read |
| Excel | Workbooks, worksheets, tables, and ranges the connected user can open |
| Figma | Files, projects, components, and comments the connected account can read |
| Gmail | Messages, threads, drafts, labels, and contacts in the connected user's mailbox |
| Google Calendar | Events on calendars the connected user can view |
| Google Drive | Files and folders the connected user can view, including shared drives |
| HubSpot | CRM records (contacts, companies, deals, tickets) the connected account can read |
| Intercom | Conversations, contacts, and help center articles the connected account can read |
| Jira | Issues and comments in projects the connected account can read |
| Linear | Issues, projects, and comments in teams the connected account can read |
| Notion | Pages and databases explicitly shared with the Mintlify integration |
| OneDrive | Files, folders, and drives the connected user can access |
| OneNote | Notebooks, sections, and pages the connected user can open |
| Outlook | Messages, mail folders, calendars, and events in the connected user's account |
| Plain | Threads and customer records accessible with the provided API key |
| Pylon | Issues, conversations, and customer records accessible with the provided API key |
| Salesforce | Standard and custom objects the connected account can read |
Expand All @@ -98,8 +114,8 @@

1. Go to [admin.atlassian.com](https://admin.atlassian.com) and open your organization.
2. Go to **Security** > **Data protection** > **Data security policy**.
3. Check the **Marketplace and custom app access control** setting. If it shows **Blocked** or **Custom**, the Mintlify app needs to be allowed.

Check warning on line 117 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L117

In general, use active voice instead of passive voice ('be allowed').
4. Edit the policy and either set the control to **Allowed**, or add an override for the Mintlify app using the app ID above.

Check warning on line 118 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L118

Use 'preceding' instead of 'above'.
5. Click **Activate** to apply the policy.

After the policy is active, an admin or editor can complete the Jira or Confluence connection from the [Integrations](https://app.mintlify.com/settings/organization/integrations) page.
Expand All @@ -113,7 +129,7 @@
| Scope | Why Mintlify needs it |
| --------------------------- | ---------------------------------------------------------------------------------- |
| `read:jira-user` | Resolve issue authors, assignees, and commenters to human-readable names |
| `read:jira-work` | Read issues, comments, projects, and JQL search results the connected account sees |

Check warning on line 132 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L132

Spell out 'JQL', if it's unfamiliar to the audience.
| `offline_access` | Refresh the OAuth access token so the connection keeps working without re-consent |

**Confluence scopes:**
Expand All @@ -126,12 +142,12 @@
| `read:confluence-user` | Resolve page authors and editors to human-readable names |
| `offline_access` | Refresh the OAuth access token so the connection keeps working without re-consent |

The full list of scopes granted to the connection is shown on the Atlassian OAuth consent screen when a user first authorizes the integration, and can be reviewed at any time in your Atlassian admin console under **Connected apps**.

Check warning on line 145 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L145

In general, use active voice instead of passive voice ('is shown').

Check warning on line 145 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L145

In general, use active voice instead of passive voice ('be reviewed').

#### What Mintlify does with the data

* **Access is read-only.** Mintlify never creates, edits, transitions, or deletes issues, comments, pages, or attachments.

Check warning on line 149 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L149

In general, use active voice instead of passive voice ('is read').
* **Access is inherited from the authorizing user.** The agent can only see projects and spaces that the connected Atlassian account already has access to. To narrow visibility, restrict the connected account's project and space permissions in Atlassian.

Check warning on line 150 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L150

In general, use active voice instead of passive voice ('is inherited').
* **Access is on-demand.** The agent reads from Atlassian only when an automation run needs that context. Mintlify does not crawl or mirror Jira or Confluence into a durable copy.
* **Revocation is instant.** Disconnecting the integration in the Mintlify dashboard, or revoking the app in Atlassian admin, immediately cuts off future access.

Expand Down
26 changes: 21 additions & 5 deletions es/automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Integraciones de automatizaciones"
sidebarTitle: "Integraciones"
description: "Conecta Slack, Notion, Linear, Jira, Confluence y otras apps para que las automatizaciones obtengan contexto en vivo desde las herramientas que usa tu equipo."
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "HubSpot", "Plain", "Pylon", "context", "automations", "Nango"]
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "OneDrive", "OneNote", "Excel", "Gmail", "Outlook", "HubSpot", "Contentful", "Figma", "Plain", "Pylon", "context", "automations", "Nango"]
---

<Info>
Expand All @@ -17,16 +17,18 @@ Las integraciones dan a las [automatizaciones](/es/automations/index) acceso al

Las integraciones se conectan de una de dos formas:

- **Las integraciones compartidas** se conectan una sola vez para toda tu organización y están disponibles para tus automatizaciones. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Plain y Pylon se conectan todas de esta manera.
- **Las integraciones personales** se conectan por usuario. Cada miembro autoriza su propia cuenta. Google Calendar y Google Drive son personales.
- **Las integraciones compartidas** se conectan una sola vez para toda tu organización y están disponibles para todas las automatizaciones y todos los miembros del equipo. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Contentful, Figma, Plain y Pylon se conectan todas de esta manera.
- **Las integraciones personales** se conectan por usuario. Cada miembro autoriza su propia cuenta, y el agente actúa en nombre de la persona para la que se está ejecutando la solicitud actual. Google Calendar, Google Drive, OneDrive, OneNote, Excel, Gmail y Outlook son personales.

Las integraciones personales mantienen los datos específicos del usuario, como los eventos del calendario, acotados al usuario que conectó la integración en lugar de compartirse en toda la organización.
Las integraciones personales mantienen los datos específicos del usuario, como los eventos del calendario y el contenido de la bandeja de entrada, acotados al usuario que conectó la integración en lugar de compartirse en toda la organización. No hay límite en la cantidad de miembros del equipo que pueden conectar una integración personal.

Cuando el agente de Slack gestiona un mensaje, utiliza las conexiones personales del propio remitente y cambia por remitente a lo largo de un hilo. Si el remitente no ha conectado una integración personal que el agente necesita, el agente le pide que la conecte antes de continuar.

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

Los administradores y editores pueden conectar integraciones compartidas en nombre de la organización.
Los administradores y editores pueden conectar integraciones compartidas en nombre de la organización. Cualquier miembro del equipo puede conectar una integración personal para sí mismo.

1. Ve a la página [Integraciones](https://app.mintlify.com/settings/organization/integrations) en la configuración de tu dashboard.
2. Busca la integración que quieres conectar.
Expand All @@ -42,13 +44,20 @@ Algunas integraciones abren un paso adicional de configuración antes de complet
| Integración | Alcance |
| --- | --- |
| Confluence | Compartida |
| Contentful | Compartida |
| Excel | Personal |
| Figma | Compartida |
| Gmail | Personal |
| Google Calendar | Personal |
| Google Drive | Personal |
| HubSpot | Compartida |
| Intercom | Compartida |
| Jira | Compartida |
| Linear | Compartida |
| Notion | Compartida |
| OneDrive | Personal |
| OneNote | Personal |
| Outlook | Personal |
| Plain | Compartida |
| Pylon | Compartida |
| Salesforce | Compartida |
Expand Down Expand Up @@ -83,13 +92,20 @@ El agente hereda el acceso de la cuenta que autorizó la conexión. Solo puede l
| Integración | Contenido al que el agente puede acceder |
| --- | --- |
| Confluence | Páginas y archivos adjuntos en los espacios que la cuenta conectada pueda leer |
| Contentful | Espacios, entornos, entradas y activos que la cuenta conectada pueda leer |
| Excel | Libros, hojas de cálculo, tablas y rangos que el usuario conectado pueda abrir |
| Figma | Archivos, proyectos, componentes y comentarios que la cuenta conectada pueda leer |
| Gmail | Mensajes, hilos, borradores, etiquetas y contactos en el buzón del usuario conectado |
| Google Calendar | Eventos en los calendarios que el usuario conectado pueda ver |
| Google Drive | Archivos y carpetas que el usuario conectado pueda ver, incluidas las unidades compartidas |
| HubSpot | Registros del CRM (contactos, empresas, ofertas, tickets) que la cuenta conectada pueda leer |
| Intercom | Conversaciones, contactos y artículos del centro de ayuda que la cuenta conectada pueda leer |
| Jira | Incidencias y comentarios en los proyectos que la cuenta conectada pueda leer |
| Linear | Incidencias, proyectos y comentarios en los equipos que la cuenta conectada pueda leer |
| Notion | Páginas y bases de datos compartidas explícitamente con la integración de Mintlify |
| OneDrive | Archivos, carpetas y unidades a los que el usuario conectado pueda acceder |
| OneNote | Blocs de notas, secciones y páginas que el usuario conectado pueda abrir |
| Outlook | Mensajes, carpetas de correo, calendarios y eventos en la cuenta del usuario conectado |
| Plain | Hilos y registros de clientes accesibles con la clave API proporcionada |
| Pylon | Incidencias, conversaciones y registros de clientes accesibles con la clave API proporcionada |
| Salesforce | Objetos estándar y personalizados que la cuenta conectada pueda leer |
Expand Down
24 changes: 20 additions & 4 deletions fr/automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Intégrations d'automatisation"
sidebarTitle: "Intégrations"
description: "Connectez Slack, Notion, Linear, Jira, Confluence et d'autres apps pour que les automatisations récupèrent du contexte depuis les outils de votre équipe."
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "HubSpot", "Plain", "Pylon", "context", "automations", "Nango"]
keywords: ["integrations", "Slack", "Notion", "Linear", "Jira", "Confluence", "Salesforce", "Intercom", "Google Calendar", "Google Drive", "OneDrive", "OneNote", "Excel", "Gmail", "Outlook", "HubSpot", "Contentful", "Figma", "Plain", "Pylon", "context", "automations", "Nango"]
---

<Info>
Expand All @@ -17,10 +17,12 @@ Les intégrations donnent aux [automatisations](/fr/automations/index) l'accès

Les intégrations se connectent de l'une des deux façons suivantes :

- **Les intégrations partagées** sont connectées une seule fois pour toute votre organisation et sont disponibles pour vos automatisations. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Plain et Pylon se connectent toutes de cette manière.
- **Les intégrations personnelles** sont connectées par utilisateur. Chaque coéquipier autorise son propre compte. Google Calendar et Google Drive sont personnelles.
- **Les intégrations partagées** sont connectées une seule fois pour toute votre organisation et sont disponibles pour vos automatisations. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, Contentful, Figma, Plain et Pylon se connectent toutes de cette manière.
- **Les intégrations personnelles** sont connectées par utilisateur. Chaque coéquipier autorise son propre compte, et l'agent agit au nom de la personne pour laquelle la requête en cours est exécutée. Google Calendar, Google Drive, OneDrive, OneNote, Excel, Gmail et Outlook sont personnelles.

Les intégrations personnelles maintiennent les données propres à un utilisateur, comme les événements de calendrier, limitées à l'utilisateur qui a connecté l'intégration, plutôt que partagées à l'échelle de l'organisation.
Les intégrations personnelles maintiennent les données propres à un utilisateur, comme les événements de calendrier et le contenu de la boîte de réception, limitées à l'utilisateur qui a connecté l'intégration, plutôt que partagées à l'échelle de l'organisation. Il n'y a pas de limite au nombre de coéquipiers qui peuvent connecter une intégration personnelle.

Lorsque l'agent Slack traite un message, il utilise les connexions personnelles de l'expéditeur et bascule d'un expéditeur à l'autre au fil d'un fil de discussion. Si l'expéditeur n'a pas connecté une intégration personnelle dont l'agent a besoin, l'agent lui demande de la connecter avant de poursuivre.

<div id="connect-an-integration">
## Connecter une intégration
Expand All @@ -42,13 +44,20 @@ Certaines intégrations ouvrent une étape de configuration supplémentaire avan
| Intégration | Portée |
| --- | --- |
| Confluence | Partagée |
| Contentful | Partagée |
| Excel | Personnelle |
| Figma | Partagée |
| Gmail | Personnelle |
| Google Calendar | Personnelle |
| Google Drive | Personnelle |
| HubSpot | Partagée |
| Intercom | Partagée |
| Jira | Partagée |
| Linear | Partagée |
| Notion | Partagée |
| OneDrive | Personnelle |
| OneNote | Personnelle |
| Outlook | Personnelle |
| Plain | Partagée |
| Pylon | Partagée |
| Salesforce | Partagée |
Expand Down Expand Up @@ -83,13 +92,20 @@ L'agent hérite des accès du compte qui a autorisé la connexion. Il ne peut li
| Intégration | Contenu auquel l'agent peut accéder |
| --- | --- |
| Confluence | Pages et pièces jointes dans les espaces que le compte connecté peut lire |
| Contentful | Espaces, environnements, entrées et assets que le compte connecté peut lire |
| Excel | Classeurs, feuilles de calcul, tableaux et plages que l'utilisateur connecté peut ouvrir |
| Figma | Fichiers, projets, composants et commentaires que le compte connecté peut lire |
| Gmail | Messages, fils, brouillons, libellés et contacts dans la boîte mail de l'utilisateur connecté |
| Google Calendar | Événements des calendriers que l'utilisateur connecté peut consulter |
| Google Drive | Fichiers et dossiers que l'utilisateur connecté peut consulter, y compris les Drive partagés |
| HubSpot | Enregistrements CRM (contacts, entreprises, transactions, tickets) que le compte connecté peut lire |
| Intercom | Conversations, contacts et articles du centre d'aide que le compte connecté peut lire |
| Jira | Tickets et commentaires des projets que le compte connecté peut lire |
| Linear | Tickets, projets et commentaires des équipes que le compte connecté peut lire |
| Notion | Pages et bases de données explicitement partagées avec l'intégration Mintlify |
| OneDrive | Fichiers, dossiers et drives auxquels l'utilisateur connecté peut accéder |
| OneNote | Notebooks, sections et pages que l'utilisateur connecté peut ouvrir |
| Outlook | Messages, dossiers de courrier, calendriers et événements dans le compte de l'utilisateur connecté |
| Plain | Fils et enregistrements clients accessibles avec la clé API fournie |
| Pylon | Tickets, conversations et enregistrements clients accessibles avec la clé API fournie |
| Salesforce | Objets standard et personnalisés que le compte connecté peut lire |
Expand Down
Loading