To integrate, extend, and build applications with the Slack Platform and Oracle Integration, you must have a Slack developer account.

To create an account, visit the Slack Developer website (https://developer.slack.com), click Sign Up, and follow the on-screen instructions.

Don't forget to review the terms and documentation after you get your account.

To obtain the proper access token to execute the Slack API securely, the Slack Adapter uses the Slack OAuth 2.0 authentication and authorization framework.

1. Sign in to the Slack Developer console at https://api.slack.com.
2. In the Slack API title bar, click Your Apps to view the apps that you have created.
3. Click Create New App.
   1. Enter a name for your application.
   2. Select the workspace that this application belongs to. Note that your app belongs to the workspace you select. Leaving the workspace will remove your ability to manage your application. You can't change this value later so select the workspace carefully.
   3. Click Create App.
4. Optionally, if you want to add details about the OAuth application, scroll to the Display Information section and enter the information.
5. In the left navigation menu under Features, select OAuth & Permissions.
6. On the OAuth & Permissions page, scroll to the Redirect URLs section.
7. Click Add New Redirect URL, and enter the callback URL of your Oracle Integration instance.

   Note:

   If you don't know the following information, check with your administrator:

   • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
   • The complete instance URL with the region included (required for new instances).

   For Connections…	Include the Region as Part of the Redirect URL?	Example of Redirect URL to Specify…
   Created on new Oracle Integration 3 instances	Yes.	https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback
   Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3	No. This applies to both: New connections created after the upgrade Existing connections that were part of the upgrade	https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback

8. Click Add, then click Save URLs.
9. Scroll down to the Scopes section.
10. Under User Token Scopes, click Add an OAuth Scope.
11. Add the scopes that you want this application to access. These scopes correspond to the operation supported by the Slack Adapter.

    Valid scopes are:

    • channels:read
    • channels:write
    • chat:write:user
    • files:read
    • files:write
    • files:write:user
    • identity.basic
    • search:read
    • users:read
    • users:read.email
12. Press Enter.

Get the client ID, secret, and signing secret to use when configuring security on the Connections page for the Slack Adapter.

1. Sign in to the Slack Developer Console.
2. Open the Slack application you created for your integration.
3. In the navigation pane, select Basic Information.
4. Scroll to the App Credentials section.
5. For invoke connections (client ID and secret):
   1. Copy the values for Client ID and Client Secret.
   2. Click Show to reveal the client secret before copying it.
   3. Enter these values on the Connections page when configuring security for the Slack Adapter connection. See Configure Connection Security and Access.
6. For trigger connections (signing secret):
   1. Copy the value for the signing secret.
   2. Enter this value on the Connections page when configuring security for the Slack Adapter trigger connection. See Configure Connection Security and Access.

When you successfully create the OAuth application, Slack automatically generates a client ID and a client secret. These credentials allow your application to access the Slack API.

1. Sign in to the Slack Developer console.
2. Open the OAuth application you created.
3. In the navigation pane in the Slack API, select Basic Information.
4. Scroll to the App Credentials section.
5. Copy the values for your client ID and client secret. Click Show to see the client secret before selecting it for copy. You'll need to enter the client ID and client secret in the Credentials dialog when you configure security for your connection in Oracle Integration.