'text': 'This is a line of text. And this is another one.' That is, you can include marked up URLs, user links, channel links and commands, but we will still linkify any non-linked URLs present in your message. If a label is present it should be used.īy default, messages you pass to API methods and webhooks will be assumed to be pre-formatted based on the above spec. Unrecognized commands can be output as-is, with the enclosing brackets to indicate something about More commands will be added in the future. User group IDs can be determined from the usergroups.list API endpoint. These indicate a user group message, and should cause a notification to be displayed by the client. ).įor paid teams there is an additional command for user groups that follows theįormat. Note that to display on older mobile clients you will need to specify a label with the command (eg. These indicate an or message, and should cause a notification to be displayed by the client. Currently defined commandsĪre !channel, !group, !here, and !everyone (group is just a synonym for channel - both can be used in channels and groups). For these we use theįormat, where foo is a special command. Some messages contain special words with extra behavior. For example, 🌊 is F0 9F 8C 8A in hex and further URL-encoded as %F0%9F%8C%8A. Unicode characters, like many emojis and accent characters, should be presented in URL-encoded hex. When sending messages using URL or POST-based parameters, as you may with chat.postMessage and similar approaches, you'll need to 'URL encode' the parameter value containing your message.

Of course, when you send your message using URL-encoding, you'll still need to URL encode the ampersand. Don't HTML entity-encode the entire message. There are three characters you must convert to HTML entities and only three: &. Messages can contain any displayable Unicode sequence of characters (all messages must use UTF-8 encoding), but need to be slightly escaped by clients.īefore sending messages to Slack, clients should make the following transforms: How to escape characters 3 Characters you must encode as HTML entities For instructions on formatting messages within Slack itself, consult this help center article. These formatting instructions pertain to content posted programmatically to Slack. All text in Slack uses the same system of escaping: chat messages, direct messages, file comments, etc.

Slack message formatting