Message Slack User

Send the given message to the specified user on execution. No input table needs to be specified, if one is given it is passed through verbatim.

Users should ideally be identified by their unique ID which looks something like 'U011N55HKCL', these IDs can be fetched with the Get Users node. It is however possible to provide the display name in the same way you would identify a user when messaging in the slack app, for example @Person for the user with the display name of 'Person' - the @ must be included to indicate it's a display name and not an ID. Display names are not unique and if multiple users with the same display name are found the node will fail. Please note by providing display names an API call to users.list will be made to enable lookup of the user's unique ID which is a 'Web API Tier 2' method.

To message a group of users the channels:manage scope must be set. Multiple users should be specified as a comma separated list such as U011N55HKCL,U011XEN1RDW. It is possible to mix and match display names and user IDs such as: @Person,U011XEN1RDW. White space will be automatically trimmed.

API call details: https://api.slack.com/methods/conversations.open and https://api.slack.com/methods/chat.postMessage

Notes on username: By default the message will be sent and display with the apps name. If the chat:write:customize scope has been added then it is possible to set a username parameter. If changing the display name / username of the source of the message is desirable then check 'Set username' and provide the username to post the message as. The messages will however appear undo the app regardless of what username is set.

Rate Limiting: The underlying Java Slack API offers an async approach where it attempts to manage Rate Limits on API requests. This node node uses the aysnc version of the method and will send approximately 1 message per second.

Options

Bot OAuth token
The OAth token of the bot to post as
User ID(s)
The user to post to. To send to multiple users provide a comma seperated list of user IDs or display names. This value can be found in the ID column of the output table of the Get Users node.
Message
The message to post
Fail on error
Node will fail terminating workflow branch if checked. Uncheck to continue workflow if message can't be sent
Set username
Whether to use the custom provided username instead of bot name.
Username
A custom username to set, this will overide the default bot name. Ignored if Set username is not checked.

Input Ports

Icon
Any input data table.

Output Ports

Icon
The verbatim input table or an empty table if no input provided.

Popular Predecessors

  • DB Update12 %
  • Get Users8 %
  • CSV Writer7 %
  • String Manipulation6 %
  • Table Editor6 %
  • Variable Creator6 %
  • Message Slack channel (row based)5 %
  • Empty Table Switch5 %
  • Table Row to Variable4 %
  • Polynomial Regression Learner4 %
  • IF Switch4 %
  • Value Counter4 %
  • Variable Loop End4 %
  • Duplicate Row Filter4 %
  • Transfer Files4 %
  • Loop End4 %
  • Java Edit Variable2 %
  • Table Row to Variable2 %
  • String Manipulation (Variable)2 %
  • Table Column to Variable2 %
  • CASE Switch Variable (Start)2 %
  • Message Slack channel< 1 %
  • Table Row to Variable< 1 %
  • Table Row To Variable Loop Start< 1 %
  • Java Snippet< 1 %
  • Row Filter< 1 %
  • Rule Engine< 1 %
  • DB Writer< 1 %
  • Credentials Configuration< 1 %

Popular Successors

  • Generic Loop Start36 %
  • CASE Switch End36 %
  • Group Loop Start9 %
  • Parameter Optimization Loop End9 %
  • String Manipulation9 %

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.