send-slack-user macro

Overview v7.3.0+ Data Center

The send-slack-user macro sends a Slack message to one or more specified users.

Where to use it?

Optional.

One or more send-slack-user macros can be put in a trigger macro.

Appfire Docs+ must installed and configured in the instance and connected to a Slack workspace.

Parameters

Parameter	Required	Default	Notes

Parameter

Required

Default

Notes

macro body

The message to display.

plain text

Accepts value references including metadata value references

The value reference values are rendered in the message body e.g. @pagetitle@ is rendered as the current page name.

user

Comma-separated list of Confluence user names or user group names

user=user1, user2,user3
user=groupname1, groupname2

Accepts value references for example user=@creator@, @user@

subject

Slack message subject to display.

plain text

The value reference values are rendered in the message subject e.g. @pagetitle@ is rendered as the current page name.

Example

The example sends a Slack message on a page approval event in the approval named Review.

The slack message is sent to the following users in Slack

the current user (using the @user@ value reference) - who is the user who approved the Review
the page author (using the @creator@ value reference)

Markup

{workflow:name=my workflow}
    {state:In Progress|approved=Approved}
        {approval:Review|assignable=true}
    {state}
    {state:Approved|final=true|updated=In Progress|hideselection=true}
    {state}
    {trigger:statechanged|state=Approved}
        {send-slack-user:user=@creator@|subject=:white_check_mark: Page approved: @pagetitle@}
        :unicorn_face: Congratulations, this [page|@page@] has been approved!!
        @page@
        Approved by @user@ on @Review>approvaldate@.
        Comment: @Review>approvalcomment@
        {send-slack-user}
    {trigger}
{workflow}