Skip to navigation

Direct Message

View as Markdown

The Direct Message node sends a private message to one Slack user. Use it to reach the right person directly, such as the owner of an account or the teammate who needs to act, rather than posting to a whole channel. The message can be fixed text or built from values the run gathered.

When to use it

  • You want to notify one specific person, like the account owner for a new lead.
  • The message is meant for an individual rather than a whole team.
  • You want a quiet nudge that does not clutter a shared channel.

Inputs

FieldWhat it’s forExample
RecipientThe Slack user to message.The account owner’s Slack user
MessageThe text of the message.New renewal completed for Marcus Johnson.
Bot TokenThe stored credential that lets the workflow message on Slack, kept as a secret.slack_bot_token

The message can be written as an expression or a string template so it reflects what the run did.

Outputs

The Direct Message node reports whether the message was sent. There is no other value to read back. If it fails, you can route the run to handle the problem.

Example

When a renewal is completed for Marcus Johnson, a workflow sends a direct message to the agent who owns his account, letting them know it is done and ready for follow-up. Because it goes straight to that one person, it lands as a personal nudge rather than another post in a busy channel.

The Direct Message configuration panel, showing the recipient, message, and connection fields.

Open Bot Token and select a secret containing your Slack Bot User OAuth Token. To save it here, choose Create secret…, enter a name such as slack_bot_token and the token value, then click Create Secret. The builder automatically selects the new secret. See Secrets for managing and rotating the credential.