Skip to main content

Slack compatibility

Mattermost makes it easy to migrate integrations written for Slack to Mattermost.

Translate Slack's data format to Mattermost​

Mattermost automatically translates the data coming from Slack:

  1. JSON responses written for Slack, that contain the following, are translated to Mattermost markdown and rendered equivalently to Slack:

    • <> to denote a URL link, such as {"text": "<https://mattermost.com/>"}.
    • | within a <> to define linked text, such as {"text": "Click <https://mattermost.com/|here> for a link."}.
    • <userid> to trigger a mention to a user, such as {"text": "<5fb5f7iw8tfrfcwssd1xmx3j7y> this is a notification."}.
    • <!channel>, <!here>, or <!all> to trigger a mention to a channel, such as {"text": "<!channel> this is a notification."}.

  2. Both the HTTP POST and GET request bodies sent to a web service are formatted the same as Slack's. This means your Slack integration's receiving function does not need change to be compatible with Mattermost.

Known Slack compatibility issues​

  • Using icon_emoji to override the username is not supported.
  • Referencing channels using <#CHANNEL_ID> does not link to the channel.
  • <!everyone> and <!group> are not supported.
  • Parameters mrkdwn, parse, and link_names are not supported (Mattermost always converts markdown and automatically links @mentions).
  • Bold formatting supplied as *bold* is not supported (must be done as **bold**).
  • Slack assumes default values for some fields if they are not specified by the integration, while Mattermost does not.