Skip to main content

SlackBlockBuilder

This Script is part of the Slack Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

SlackBlockBuilder will format a given Slack block into a format readable by the SlackV3 integration. The script will also send the block to the given destination. Make sure to mark Trust any certificate and fill the XSOAR API Key integration parameters if you want to get a response to the incident context.

The Slack Block Kit Builder can be found here.

Script Data#


NameDescription
Script Typepython3
Tagsslack
Cortex XSOAR Version6.2.0

Use Case#


This automation allows you to send a survey to users (including external to Cortex XSOAR) via Slack, and have them respond and reflect the answer back to Cortex XSOAR. Within the survey, you can use all the different input types that are available via the Slack Block Kit, including buttons, text fields, datepickers, radio buttons, multi select, and more.

See this blog post for more detailed use case information and ideas.

Dependencies#


Requires an instance of the Slack v3 integration.

This script uses the following commands and scripts.

  • send-notification

Setup Requirements#

  1. In order to use SlackBlockBuilder, you must enter an API key created by a default admin user (username admin by default) into the Slack v3 integration instance settings. The API key must be generated by default admin, not just any user. API_Key

  2. Ensure the "Long running instance" checkbox is checked in the Slack v3 integration instance settings. Long_running

Inputs#


Argument NameDescription
blocks_urlThe URL copied from Slack's Block Builder.
list_nameThe name of the Cortex XSOAR list to use as the block's input.
userThe Slack user to which to send the message. Can be either an email address or a Slack user name.
channelThe Slack channel to send the message to.
channel_idThe Slack channel ID to send the message to.
taskThe task to close with the reply. If empty, then no playbook tasks will be closed.
replyEntriesTagTag to add to email reply entries.
persistentIndicates whether to use one-time entitlement or persistent entitlement.
replyThe reply to send to the user. Use the templates {user} and {response} to incorporate these in the reply. (i.e., "Thank you {user}. You have answered {response}.")
lifetimeTime until the question expires. For example - 1 day. When it expires, a default response is sent.
defaultResponseDefault response in case the question expires.
slackInstanceThe instance of SlackV3 this script should use.
thread_idThe ID of the thread to which to reply. Can be retrieved from a previous send-notification command.

Outputs#


PathDescriptionType
SlackBlockStateThe State of the response from the user will be stored under this context path.unknown

Note Make sure to configure the "XSOAR API Key" instance parameter in the "Slack v3" integration.

To get the API Key:

  1. Go to Settings -> API keys.
  2. Click Get Your Key.
  3. Type a name for the key and click Generate key.
  4. Copy and paste the key in the instance parameter.

Command Example using blocks_url#


!SlackBlockBuilder blocks_url=https://app.slack.com/block-kit-builder/T0DAYMVCM#%7B%22blocks%22:%5B%7B%22type%22:%22section%22
channel=random
task=4
replyEntriesTag=slackResponse
persistent=yes

Human Readable Output using blocks_url#


Message sent to Slack successfully.
Thread ID is: 1660645689.649679

Command Example using list_name#


!SlackBlockBuilder list_name=MySlackBlocksList channel=random task=4 replyEntriesTag=slackResponse persistent=yes

Human Readable Output using list_name#


Message sent to Slack successfully.
Thread ID is: 1660645689.649679

Troubleshooting#


Issue: The survey message is not sent to Slack.

Troubleshooting: Test the send-notification command on its own to verify it is working correctly. This will provide a more specific error message if there is an issue. Note that the Slack API bot you set up for the Slack v3 integration needs to be added to any channels you want to send SlackBlockBuilder surveys to.

Verify your Slack blocks payload is valid. Try simplifying the payload. Test with a simple dummy payload like the following:

{
"blocks": [
{
"type": "section",
"text": {
"type": "plain_text",
"text": "hello world",
"emoji": true
}
}
]
}

Issue: The survey is sent to Slack and submitted successfully, but the response does not show up in context data in Cortex XSOAR.

Troubleshooting: The most likely cause is that there is no API key entered into the Slack v3 integration instance settings, or the API key was not created by default admin. Ensure an API key created by a default admin user is entered into the Slack v3 integration instance settings. Also, make sure to mark the Trust any certificate (not secure) integration parameter.


Issue: The survey is sent to Slack successfully, but clicking the Submit button in Slack does nothing. No response is returned to Cortex XSOAR. There may be a ⚠️ icon next to the Submit button in Slack.

Troubleshooting: Ensure the "Long running instance" checkbox is checked in the Slack v3 integration instance settings.


Issue: Migrating to pack version 3.3.0.

Troubleshooting: # Implementation Guide for Changes in SlackV3 for XSOAR (Version 3.3.0)

1. Review and Identify Affected Playbooks#

  • Identify all playbooks currently utilizing the SlackBlockBuilder script or its derivatives.

2. Implement Conditional Tasks#

  • Introduce a conditional task in your playbooks that waits for the expected response.
  • Configure the task to proceed once the response is received.

3. Integrate the GetSlackBlockBuilderResponse Script#

  • After receiving the response and closing the conditional task, initiate a new task that runs the ParseSlackResponse script.