WhatsApp in Program Designer

Using the Gupshup app to send WhatsApp messages

The Gupshup app can be integrated into the Program designer screen of Oracle Responsys to facilitate the sending of WhatsApp messages.

Create Program

  1. Click on the Programs menu on the side navigation bar in Responsys, then click Create Program. The Create Program dialog opens.
Manage Programs screen

Manage Programs screen

Create a program

Create a program

  1. In the Name field, type the name of the program.
  2. Select a folder from the Folder drop-down list.
  3. Select a Profile List from the List drop-down list.
  4. In the Description fields, give any description for your program.
  5. Click Create button.
  6. The program is created, the Create Program dialog closes, and a opens a program designer canvas.
Program Designer

Program Designer

  1. Click on Settings.
  2. In the Lifecycle Options section, type the email addresses to receive notifications about this program.
Program settings

Program settings

  1. Separate multiple addresses by commas or semicolons.
  2. Click on OK.

Create Profile List

Create New List

Users can create a profile list for all customers. Profile list is a customer database for defining and customizing all your data needs.

  • Click Data on the side navigation bar in Responsys,
  • select Profile Lists.
  • Click Create New List.
  • Enter a unique name, select the containing folder, and optionally provide a description.
  • Click Save.
Profiles lists

Profiles lists

Create new List

Create new List

The above steps create an empty profile list containing only system-defined fields and no records.

After the profile list is created, click on Change Schema, Add custom-defined fields as per your needs to your list and click Save button which is located on top of the page.

Profile list

Profile list

View and Add New Records

To view the records of a profile list, click on view records :

Profile lists  - View records

Profile lists - View records

Click on New Record to add an record to this profile list :

View Records

View Records

One of these fields CUSTOMER_ID_ | EMAIL_ADDRESS_ | MOBILE_NUMBER_ must be filled in order to save the record.

We require MOBILE_NUMBER_ field for our app to work properly.

( For the demo purpose, some of the custom-defined fields are filled as well )

Click Save to save the record.

Now our profile list with one record is ready to use.

Create a new Record

Create a new Record

Create Filter

Users can also create a filter on a profile list that is used to target customers with specific characteristics.

  • Click Audiences on the side navigation bar, and select Filters.
  • Click Create Filter and select the Profile List that you want your filter to be based on.
  • Select List for List Type and Profile for Filter Type.
  • Click on Done to open a page where you can define your conditions for the filter.

Drag the fields from the list on the left side and drop in the Profile attributes that you want to put conditions on.

( For demo purposes, we have added conditions using the fields FIRSTNAME and LASTNAME. So it will only select those records from our Profile List that has non-null FIRSTNAME and LASTNAME fields ).

Click on the save button to open a pop-up and give the filter some name, folder location, and description

After saving the filter successfully, click Get Actual Count to confirm the total number of filtered records.

Get Actual Count button to confirm number of filtered records

Get Actual Count button to confirm number of filtered records

Now, our filter is ready to use for program invocation.

Send Whatsapp Message

Using our app inside Responsys Program Designer

  1. In the Program Designer screen, drag the App block on the canvas, and double-click on it to get all the available apps for your account.
  2. Select the Gupshup app’s Send WhatsApp Message service ( Gupshup WhatsApp Messaging for Oracle Responsys ) and then click on done to create an instance of the service.
Select Gupshup app  - Gupshup WhatsApp Messaging for Oracle Responsys

Select Gupshup app - Gupshup WhatsApp Messaging for Oracle Responsys

Created instance of our App's service

Created instance of our App's service

Service Configuration and selecting a template

  1. Click on Configure app, and it will load up the service configuration screen.
  1. Select a Channel from the drop-down (these are the Channels that you have saved in the app configuration step).

  2. After choosing a valid channel from the drop-down, the Select a template section will appear below.

    Select Template

    Select Template

  3. In this section, you can choose any message template available for the selected Gupshup account.

  4. You can also filter the templates based on their type (text, image, document, video).

  5. The Send To must always be mapped to a field that is going to contain the phone number of your customer.

  6. The Send To must always be mapped to a field that is going to contain the phone number of your customer.

  7. Clicking on select button in the template list, redirected to template preview screen

  8. you will need to map the dynamic parameters. (In our demo the selected template has two dynamic data, hence we got two textbox with parameter icon. On click icon it will display list of all parameters).

    Template Preview

    Template Preview

  9. After filling in all the required fields, click on save to save the configuration..

  10. If you get a configuration successful message, then you can close this window.

  11. To send media message user needs to select the media template and after selection there are two option to add media –

    1. Upload Media
    2. Enter Media URL
media message

media message

Program Invocation to send WhatsApp message

  1. Drag the Scheduled Filter or View block and End block on the canvas.
  2. Link the Scheduled Filter or View block to the service instance and the service instance to the End block.
  1. Double-click on the Scheduled Filter or View block to open its properties.
  2. Scroll to the scheduled filter, and select the filter in the Run Filter field that you have created previously.
  1. Scroll to the Frequency section, and schedule when you want to trigger this program once it is published.
  1. Select the following property to trigger the program when the condition in Frequency is fulfilled.
  2. Click on the done button to save and close the properties box.
Schedule Filter

Schedule Filter

  1. For this demo, we have selected the time in advance of 2 minutes from the time mentioned in the Responsys Program Designer. (Click save to get the updated time and schedule to trigger the program after 2 minutes).
  2. Click on validate to check for any errors.
  3. Click on the Publish tab.
Validate Program

Validate Program

  1. Click on Publish button and then click on the yes button in the pop-up to publish the app.
  2. Now at the scheduled time this program will invoke the service of our app.
Publish Program

Publish Program