Before You Install the Recipe

You must perform the following configuration tasks in Slack to create a workspace, App, API credentials, and set permissions.

Configure Slack

1. Create a Slack workspace
   1. Open the Slack get started page using the following URL: https://slack.com/get-started#/createnew.
   2. Enter your email address and click Continue.
   3. Enter the confirmation code that you receive in your email, click Create a workspace, and follow the prompts.
2. Create a Slack App
   1. Log in to the Slack app platform at https://api.slack.com.
   2. In the Slack API title bar, click Your Apps.
   3. Click Create an App, and in the resulting Create an app dialog, select From scratch.
   4. In the Name app & choose workspace dialog, enter the following details:
      1. In the App Name field, enter the name of your app. For example, Oracle Integration App.
      2. In the Pick a workspace to develop your app in field, select your workspace from the drop-down list.
   5. Click Create App.
      The app gets created and its Basic Information page appears.
3. Get the Slack App API credentials
   1. In the Basic Information page, scroll down to the App Credentials section.
   2. Note the client ID in the Client ID field, and the client secret in the Client Secret field.
      These details are required to configure connections to your Slack instance from Oracle Integration.
4. Set permissions for your Slack App
   1. In the left menu, under Features, select OAuth & Permissions.
   2. In the OAuth & Permissions page, go to the Redirect URLs section.
   3. Click Add New Redirect URL and enter the URL of your Oracle Integration instance.
      For example, https://your_instance_URL:443/icsapis/agent/oauth/callback, where your_instance_URL is the Host URL of your Oracle Integration instance.
   4. Click Add, and then click Save URLs.
   5. Scroll down to the Scopes section, and under User Token Scopes, click Add an OAuth Scope.
   6. Enter the following scopes:
      • channels:write
      • groups:write
      • im:write
      • mpim:write

      Note the scope details as they are required to configure connections to your Slack instance from Oracle Integration.
   7. Press Enter.
5. Configure event subscriptions for your Slack App
   1. In the left menu, under Features, select Event Subscriptions.
   2. In the Request URL field, enter the Oracle Integration endpoint URL.
      For example: https://<username>:<password>@<oic host>/ic/api/integration/v2/flows/rest/project/ORCL-R-SLACK_OPENAI_RESUME_SL/SLACKEVENTSUBSCRIPTION/1.0/eventSub
   3. Expand the Subscribe to bot events section, click Add Bot User Event and configure the Event Name, Description, and Required Scope fields.

      Event Name	Description	Required Scope
      file_shared	A file was shared	files:read
      message.channels	A message was posted to a channel	channels:history
      message.groups	A message was posted to a private channel	groups:history
      message.im	A message was posted in a direct message channel	im:history

   4. Expand the Subscribe to events on behalf of users section, click Add Workspace Event and configure the Event Name, Description, and Required Scope fields.

      Event Name	Description	Required Scope
      file_shared	A file was shared	files:read
      message.channels	A message was posted to a channel	channels:history
      message.im	A message was posted in a direct message channel	im:history
      message.mpim	A message was posted in a multiparty direct message channel	mpim:history

   5. Click Save Changes.