Oracle Responsys messaging

Viber WhatsApp RCS

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

What you will need

• At least one Infobip account (if you do not have an account, you can create one (opens in a new tab))
• Senders for WhatsApp and Viber

See Create an Account for more information on Infobip accounts.

Features

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

RCS

• Outbound File messages with Suggestions
• List of possible Suggestions:
  • Reply
  • Open URL
  • Dial phone
  • Show location
  • Request location
• 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 one or multiple Infobip accounts to your Oracle Responsys account by entering the API key (opens in a new tab).
   • General (all channels):

   	account-management:manage
   	numbers:manage
   • Subscriptions:

   	application-entity:manage
   	subscriptions:manage
   • WhatsApp:

   	whatsapp:logs:read
   	whatsapp:manage
   	whatsapp:message:send
   • Viber:

   	viber-bm:logs:read
   	viber-bm:manage
   	viber-bm:message:send
   • RCS:

     rcs:logs:read
     rcs:manage
     rcs:message:send
2. Enter your Infobip Base URL. You can find it on the Homepage in the upper right section:
3. Enable the channels you want to use by clicking the toggle button.
4. If you plan to use an alphanumeric (short code) sender as a Viber sender, add it to the Alphanumeric sender text box.
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 view as an entry point
• Apps to configure the Infobip Messaging application
• Set data to 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 a sender from the Sender drop-down list of registered Infobip senders for all the accounts you have connected and channels enabled.

   

3. Select WhatsApp sender.

   1. Select a template from the Choose template type drop-down list, whether to send the message as Text or Media template.
   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.
   6. Callback data is an optional parameter. Add your custom text as the value or select from the predefined placeholder list.
   7. To add URL shortening for URLs in the WhatsApp body, enable the URL Shortening toggle button.
   8. Add the Last message status 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 a Rich Media template message (image, text with image, text with button, text with image and button).
   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.
   6. To add URL shortening for URLs in the WhatsApp body, enable the URL Shortening toggle button.
   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 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.

5. Configure RCS.

   1. Choose the message type from the drop-down list, whether to send the message as the Text or File message.
   2. Define your message in the predefined textbox or add the File URL and Thumbnail URL if selected.
   3. You can personalize the message by selecting a placeholder value 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.
   6. Click Add suggestion and select from the drop-down if you want to add a suggestion to your message.
   7. Callback data is an optional parameter. Add your custom text as the value or select from the predefined placeholder list.
   8. 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.
3. Create the variable with the message status you want to track.
4. Click Update and save changes.

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

Message statuses	Description
Sent	The message was sent to Infobip and is sent to the end user.
Failed	The message was not delivered because of one of the following reasons:Message was rejected by InfobipMessage was rejected by the MNOEnd user blocked the sender
Delivered	The message was delivered successfully.
Seen	The end-user has received and seen the message.
Clicked	The 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].