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
2 changes: 1 addition & 1 deletion automations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
- **Content update**: Runs when content changes push to your Mintlify project repository, including pull request merges and direct pushes.
- **Code change**: Runs when a pull request merges in a connected source code repository.
- **Custom schedule**: Runs on a recurring schedule. Automations queue within 10 minutes of the scheduled time.
- **Integration**: Runs when a selected event occurs in a connected shared integration. Requires an [Enterprise plan](https://mintlify.com/pricing?ref=automations).
- **Integration**: Runs when a selected event occurs in a connected shared integration, or when a new top-level message is posted in a selected Slack channel. Requires an [Enterprise plan](https://mintlify.com/pricing?ref=automations).

Check warning on line 30 in automations/index.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/index.mdx#L30

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

Each automation has exactly one trigger. You cannot combine trigger types in a single automation.

Expand Down
17 changes: 13 additions & 4 deletions automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@
| --- | --- |
| **Slack agent** | Uses shared integrations and the personal integrations of the teammate who is chatting with the agent as context. |
| **Automation tool** | Gives an automation read-only context from the shared integrations selected in its **Tools** setting. |
| **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration. |
| **Automation trigger** | Starts a custom automation when a selected event occurs in a supported shared integration, or when a new top-level message is posted in a selected Slack channel. |

Check warning on line 14 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L14

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

<Note>
The [Mintlify Slack app](/agent/slack) is separate from the integrations on this page. Installing the Slack app adds the agent to your workspace and gives the agent and automation runs access to Slack content that the app can read. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Tools** field.
The [Mintlify Slack app](/agent/slack) is separate from the third-party integrations on this page. Installing the Slack app adds the agent to your workspace and gives the agent and automation runs access to Slack content that the app can read. You do not connect Slack from the **Integrations** settings page or select it in an automation's **Tools** field, but you can select it as a custom automation trigger once the Slack app is installed.

Check warning on line 17 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L17

In general, use active voice instead of passive voice ('is installed').
</Note>

## Connection scope
Expand Down Expand Up @@ -101,11 +101,11 @@

## Trigger an automation from an integration

Custom automations can run when an event occurs in a supported shared integration.
Custom automations can run when an event occurs in a supported shared integration, or when a new message is posted in a selected Slack channel.

Check warning on line 104 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L104

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

1. Create or open a custom automation.
2. For **Trigger**, select **Integration**.
3. Select or connect a shared integration.
3. Select or connect a shared integration, or select **Slack**.
4. Select the **Trigger event**.
5. Complete any additional event fields that appear.
6. Save and turn on the automation.
Expand All @@ -118,11 +118,20 @@
| Jira | Issue created; issue updated; project created |
| Linear | Issue created; issue updated; project created; project update posted |
| Notion | Page created; page content updated |
| Slack | New message in a selected channel |
| Stripe | Product created |
| Zendesk | Ticket created |

When the event occurs, Mintlify starts the automation and includes the event payload as context for the agent. Duplicate deliveries of the same event do not start duplicate runs.

### Slack channel message triggers

Select **Slack** as the trigger integration to run a custom automation when someone posts a new message in a channel you pick. Requires the [Mintlify Slack app](/agent/slack) to be installed and added to each channel you select.

Check warning on line 129 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L129

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

- Only top-level messages in the selected channels start a run. Thread replies and messages that mention the Mintlify agent are ignored.

Check warning on line 131 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L131

In general, use active voice instead of passive voice ('are ignored').
- The agent receives the message text, channel, sender, and a permalink as context, then decides whether the message warrants an action such as a documentation update. Not every message produces a change.
- You can select multiple channels in one automation. Each channel must be a public channel or a private channel that the Mintlify app has been added to.

Check warning on line 133 in automations/integrations.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/integrations.mdx#L133

In general, use active voice instead of passive voice ('been added').

## Permissions and access

The agent has read-only access through third-party integration tools. It can search and retrieve content, but it cannot use these tools to create, edit, or delete data in the connected app.
Expand Down
2 changes: 1 addition & 1 deletion automations/manage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@
- **Content update**: Runs whenever you push content to your project repository, including pull request merges and direct pushes.
- **Code change**: Runs when a pull request merges in a connected source code repository. You must specify at least one source repository.
- **Custom schedule**: Runs on a recurring schedule you define. Automations queue within 10 minutes of the scheduled time.
- **Integration**: Runs when a selected event occurs in a connected shared integration. Available for custom automations. Select the integration and event, then complete any additional event fields that appear.
- **Integration**: Runs when a selected event occurs in a connected shared integration, or when a new top-level message is posted in a selected Slack channel. Available for custom automations. Select the integration and event, then complete any additional event fields that appear. For Slack triggers, pick one or more channels the [Mintlify Slack app](/agent/slack) has been added to.

Check warning on line 47 in automations/manage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/manage.mdx#L47

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

Check warning on line 47 in automations/manage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/manage.mdx#L47

In general, use active voice instead of passive voice ('been added').

### Update mode

Expand Down Expand Up @@ -135,7 +135,7 @@

Each run shows one of the following statuses:

- **Review needed**: The agent finished the run, but the changes must be reviewed and merged by someone on your team.

Check warning on line 138 in automations/manage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/manage.mdx#L138

In general, use active voice instead of passive voice ('be reviewed').
- **Running**: The agent is actively working on the automation job.
- **Accepted**: The agent finished the run and the changes merged into your repository.
- **Closed**: The agent finished the run, but someone rejected the changes.
Expand Down
2 changes: 1 addition & 1 deletion es/automations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Las automatizaciones admiten cuatro tipos de activadores.
- **Actualización de contenido**: se ejecuta cuando se hacen pushes con cambios de contenido al repositorio de tu proyecto de Mintlify, incluidas las fusiones de pull requests y los pushes directos.
- **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado.
- **Programación personalizada**: se ejecuta de forma recurrente. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada. Está disponible para automatizaciones personalizadas.
- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas.

Cada automatización tiene exactamente un activador. No puedes combinar tipos de activadores en una sola automatización.

Expand Down
17 changes: 14 additions & 3 deletions es/automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@ Las integraciones conectan el agente de Mintlify con las herramientas que ya usa
| --- | --- |
| **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. |
| **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. |

<Note>
La [app de Mintlify para Slack](/es/agent/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**.
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 **Tools**, pero puedes seleccionarlo como activador de una automatización personalizada una vez instalada la app de Slack.
</Note>

<div id="connection-scope">
Expand Down Expand Up @@ -116,7 +116,7 @@ La integración utilizada como activador se incluye automáticamente como herram

1. Crea o abre una automatización personalizada.
2. En **Trigger**, selecciona **Integration**.
3. Selecciona o conecta una integración compartida.
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.

Expand All @@ -128,11 +128,22 @@ Cada automatización tiene un solo activador. Seleccionar **Integration** reempl
| 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 |
| Slack | Nuevo mensaje en un canal seleccionado |
| Stripe | Producto creado |
| Zendesk | Ticket creado |

Cuando ocurre el evento, Mintlify inicia la automatización e incluye los datos del evento como contexto.

<div id="slack-channel-message-triggers">
### Activadores por mensaje de canal de Slack
</div>

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](/es/agent/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.

<div id="permissions-and-access">
## Permisos y acceso
</div>
Expand Down
2 changes: 1 addition & 1 deletion es/automations/manage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e
- **Actualización de contenido**: se ejecuta cada vez que envías contenido al repositorio de tu proyecto, incluidas las fusiones de pull requests y los pushes directos.
- **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen.
- **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada.
- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan.
- **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack).

<div id="update-mode">
### Modo de actualización
Expand Down
2 changes: 1 addition & 1 deletion fr/automations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Les automatisations prennent en charge quatre types de déclencheurs.
- **Mise à jour de contenu** : s'exécute lorsque des modifications de contenu sont poussées vers le dépôt de votre projet Mintlify, y compris les fusions de pull requests et les pushes directs.
- **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté.
- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée. Disponible pour les automatisations personnalisées.
- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées.

Chaque automatisation possède exactement un déclencheur. Vous ne pouvez pas combiner plusieurs types de déclencheurs dans une seule automatisation.

Expand Down
17 changes: 14 additions & 3 deletions fr/automations/integrations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@ Les intégrations connectent l'agent Mintlify aux outils déjà utilisés par vo
| --- | --- |
| **Agent Slack** | Utilise les intégrations partagées et les intégrations personnelles de la personne qui discute avec l'agent. |
| **Outil d'automatisation** | Fournit un contexte en lecture seule depuis les intégrations partagées sélectionnées dans **Tools**. |
| **Déclencheur d'automatisation** | Lance une automatisation personnalisée lorsqu'un événement pris en charge se produit dans une intégration partagée. |
| **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é. |

<Note>
L'[application Slack Mintlify](/fr/agent/slack) est distincte des intégrations 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 **Tools**.
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 **Tools**, mais vous pouvez le sélectionner comme déclencheur d'une automatisation personnalisée une fois l'application Slack installée.
</Note>

<div id="connection-scope">
Expand Down Expand Up @@ -116,7 +116,7 @@ L'intégration utilisée comme déclencheur est automatiquement incluse comme ou

1. Créez ou ouvrez une automatisation personnalisée.
2. Pour **Trigger**, sélectionnez **Integration**.
3. Sélectionnez ou connectez une intégration partagée.
3. Sélectionnez ou connectez une intégration partagée, ou sélectionnez **Slack**.
4. Sélectionnez le **Trigger event** et remplissez les champs supplémentaires.
5. Enregistrez et activez l'automatisation.

Expand All @@ -128,11 +128,22 @@ Chaque automatisation possède un seul déclencheur. **Integration** remplace un
| Jira | Ticket créé ; ticket mis à jour ; projet créé |
| Linear | Ticket créé ; ticket mis à jour ; projet créé ; mise à jour de projet publiée |
| Notion | Page créée ; contenu de page mis à jour |
| Slack | Nouveau message dans un canal sélectionné |
| Stripe | Produit créé |
| Zendesk | Ticket créé |

Lorsque l'événement se produit, Mintlify lance l'automatisation et inclut les données de l'événement comme contexte.

<div id="slack-channel-message-triggers">
### Déclencheurs sur message de canal Slack
</div>

Sélectionnez **Slack** comme intégration de déclenchement pour exécuter une automatisation personnalisée lorsqu'une personne publie un nouveau message dans un canal que vous choisissez. Requiert l'installation de l'[application Mintlify pour Slack](/fr/agent/slack) et son ajout à chaque canal sélectionné.

- Seuls les messages de premier niveau dans les canaux sélectionnés déclenchent une exécution. Les réponses dans un fil et les messages qui mentionnent l'agent Mintlify sont ignorés.
- L'agent reçoit le texte du message, le canal, l'expéditeur et un lien permanent comme contexte, puis décide si le message justifie une action telle qu'une mise à jour de la documentation. Tous les messages ne produisent pas de modification.
- Vous pouvez sélectionner plusieurs canaux dans une même automatisation. Chaque canal doit être public ou un canal privé auquel l'application Mintlify a été ajoutée.

<div id="permissions-and-access">
## Autorisations et accès
</div>
Expand Down
2 changes: 1 addition & 1 deletion fr/automations/manage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom
- **Mise à jour de contenu** : s'exécute chaque fois que vous poussez du contenu vers le dépôt de votre projet, y compris les fusions de pull requests et les pushes directs.
- **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source.
- **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée.
- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés.
- **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée.

<div id="update-mode">
### Mode de mise à jour
Expand Down
2 changes: 1 addition & 1 deletion zh/automations/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ boost: 5
- **内容更新(Content update)**:当内容推送到你的 Mintlify 项目仓库时运行,包括 pull request 合并和直接推送。
- **代码变更(Code change)**:当已连接的源代码仓库中有 pull request 合并时运行。
- **自定义计划(Custom schedule)**:按周期性计划运行。自动化会在预定时间的 10 分钟内进入队列。
- **集成(Integration)**:当已连接的共享集成中发生所选事件时运行。此选项适用于自定义自动化。
- **集成(Integration)**:当已连接的共享集成中发生所选事件时运行,或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。

每个自动化只能有一个触发器。你无法在单个自动化中组合多种触发器类型。

Expand Down
Loading