Developing Responsys Apps for CX Apps

The Oracle CX Apps enables Partners to build integrations between their systems and the Oracle Marketing product by building apps. These apps help marketers orchestrate their campaigns across platforms in near real time. Developers can develop apps intended for all customers of the Marketplace, or develop custom solutions for just a single the Oracle Marketing product customer.

By building an app, an App Provider makes their services available to Oracle CX Marketing customers. Marketers can use an app to send campaigns to their customers on channels not currently native to the Oracle Marketing product.

Why should I develop apps?

Here are some highlights of developing for CX Apps:

  • Build your own orchestration stages to Program workflows
  • Create seamless user experiences between Responsys and your application
  • Post a listing for your app in the Oracle Marketplace

Getting Started

App providers will need to create a web server application that can send and receive REST API calls to and from the Responsys system via HTTPS. App Developers need to create an App Provider within the application before they can start developing. We assume that app developers are technical and have built web applications before. These topics are not intended to instruct developers on how to develop their app, this guide provides guidance on what Oracle App Manager requires from your app to work with CX Apps.

App developers must be familiar with:

  • REST APIs
  • JSON
  • JSON Web Tokens (JWT)
  • Web application development and deployment
  • Responsys Personalization Language (RPL) for Responsys development

High-Level Steps

The high-level steps for developing an app are as follows:

  1. Set up system prerequisites:

    1. Web application server, to receive the requests and send the proper responses to Responsys.
    2. Database for storing the data that the app uses, sent from Responsys at Program runtime.
  2. Develop the app, including the Responsys requirements:

    1. App Installation and Configuration: Develop the app's installation and configuration experience. This includes the integration points for which your app will interact with Oracle App Manager(Application Management Service). Within AMS, these integration points are known as the app's Install URL, Configure URL, Save Configuration URL, and Uninstall URL.
    2. Program Design Time: Develop the Program Activity's configuration experience. This includes the integration points for which your service will interact with Oracle App Manager. Within App Manager, these integration points are known as, the service's Configure URL and Save Configuration URL.
    3. Program Run Time: Develop the Program Activity's runtime capabilities. This includes the integration points for which your service will interact with Oracle App Manager. Within AMS, these integration points are known as the service's Invoke URL.
    4. Performance: Ensure that the app server can accommodate calls from Responsys, and that the app server does not exceed Responsys’ throttling limit for inbound requests.
  3. Build and deploy the app on the web server.

Next steps

Learn more

Developing Apps for CX Apps

Responsys Concepts

App Installation and Setup

Designing Responsys Programs with "App" Stage

Program Runtime Overview