Docs

Integrations / Chat / Slack

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 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.

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 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 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.

Something wrong or missing? Report an issue · View as Markdown