Omnichannel Messaging Adapter for Oracle Integration Cloud

The Omnichannel Messaging Adapter for Oracle Integration Cloud enhances your Oracle Integration Cloud experience. Use this guide to install and configure the adapter.

The Omnichannel Messaging Adapter for Oracle Integration Cloud allows you to integrate Infobip's messaging services into your Oracle Integration Cloud project using:

• Triggers to initiate flows, based on incoming messages. Triggers are events or conditions that start or initiate a workflow. When a trigger event occurs, it kicks off the workflow or integration process. Triggers are usually associated with receiving data or changes from external systems. They listen for specific events and respond accordingly.
• Invokes to send messages. Invokes are actions or operations that your workflow performs on external systems. They represent outbound interactions where your workflow calls external APIs or services to perform tasks. Invokes are used to send data or make requests to external systems as part of the workflow execution.

Omnichannel Messaging Adapter features

The Omnichannel Messaging Adapter for Oracle Integration Cloud enables you to create an integration between Infobip messaging and Oracle Integration Cloud.

The adapter provides the following capabilities:

• Provides actions to:
  • Send SMS messages
  • Send WhatsApp free form messages
  • Send Messages API messages
  • Receive Inbound SMS (poll for new messages)
• Provides triggers using:
  • Inbound WhatsApp message webhook
  • Inbound SMS message webhook

What you will need

To install and use the adapter with Oracle Integration Cloud, you need:

• Infobip account and API keys. If you don't have an account, you can create one (opens in a new tab).
• Oracle Oracle Integration Cloud instance
• Oracle Cloud account credentials
• Access to third-party platforms to connect using the adapter

For more information about Oracle Integration Cloud, see Oracle Application Integration (opens in a new tab) documentation.

Install the Omnichannel Messaging Adapter

The following steps describe how to install and configure the Omnichannel Messaging adapter and connect with Oracle Integration Cloud.

1. Open your browser and go to the Oracle Cloud Console.
2. Log in using your Oracle Cloud account credentials.
3. After logging in, click Browse store in the center screen of the page.
4. Search for the Infobip Omnichannel Messaging adapter in the store and select the adapter.
5. Click Go to marketplace listing.
6. Click Get App.
7. Complete the Single Sign On (SSO) and accept the marketplace Terms of Service.
8. Fill out the customer details form.

Create an Omnichannel Messaging Adapter connection

A connection is based on an adapter. You define connections to the specific cloud applications that you want to integrate.

To use the Infobip Omnichannel Messaging adapter, you need to configure the invoke connection with the appropriate Infobip base URL and API key.

This section describes the following information:

• Prerequisites for creating a connection
• Creating a connection
• Configuring a connection
• Testing a connection

Prerequisites for creating a connection

This section describes the prerequisites for successfully creating and configuring a connection with the Omnichannel Messaging Adapter and Oracle Integration Cloud.

Before you start, you should:

• Obtain the API key
• Set the API key scopes

When you create an Infobip account, you are automatically assigned an API Key. To use the Omnichannel Messaging Adapter, you must set the following API key scopes.

  sms:inbound-message:read 
  sms:logs:read 
  sms:manage 
  sms:message:send 
  number-lookup:manage 
  number-lookup:send 
  account-management:manage 
  numbers:manage 
  whatsapp:inbound-message:read 
  whatsapp:logs:read 
  whatsapp:manage 
  whatsapp:message:send 
  inbound-message:read 
  message:send 
  messages-api:manage 
  messages-api:message:send

For more information about API keys and setting scopes, see API scopes (opens in a new tab).

Create a connection

Before you can build an integration, you must create the connections to the applications with which you want to share data.

1. To create a standalone connection outside of a project:
   • In the navigation pane, click Design, then Connections
   • Click Create
2. To create a connection inside a project:
3. In the navigation pane, click Projects, then select the specific project.
   • In the Connections section of the project, click + (Add).
   • In the Create connection panel, select the adapter to use for this connection. To find the adapter, scroll through the list, or enter a partial or full name in the Search field.
4. Enter the information that describes this connection.

Configure connection properties

Configure the the connection properties for the Omnichannel Messaging adapter to set up the connection with the API base URL.

Enter the connection information so your application can process requests.

1. Go to the Properties section.
2. In the baseURL field, enter the base URL for the Infobip API. The default is https://api.infobip.com.
3. Click Save.

Configure connection security

Configure the security properties for the Infobip Omnichannel Messaging connection.

1. Go to the Security section.
2. From the API Key Authentication list, select the security policy.
3. In the accessToken field, enter your Infobip API key.
4. In the accessTokenUsage field, enter how the API key is used in the authorization header. The default is: -H Authorization: App ${api-key} - do not change this setting.

Test the connection

Test the connection between the Omnichannel Messaging adapter and Oracle Integration Cloud to ensure that it's configured successfully.

Use the testConnectionFlow to verify the connection to Infobip by checking the account balance endpoint.