Skip to content

Shipped Channel Updates: document Slack message trigger for automations #7000

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
mintlify wants to merge 1 commit into from
+4 −2
Closed

Shipped Channel Updates: document Slack message trigger for automations #7000

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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/create.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ keywords: ["automation", "automate", "cron", "agent", "custom automation"]

import GitlabAutomationSetup from '/snippets/gitlab-automation-setup.mdx';

A custom automation runs the agent on a schedule, on repository pushes, or on connected integration events using instructions that you write. Use a custom automation when you need to automate a task that isn't covered by a [predefined automation](/automations/reference).
A custom automation runs the agent on a schedule, on repository pushes, on connected integration events, or on new Slack channel messages using instructions that you write. Use a custom automation when you need to automate a task that isn't covered by a [predefined automation](/automations/reference).

For an overview of triggers, update modes, and configuration options shared across all automations, see [Automations](/automations).

Expand Down
3 changes: 2 additions & 1 deletion automations/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,12 +22,13 @@ When an automation runs, the agent reads your project content and any connected

## Trigger types

Automations support four trigger types.
Automations support five trigger types.

- **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).
- **Slack message**: Runs when a teammate posts a top-level message in a selected Slack channel. The agent reads each new message and decides whether it warrants an action. Requires the [Mintlify Slack app](/agent/slack).

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

Expand Down
1 change: 1 addition & 0 deletions automations/manage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@
- **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.
- **Slack message**: Runs when a teammate posts a top-level message in one of the selected Slack channels. Available for custom automations. Requires the [Mintlify Slack app](/agent/slack). Select one or more channels to listen to. The trigger ignores thread replies, edits, and messages from bots or the Mintlify app itself. The agent reads each new message and decides whether to take action.

### Update mode

Expand Down Expand Up @@ -135,7 +136,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 139 in automations/manage.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

automations/manage.mdx#L139 

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