This document describes how to set up Slack App.

Create Bot​

The following are the prerequisite to create a bot:

• botID
• externalURL

To create a bot, perform the following steps:

• Take note of your bot's ID.
• To connect to Slack, an HTTPS endpoint is required. 

Connecting Bot to Slack​

1. Go to your apps page. The Your Apps page is displayed.
   
   
   Figure: Crete an App
   
   
2. Click Create an App button. The Create an App pop-up is displayed.
   
   
   Figure: Create an app - From scratch
   
   
3. Select From scratch. 
   
   
   Figure: Name app and choose workspace
   
   
4. Provide a name to your Bot under App Name. Remember your App's name, you'll need it in a few minutes. Click Create App. The Basic Information page is displayed:
   
   
   Figure: Basic Information
   
   
5. Navigate to Settings > Features > Interactivity & Shortcuts. The Interactivity & Shortcuts page is displayed.  
   
   
   Figure: Interactivity & Shortcuts
   
   
6. Turn the Interactivity switch to On.
   
   
7. Set the request URL to: <EXTERNAL_URL>/api/v1/messaging/webhooks/<YOUR_BOT_ID>/slack/interactive.
   
   
   1. Replace EXTERNAL_URL by the externalUrl shared by the SymphonyAI Summit Team.
   2. Replace YOUR_BOT_ID by the bot ID shared by the SymphonyAI Summit Team.
      
      
8. Click Save and save your changes.
   
   
9. Navigate to Features > OAuth & Permissions and add chat:write under the Scopes > Bot Token Scopes section.
   
   
   Figure: Scopes
   
   
10. Navigate to Features > App Home. Under the Show Tabs > Messages Tab section, check Allow users to send Slash commands and messages from the messages tab.
    
    
     Figure: Show Tabs
    
    
11. Navigate to Settings > Basic Information. The Basic Information pop-up is displayed. Click Install to Workspace button under Install your App section.
    
    
    Figure: Basic Information – Install to Workspace
    
    
12. On the next screen, click the Allow button.
    
    
    Figure: Allow
    
    
13. Share the values for Client Secret and Signing Secret to SymphonyAI Summit team.
    
    
    Figure: App Credentials
    
    
14. Back on your Slack app's page, navigate to Features > Event Subscriptions. Turn the Enable Events switch to On.
15. Set the Request URL to: <EXTERNAL_URL>/api/v1/messaging/webhooks/<YOUR_BOT_ID>/slack/events.
    
    
    1. Replace EXTERNAL_URL by the externalUrl shared by the SymphonyAI Summit Team.
    2. Replace YOUR_BOT_ID by the bot ID shared by the SymphonyAI Summit Team.
       
       

16. Under Subscribe to bot event, add message.im and message.channels.
    

    Note:

    You can also add other types of messages as per your requirement.

17. Add the Scopes in the Scopes section: users.profile:read.

18. Wait for the green Verified message to appear next to Request URL. Click Save to save your changes.

19. A yellow banner will be displayed at the top of the screen. Click reinstall your app link. On the next screen, click the Allow button.

20. Quit the Slack app and re-open it.

21. In Slack, under the Apps section of the sidebar, click the + Add apps button. In the search bar, type the name of your Slack App. Click on your Slack app in the search results. You can now chat with your Digital Agent bot in Slack.