> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/slack-integration.md).

# Slack Integration

Order Desk can integrate with Slack to send messages from the Order Desk app to your channels. Using the Rule Builder, you can specify what information you would like shared with which channel, along with the conditions and actions that will trigger it.

### Setup

To enable Slack in your Order Desk store, click on **Manage Integrations** in the left sidebar. Under the **Productivity** tab, find and enable **Slack**.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FgpBok4Z0h6RocTnvTzTc%2Flegacy-ff38e52f9cdbdd630af4.png?alt=media)

Alternatively, search for Slack from the available integration search.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F3nZODdZu7wpakcLzAt0c%2Flegacy-27782c61ac241c896057.png?alt=media)

Click the green **Connect to Slack** button, and follow the prompts to add to Order Desk to your Slack account.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FH1HqLJm1QTrJH3BoBObY%2Flegacy-fd139c1ecb4f16d41d42.png?alt=media)

### Using the Rule Builder

If you’re not familiar with the Rule Builder, we recommend checking out our [quick start](/start-here/getting-started-series/quick-start-how-customizable-is-order-desk-really.md#the-order-desk-rule-builder) guide first to go over the basics.

Once Slack has been successfully connected in your integration settings, your Rule Builder will be updated with two new actions.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fd3l7KQj34EUzA4NeGYe6%2Flegacy-dd22ca4ca7c708c2811b.png?alt=media)

**Send Notification to User on Slack** will allow you to select which user you would like to notify with the rule, along with what message you would like to send them.

Similarly, with **Send Notification to Channel on Slack** you can select which channel you’d like to send a notification to.

The Message field for both actions can be customized to say whatever you’d like. This field supports [twig](https://twig.symfony.com/doc/2.x/) to add individual variables from your orders to the message, along with the option to mention a specific user by formatting their Slack name as **@name** or a specific channel using **!channel**.

**PLEASE NOTE:**

In order to use **<** **@USERID>** to mention a specific user, the name must be the **user ID**, not the display name.

You can view a complete list of order details that you can use as variables [here](/resources/order-desk-field-names.md).

### Using Private Slack Channels

The Slack API does support receiving automated messages in private channels, however one step needs to be taken to ensure it works properly.

Open the Slack channel in which you’d like to receive messages from Order Desk. Then, type `/invite @Order Desk` to invite the Order Desk integration to the channel.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/slack-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.