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}
Markup editor
cdmdc_markupeditor_send-slack-user_trigger.png

See Also

Workflow Authoring Guide

Integration Guide