Integrations
Oracle Responsys messaging

Oracle Responsys messaging

Viber WhatsApp

This guide describes how to connect Oracle Responsys with Infobip using either WhatsApp or Viber as a communication channel.

What you will need

See Create an Account for more information on Infobip accounts.

WhatsApp

  • Outbound Text and Media templates with Placeholders
  • Add Callback Data parameters, add your custom values or select from the placeholder list. The placeholder list is based on customer data obtained from the following fields:
    • Profile list
    • Profile extension table
    • Event variable

Viber

  • Outbound Text messages with Placeholders
  • Rich media templates: Use characters, interactive buttons, and links to boost customer engagement
  • Add Callback Data parameters, add your custom values or select from the placeholder list. The placeholder list is based on customer data obtained from the following fields:
    • Profile list
    • Profile extension table
    • Event variable

Installation and configuration

To install the Infobip messaging app for Oracle Responsys, go to the Oracle Marketplace and search for the Infobip messaging app. If you cannot find the app, contact your dedicated Account Manager or contact our Sales team using the Infobip Contact form (opens in a new tab).

After you install the Infobip Messaging app, to start using integration features, you need to configure the app to link your Infobip account with Oracle Responsys.

If you don’t have an Infobip account, you can create one (opens in a new tab).

  1. Connect your Infobip account to your Oracle Responsys account by entering the API key (opens in a new tab).
  2. Enter your Infobip Base URL and then click Next. You can find it on the Homepage in the upper right section: Oracle Responsys Authorize
  3. Enable the channels you want to use by clicking the toggle button.
  4. If you plan to use an alphanumeric sender, add it to the Alphanumeric/short codes Sender textbox. Oracle Responsys Configure Senders
  5. Click Finish to save the configuration. A pop-up message displays a message when the configuration is successfully saved.

Create a program

When you have an Infobip account and your testing or purchased Infobip WhatsApp and Viber numbers, you can start testing and sending programs.

To send WhatsApp or Viber messages using Oracle Responsys, your program design must include the Infobip Messaging application. If you are unfamiliar with how programs are configured in Responsys, see the Oracle Responsys Help Center (opens in a new tab) documentation.

This program example uses the following elements:

  • Scheduled filter or viewas an entry point
  • Apps to configure the Infobip Messaging application
  • Set datato save the information from the Delivery Reports
  • Validate and Publish IMAGE

Configure entry point

The entry point is a scheduled filter, and messages are sent based on this filter. For more information about program entry points in Oracle Responsys, see Programs (opens in a new tab) in the Oracle Responsys documentation.

Messages are sent to numbers that are stored in the MOBILE_NUMBER_ field in Profile Lists. For more information about profile lists, see Profile Lists (opens in a new tab) in the Oracle Responsys documentation.

Filter and segment audience

You must filter the customers based on opt-in. Filter the audience to include only customers who have opted in.

For more information on filters and segment groups, see Filters and Segment Groups (opens in a new tab) in the Oracle Responsys documentation.

Configure apps

