---
sourceDocument: Brazil Conversational Interfaces
sourceDocumentLink: https://www.servicenow.com/docs/r/conversational-interfaces

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Create a bot in Slack

# Create a bot in Slack {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
You must create a self-configured bot in the targeted workspace in Slack to be able to integrate with the Virtual Agent.

## Before you begin

Role required: none  
Note:  
Users must have permissions to create a bot in the targeted workspace.

## Procedure

1. Log in to [Slack API](https://api.slack.com/apps).
2. Navigate to Your AppsCreate New App.
3. Enter an App Name, select your Slack Workspace, and then select Create App.
4. Configure interactive components.
   1. Navigate to InteractivityShortcuts in the left menu and turn on Interactivity.
   2. Update the Request URL.  
      If you are setting up your self-configured bot on a ServiceNow instance, then the request URL must be https://\<instance-name\>/api/now/v1/cs/adapter/slack/actions.
   3. Select Save.
   {#create-self-config-bot-slack__substeps_gfh_xzg_tvb}
5. Configure event subscriptions.
   1. select Event Subscriptions in the left menu and turn on Enable Events.
   2. Update the Request URL.  
      If you are setting up your self-configured bot on a ServiceNow instance, then the request URL must be https://\<instance-name\>.service-now.com/api/now/v1/cs/adapter/slack/events.
   3. Wait for the Request URL to get verified.
   4. Under Subscribe to bot events, select Add Bot User Event and add `message.im`.
   5. Select Save.
   {#create-self-config-bot-slack__substeps_kbd_x1h_tvb}
6. Navigate to the Incoming Webhook tab, and then slide the Activate Incoming Webhooks toggle switch to enable it.
7. Configure OAuth and permissions.
   1. Select OAuth \& Permissions from the left menu and navigate to ScopesBot Scopes.
   2. Select Add an OAuth Scope and add the following scopes:  
      * chat:write
      * files:read
      * files:write
      * im.history
      * incoming-webhook
      * team:read
      * users:read
      * users:read.email
      {#create-self-config-bot-slack__ul_uqq_dpm_tvb}
   {#create-self-config-bot-slack__substeps_dm1_w4m_tvb}
8. Navigate to OAuth \& Permissions, select Install to Workspace, and then select Allow.  

*[\>]: and then


