Create modal and specify fields that should be displayed in your Slack modal. Modal UI can be generated in two ways; automatically using a ServiceNow table and manually using a custom View Payload.
Before you begin
Role required: admin.
About this task
For example, if you want to create incident using modal in Slack, the Create Incident modal requires Priority, Category, and Short Description fields.
Note: Modals can be triggered from these interactive Slack components:
Command,
Block action,
Global shortcut, and
Message shortcut.
Procedure
To create a modal with UI that is automatically generated using a ServiceNow table:
Navigate to Slack > Slack Modal Configuration.
Click New.
On the Slack Modal Configuration form, fill these values.
Field
Description
Name
Name to identify the record. For example, `Modal to create incident`.
Modal Title
Modal title that is displayed on Slack. For example, `Create Incident`.
Table
ServiceNow table corresponding to the modal fields. For example, Incident [incident].
Custom Modal
Option to configure a custom modal.
Input Fields
Inputs fields that should be displayed on Slack. For example, select Priority, Category, and Short Description. Ensure that these modal fields correspond to the selected ServiceNow table. For example, you can't display task related fields on a modal that creates an incident.Note: Only the string, date, and choice field types are supported.
Active
Option to actively use the record.
Script Validation
Script to validate inputs provided by the user in the modal. To validate the user-provided inputs, ensure that you are aware of the format in which values are retrieved from the modal and parse the response from Slack.The sample payload when user provides values for the Priority, Category, and Short Description fields in the Create Incident modal is:
To display validation errors in the modal, configure the script to return an object keys, status, and errorObject. errorObject should have a value of object that will be displayed on Slack. The object should have response_action and error.
Also, configure the script to return an object with keys of status and statusMessage when there are no validation errors. statusMessage is optional and you can configure it as per your requirement.
4. Right-click the form header and click **Save**.
The Create Incident modal is created in Slack.
Image omitted: slack-modal.png Slack modal.
To create a modal with UI that is manually generated using a custom View Payload:
Navigate to Slack > Slack Modal Configuration.
Click New.
On the Slack Modal Configuration form, fill these values.
Field
Description
Name
Name to identify the record. For example, `Modal to create incident`.
Custom Modal
Option to configure a custom modal. Select this check box.
View Payload
Payload generated by Slack Block Kit Builder that defines the modal UI. For more information, see Block Kit and Building with Block Kit.
Active
Option to actively use the record.
Script Validation
Script to validate inputs provided by the user in the modal. To validate the user-provided inputs, ensure that you are aware of the format in which values are retrieved from the modal and parse the response from Slack.The sample payload when user provides values for the Priority, Category, and Short Description fields in the Create Incident modal is:
To display validation errors in the modal, configure the script to return an object keys, status, and errorObject. errorObject should have a value of object that will be displayed on Slack. The object should have response_action and error.
Also, configure the script to return an object with keys of status and statusMessage when there are no validation errors. statusMessage is optional and you can configure it as per your requirement.
4. Right-click the form header and click **Save**.
The Create Incident modal is created in Slack.
Specify conditions to define when the modals should be displayed:
Navigate to Slack > Inbound Decisions For Modals .
On the Decision form, fill these values.
Field
Description
Label
Name to identify the inbound modal decision.
Answer
Modal that must be displayed when the specified conditions are met. Ensure that you select the required record from the Slack Modal Configuration [sn_slack_ah_v2_slack_modal_configuration] table.
Default Answer
Option to specify if this is the default modal. The default modal is applicable when the conditions are not met.
Condition
Conditions to be met in your Slack application to display the modal.
Note:
Copy and record the value of sys_id. You can use this sys_id as the unique value in Callback ID while configuring the shortcut or message shortcut in your Slack app.
Image omitted: modal-slack-sysid-shortcut.png sys\_id of the modal's inbound policy record.
**Note:** Two system properties are added to handle the inbound communications:
Category
Property name
Description
Example
Slash commands
sn\_slack\_ah\_v2.command.special\_characters
The characters encoded using the encodeURIComponent method are handled internally. To replace any additional special characters used in Slash commands in the Slack application with their encoded URI characters, add the characters in a JSON format.
The characters encoded using encodeURIComponent method and the following characters are handled internally: `!, ', (, ), *, ~` Fill in the property to replace any additional special characters used in Slack Interactivity & Shortcuts in the Slack application with their Encoded URI characters in a JSON format.
\{ "~" : "%7E", "\\\(" : "%28", \}
To display modals for the required shortcut, in **Condition**, provide the sys\_id of the modal's inbound policy record.
Image omitted: slack-modal-sysid.png Display modals for Slack shortcuts.
- To display modals for the required Slack commands, in **Condition**, provide the required command for which the modal should be displayed.
Image omitted: slack-modal-cmd.png Display modals for Slack commands.
- To display modals for the required Slack block action, in **Condition**, provide the required action ID of the required block action for which the modal should be displayed.
Image omitted: slack-modal-actionid.png Display modals for Slack block actions.
3. Click **Submit**.
When events in Slack meet conditions specified in the policy, the associated modal is displayed.
**Note:** These inbound decisions are saved in the Decision tables. Users are cautioned against directly updating or modifying data in these tables.
Specify tasks to be performed when user provides values in the modals by creating an inbound policy:
Navigate to Slack > Inbound Decisions.
Click New.
On the Decision form, fill these values.
Field
Description
Label
Name to identify the inbound decision.
Answer
Subflow that must be triggered when the specified conditions are met.
Default Answer
Option to specify if this is the default answer. The default answer is applicable when the conditions are not met.1. Click the lookup icon (
Image omitted: SearchIcon.png Lookup icon).
2. Select the required subflow from the Document list.
Note: Ensure that the Table name is Flow [sys_hub_flow].
Ensure that you have configured the subflow to process the response payload from Slack to automate tasks.
Condition
Conditions to be met to perform tasks in ServiceNow instance. Specify the modal record in the condition.
Image omitted: slack-modal-subflow.png Condition to trigger subflow.</p>
Note:Condition must have condition specific to the modal record only.
4. Click **Submit**.
When Slack user provides inputs in the modal, the associated subflow is triggered after validating the inputs. Depending on the automations configured in your subflow, tasks are performed.