A block_suggestion
payload is received when a user interacts with a select menu of external data source element. Users may return a maximum of 100 options or option groups when handling the block_suggestion
payload.
Read our guide to handling payloads from user interactions to learn how your app should process and respond to these payloads.
This is a list of the properties that can be encountered in this type of interaction payload:
Properties received in a block_suggestion
event may differ based on the source of the interactive elementsβa modal view, message, or home tab surface. A check in the column means that property is included in a block_suggestion
event sent to a function, a non-function, or both. Functions refer to next generation Slack apps; refer to Block Kit Interactivity for more information.
Property | Functions | Non-Functions | Description | Required? |
---|---|---|---|---|
user |
β | β | Details for the user that initiated the block suggestion interaction. | Yes |
team |
β | β | The workspace, or team, details the Block Kit interaction originated from. | Yes |
api_app_id |
β | β | The encoded application ID the event was dispatched to, e.g. A123456. | Yes |
block_id |
β | β | Identifies the block within a surface that contained the interactive component that was used. See the reference guide for the block you're using for more info on the block_id field. |
Yes |
action_id |
β | β | Identifies the interactive component itself. Some blocks can contain multiple interactive components, so the block_id alone may not be specific enough to identify the source component. See the reference guide for the interactive element you're using for more info on the action_id field. |
Yes |
function_data |
β | Metadata about the function execution that generated the block where this block suggestion took place. | Yes | |
bot_access_token |
β | A workflow (just-in-time) token generated for this block suggestion. | Yes | |
enterprise |
β | β | The enterprise the installed app is part of, if the app is either workspace-installed on an org, or org-installed. | No |
channel |
β | β | The channel the block suggestion interaction originated from. | No |
message |
β | β | The message where this block suggestion took place, if the block was contained in a message. | No |
view |
β | β | The view where this block suggestion took place, if the block was contained in a view. | No |
value |
β | β | The value the user entered into the select menu. | Yes |
A payload from a block suggestion component used in a modal view:
{
"type": "block_suggestion",
"team": {
"id": "ABC123DEF45",
"domain": "workspace"
},
"enterprise": null,
"user": {
"id": "EXAMPLE1234",
"name": "sallyslack",
"team_id": "ABC123DEF45"
},
"view": {
"id": "DEFGHIJ89101",
"team_id": "ABC123DEF45",
"app_id": "APPID6789101",
"app_installed_team_id": "ABC123DEF45",
"bot_id": "BOTSRCOOL12",
"title": {
"type": "plain_text",
"text": "Deny Request",
"emoji": true
},
"type": "modal",
"blocks": [
/* ... your view blocks here */
],
"close": null,
"submit": {
"type": "plain_text",
"text": "Next",
"emoji": true
},
"state": {
"values": {}
},
"hash": "1695235327.610lSjjQ",
"private_metadata": "{\"messageTS\":\"1695235212.424669\"}",
"callback_id": "deny_modal_main",
"root_view_id": "DEFGHIJ89101",
"previous_view_id": null,
"clear_on_close": false,
"notify_on_close": true,
"external_id": ""
},
"container": {
"type": "view",
"view_id": "DEFGHIJ89101"
},
"api_app_id": "APPID6789101",
"action_id": "ext_select_input",
"block_id": "ext_select_block",
"value": "tech",
"function_data": {
"execution_id": "EXECUTEF9101",
"function": {
"callback_id": "review_approval"
},
"inputs": {
"details": "test",
"subject": "test",
"requester_id": "EXAMPLE1234",
"approval_channel_id": "APPROVE1234"
}
},
"bot_access_token": "xwfp-2335208212870-2354592155553-5925491402867-c2a66a8fb377b19e0d8f6c8d24af530d"
}