The Slack adapter for Oracle Integration Cloud was released recently and delivers an easy way of Integrating with Slack.
Slack and other platforms with similar capabilities changed the way we work, and the way we interact with our colleagues. The boost in productivity and collaboration with these types of platforms is incredible. Slack is also a verb nowadays (let me slack you), that alone is enough to show its impact !
Slack Adapter Capabilities
The Slack Adapter offers outbound integration with Slack on the Oracle Integration platform. You can create outbound integrations that invoke the Slack application so you can manage channels, invite users, get profile information, manage chat and groups, upload files, and perform search operations.
More details on the documentation page.
The first use case that comes to mind is about notifications – Traditionally a notification is an email – but instead of relying on an email, you can publish those notifications into a dedicated channel, or tag the proper team/individual. This will allow a transparent handling and collaboration of all notifications!
Let’s now think on Sales Orders – When a new order/opportunity is created in the CRM system you can create a new slack channel with all team members, or you can tag someone that has a particular task waiting to be fulfilled for example.
These are just two obvious use cases but in reality there are so many possibilities here – you can pick up any real time event , filter it and tag someone, create a channel, send an attachment to a channel, escalations, reminders etc, etc.
Prerequisites for Creating a Connection
If you are an Integration developer probably you will ask the Slack administrator for this information – but in case you have both roles, here is a quick walk-through.
Before you can create a connection with the Slack Adapter, you must satisfy the following prerequisites.
When you create a Slack app, the Client Id and Secret are automatically created.
Under OAuth & Permissions tab you can add the desired scopes
Fill the Redirect URL with: https://<instance name>.integration.ocp.oraclecloud.com:443/icsapis/agent/oauth/callback
The last step is to install the app to the slack workspace!
How to create a connection?
Choose Slack as the desired adapter.
Name your connection and provide an optional description.
Click configure Security:
Client Id and Secret:
Use the client id and secret from the slack app
Add the desired scope – here I just want to enable read/write capabilities. Scopes are separated by a space.
Here is a list of the supported scopes and their respective operations: https://docs.oracle.com/en/cloud/paas/integration-cloud/slack-adapter/invoke-operations-page.html
Finally press the “Provide Consent” button – this will open a popup/tab where you need to provide the slack credentials, after which you will be requested to allow access.
All going well you should see the below screen
How to create an Integration?
I will showcase how to use the Slack adapter for notifications. With a simple scheduled Integration that is supposed to read files from an FTP – built to fail !! then the global fault comes into play and we create the Slack connection so that we can write the error notification to a channel!
Drag the Slack adapter onto the Global Fault canvas.