# Send Slack DM

Sends a direct message to a Slack user from a runbook

Sends a direct message to any Slack user from within a runbook. Use it to notify someone who isn't in the ticket thread — a manager, an approver, an app owner, or the subject of a request — without creating a channel or pulling them into the conversation.

## How It Works

1. The agent provides two things: a **message** and a **recipient**.
2. The recipient can be specified three ways: an **email address**, a **user-identity link** (a person Risotto already knows from the ticket context, like the requestor's manager), or a **Slack user ID**.
3. Risotto validates that the recipient exists in Slack, opens a DM conversation with them, and sends the message.

The DM is sent from whichever Slack app the tool is configured to use — see Authentication below.

## Authentication

This tool can send from either of two apps, in this order of precedence:

1. **Slack Tools connector** (recommended): if the connector is set up on the **Tools app** card of **Settings → Integrations → Slack**, the DM is sent from your connector app. Follow the [Slack Tools Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup) guide to configure it.
2. **Default Risotto chat app** — without a connector, the DM is sent from the same Slack app that handles your ticket conversations.

A per-tool **bot token override** is also available in the tool's configuration for sending from a different workspace or app entirely; when using an override, you must also set the **Team ID**. Per-tool tokens take precedence over the connector.

> **Tip:** For high-volume automation, use the Slack Tools connector with a dedicated
> custom app rather than the default Risotto chat app — a dedicated app avoids
> rate-limiting issues when many DMs go out.

> **Warning:** **Check for the missing-scopes banner before relying on this tool.** Sending
> DMs requires messaging scopes in your Slack app's manifest, and this tool
> shipped more recently than most. If your Slack Tools connector app predates
> it, the tool's page in the dashboard shows a **Missing scopes** banner: *"The
> Slack tools app is missing required scopes. Reconnect it on the Slack page."*
> Follow it: click the link in the banner, or go to **Settings → Integrations →
> Slack**, then click **Connected** on the **Tools app** card and choose
> **Reconnect...**, per the [Slack Tools
> Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#reconnecting-the-connector) guide.
> If you send from a **custom Risotto chat app** instead, update its manifest by
> following the [Update Slack App](https://www.tryrisotto.com/docs/guides/update-slack-app) guide. No
> other changes are required.

## Example Runbook Uses

- Notify a manager that their report submitted a request needing their approval context
- Tell an application owner that access was granted to their app
- Send onboarding instructions to a new hire identified from an HRIS lifecycle event
- Let the subject of a ticket know an action was taken on their behalf (e.g. "your account was unlocked")

## Limitations

- The message is a one-way notification — replies to the DM don't flow back into the ticket or resume the runbook. To collect a structured response mid-conversation, use [Send Slack Form](https://www.tryrisotto.com/docs/integrations/tools/slack/send_form) instead.
- The recipient must exist in your Slack workspace — the tool validates this before sending and fails if the user can't be found.

## Troubleshooting

### Recipient not found

The tool validates the recipient against Slack before sending. If lookup fails, confirm the email matches the person's Slack account email exactly, or use their Slack user ID directly. If referencing a person from ticket context (like a manager), confirm Risotto's identity for that person includes a Slack account.

### Missing-scopes banner on the tool page

Your Slack Tools connector app's manifest predates a scope this tool needs.
Click the link in the banner, or go to **Settings → Integrations → Slack**,
then click **Connected** on the **Tools app** card and choose
**Reconnect...**, per the [Slack Tools
Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup#reconnecting-the-connector) guide.

### DMs are delayed or dropped at high volume

This is Slack rate limiting on the sending app. Move the tool to a dedicated Slack Tools connector app rather than the default Risotto chat app, which shares its rate limit with all your ticket conversations.

## Related

- [Slack Tools Setup](https://www.tryrisotto.com/docs/integrations/tools/slack/setup)
- [Send Slack Form](https://www.tryrisotto.com/docs/integrations/tools/slack/send_form) — to collect structured responses instead of sending a one-way message

Source: https://www.tryrisotto.com/docs/integrations/tools/slack/send_dm