After configuring filters and scheduling the time of the campaign, drag and drop the Apps element and start the configuration.

  1. Right-click the Apps element, and click Configure app.

  2. After the Configure senders screen opens, select the channel you want to use for the campaign.

    Oracle Responsys Configure WhatsApp
  3. Configure WhatsApp.

    1. Select sender from the Choose sender drop-down list of registered Infobip senders.
    2. Select a template from the Choose template type drop-down list, whether to send the message as Text or Media template. Oracle Responsys Configure Senders WhatsApp
    3. Define your message in the predefined textbox and rich media if selected.
    4. If the template contains options to personalize the message, carry out one of the following actions in the Placeholders field.
    5. Choose a Placeholder from the list. This list is based on customer data obtained from the following fields:
      • Profile list
      • Profile extension table
      • Event variable
    6. Or manually type in the information in the Placeholder textbox. Oracle Responsys Placeholders WhatsApp
    7. Callback data is an optional parameter. Add your custom text as the value or select from the predefined placeholder list.
    8. Add the Last message status in order to create failover campaigns based on the status of the last message.
    9. Set Timeout for receiving message status. The minimum timeout is 10 minutes, and the maximum is 23 hours.
    10. Click Submit to save the configuration.
  4. Configure Viber.

    1. Choose the message type from the drop-down list to choose whether to send the message as Text or Rich Media template message (image, text with image, text with button, text with image and button). Oracle Responsys Configure Senders Viber
    2. Define your message in the predefined textbox and rich media if selected.
    3. If the template contains options to personalize the message, carry out one of the following actions in the Placeholders field.
    4. Choose a placeholder from the list. This list is based on customer data obtained from the following fields:
      • Profile list
      • Profile extension table
      • Event variable
    5. Or manually type in the information in the Placeholder textbox. Oracle Responsys Configure Senders Viber
    6. Enable the URL Shortening toggle to add URL shortening for URLs in the body.
    7. Add your custom text as the value or select from the predefined placeholder list. Callback data is an optional parameter.
    8. Add the Last message status in order to create failover campaigns based on the status of the last message.
    9. Set Timeout for receiving message status. The minimum timeout is 10 minutes, and the maximum is 23 hours.
    10. Click Submit to save the configuration.

Configure output parameters (optional)

If you wish to store the status of messages:

  1. Go to Settings > Tracking and Variables section > Entry Tracking.
  2. Click the Add + icon. Oracle Responsys Settings Tracking
  3. Create the variable with the message status you want to track. Oracle Responsys Settings Variables
  4. Click Update and save changes.

You can create complex failover campaigns based on the status of the last message. You can store and retrieve the following message statuses:

Message statusesDescription
SentThe message was sent to Infobip and is sent to the end user.
FailedThe message was not delivered because of one of the following reasons:
  • Message was rejected by Infobip
  • Message was rejected by the MNO
  • End user blocked the sender
DeliveredThe message was delivered successfully.
SeenThe end-user has received and seen the message.
ClickedThe number of URL Links that are clicked.

Set a Timeout to Receive Message Status

Because of limitations in Responsys, the message status (Delivery Report) cannot be sent to Responsys in real-time. You can define the interval after which Infobip sends the message status to Responsys.

This interval is stored as a variable in the output parameter Timeout. The minimum timeout is 10 minutes, and the maximum is 23 hours. After the timeout period expires, the output parameter is forwarded with the Set data element.

After the message status is stored in this variable, you can use the variable to do the following:

  • Populate profile lists
  • Populate profile extension tables
  • Data switch

The following scenario shows how to configure the data switch:

You can forward the data from the variable to either a profile extension table or a profile list. While profile lists are preconfigured, you can add attributes to profile extension tables. For more information about profile extension tables, refer to Creating Profile Extension Tables (opens in a new tab).

In this example, we forward the data from the variable to a Profile Extension Table in which we have configured WhatsApp attributes.

To configure the profile extension table, right-click the Set data element and choose Properties.

The message status is stored in the profile extension table. You can use this status in your campaigns.

Validate and Publish

Once you’ve configured all elements, you can activate the campaign by doing next steps

  1. Validate your program to check whether the settings are correct.
  2. Publish the program.

Analyze reports

You can review the performance of the channel in the Analyze tab.

Request verified sender

When you have finished testing, you can request dedicated WhatsApp senders from the Infobip web interface. When you have finished testing, you can request dedicated Viber senders from the Infobip web interface.

Two-way communication is not supported. To use media templates containing quick reply buttons, you must set up forwarding of messages to Answers or Conversations. Contact your dedicated Account Manager or contact our Sales team using the Infobip Contact form (opens in a new tab) to enable forwarding messages. Alternatively, if you use self service, contact [email protected].

Need assistance

Explore Infobip tutorials

Encountering issues

Contact our support

What's new? Check out

Release notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Service Terms & ConditionsPrivacy policyTerms of use