> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/slack.md). # Slack ## Connection When you're setting up your first workflow with Slack, you'll need to connect your Slack account with MESA. Click on the **Connect with Slack** button to begin the process.

Screenshot of the MESA workflow builder Slack connection setup, click Connect with Slack to begin the process. Spotlight the Connect with Slack button.

You will then see this permission screen. Click **Allow.**

Screenshot of the Slack permission screen requesting access for MESA, click Allow. Spotlight the Allow button.

Afterward, you can re-use the newly created connection in your future workflows! ### Inviting the @Mesa Slack bot to your channel In Slack, invite the `@Mesa` user to the channel you would like to post in. Type "@Mesa" in a new message and click the **Invite Them** button. Slack will confirm that the user has been added. ## Configure ### Using Slack Triggers Slack [triggers](https://docs.getmesa.com/workflow-builder/triggers) require a separate Slack bot called MESA Triggers, which listens to the channels where it’s added. This means there is a distinction between connections used for MESA Slack Triggers and those used for MESA Slack Actions. In Slack, invite the `@MESA Triggers` user to the channel you would like to trigger from. Type "@MESA Triggers" in a new message and click the **Invite Them** button. Slack will confirm that the user has been added. Additionally, we recommend not adding the MESA Triggers bot to the same channel as the regular MESA bot especially if you're using MESA to send messages to that channel. Doing so can create [infinite loops](https://docs.getmesa.com/best-practices/avoid-infinite-loops). ### Selecting the channel to post to In MESA, open the **Step Configuration** section of your Slack step. In the **Channel** field, type the first couple letters of your channel name and it should appear in the list. If your channel's name is not appearing in the list, **please make sure** that the `@MESA` user has been invited to the channel.

Screenshot of the MESA Slack step Step Configuration, typing a channel name into the Channel field to select it from the list. Spotlight the Channel field.

You can also manually enter your channel name by clicking "Custom value".

Screenshot of the MESA Slack step Channel field, manually entering the channel name using Custom value. Spotlight the Custom value option.

### Customize your Slack message with Variables [Variables can be understood](/workflow-builder/fields/variables.md) as a placeholder that will be filled in at the time a workflow runs with actual data. You can click on the **{+}** button in the **Message** field to select variables. Here is an example of how you could customize your Slack message.

Screenshot of the MESA Slack step Message field showing an example message customized with variables. Spotlight the Message field.

### Formatting Messages [Slack's mrkdwn formatting](https://api.slack.com/reference/surfaces/formatting#basics) can be used to add links, make text bold or italic, add lists and more. Emojis can be added with the colon syntax, for example: `:thumbsup:` will be displayed as 👍. Refer to Slack's documentation for more details. #### Mentioning a specific team member in a Slack message To mention a specific person or bot in slack, just wrap their @ handle in brackets: `<@johndoe>`. For example, this message:

Screenshot of the MESA Slack step Message field showing a message that mentions a team member using a bracketed @ handle. Spotlight the Message field.