Custom Workflow Webhook Triggers

In addition to the default Slack workflow triggers Centro provides custom webhooks for initiating a Slack workflow. To use a workflow webhook create a Slack workflow that is triggered by a webhook and publish the workflow to generate a webhook URL. Paste the generated webhook URL in to the appropriate setting in Centro App Home. In the webhook workflow step add the expected variable names and types so that input variables can be used by the workflow steps.

List of Centro Webhook Events

Member join conversation

Triggered anytime a Slack member joins a public or private conversation where the Centro bot user is a member. As opposed to the default Slack trigger that must be published to a specific conversation this webhook can fire in multiple channels.

Webhook Variables:

channelid - Slack conversation ID that member joined (type Text)
userid - Slack member ID that joined conversation (type Slack user ID)

Webhook Variables

Salesforce Record linked

Triggered anytime a Salesforce record is linked to a Slack conversation or message either when using the Link to Salesforce message shortcut, from within Slack or from within Salesforce. This webhook only executes when the linking activity is performed by the current user. Each user may have distinct or shared webhooks and associated workflows. Contact Centro to mass deploy a webhook to multiple users or simply share the webhook URL with each user.

Webhook Variables:

channelid - Slack conversation ID record was linked to (type Text)
userid - Slack member Id that linked the record (type Slack user ID)
recordid - Salesforce Record Id (type Text)
message - message thread text specified when linked using message shortcut (type Text)
message_ts - timestamp identifier of message that was linked (type Text)
message_name - the name given to the message thread by the user (type Text)

Reply added to Salesforce Record Blocks

Triggered when a new reply from a non-bot user is added to Centro Salesforce Record Blocks message thread. This webhook fires once for an entire Slack workspace when a new reply is added to a notification from Centro that is linked to a Salesforce record. The Centro app must be present in the channel for the event to occur.

Webhook Variables:

channelid - Slack conversation where reply sent  (type Text)
userid - Slack member Id that sent reply (type Slack user ID)
username - if reply sent from LWC with Require Auth off Salesforce user name. (type Text)
recordid - Salesforce Record Id that started thread (type Text)
message - reply message text (type Text)
message_ts - timestamp identifier of message (type Text)
message_name - Salesforce record Name that started thread (type Text)
filenames - if any files were attached to the message, comma delimited list of filenames. (type Text)
fileids - if any files were attached to message, comma delimited list of Slack file IDs. (type Text)

Emoji reaction added to message

Triggered when an Emoji Reaction is added to a message. If the message is displaying Salesforce Record Blocks then the associated Salesforce Record Id will be passed in as a input variable. This webhook is shared by all users and executes in any conversation where the Centro bot is present when any user adds a reaction, enabling a single Workflow to be used in multiple conversations. Separate webhooks are available to differentiate if the reaction was added to a Centro Record Block message, a reply to a Record Block message, or generically for any Slack message. If no emoji is specified with the webhook then all emoji reactions will trigger the webhook.

Webhook Variables:

channelid - Slack conversation ID (type Text)
userid - Slack member Id (type Slack user ID)
recordid - Salesforce Record Id when message is related to a Salesforce record (type Text)
message - message text (type Text)
message_user - Slack member Id of user that sent message. (type Slack user ID)
message_ts - message timestamp (type Text)
message_name - the Salesforce record Name (type Text).
reaction - the emoji reaction name (type Text)

Custom Button Webhook

Custom Slack Workflow Webhook buttons can be added by Customizing Record Blocks or from the Salesforce Flow message action.

Webhook Variables:

channelid - Slack conversation ID button was clicked in (type Text)
userid - Slack member Id that clicked the button (type Slack user ID)
recordid - Salesforce Record ID specified only if linked or displaying record details (type Text)
message_ts - timestamp identifier of message that was clicked (type Text)
triggerid - optional to skip message prompt when using Show Form step. (type Text)

Custom Slash Command

Custom slash commands can be defined from Centro by @Centro mentioning the app, or typing `/centro` slash command from any conversation. Click the Customize button and define a custom button that invokes a Slack webhook-triggered Workflow. Specify a slash command name to expose the workflow as a Slack slash command that can be independently defined for internal or external users.

Webhook Variables:

channelid - Slack conversation ID button was clicked in (type Text)
userid - Slack member Id that clicked the button (type Slack user ID)
text - additional arguments supplied in slash command (type Text)
triggerid - optional to skip message prompt when using Show Form step. (type Text)