Send message via campaign

Send personalized RCS messages to contacts on your profile lists using Oracle Responsys Program Designer and the Gupshup RCS app.

← RCS Oracle Responsys

Configure the message in the service screen, connect the App block to your audience and schedule, and publish the program. Choose one sending approach per service configuration:

1. Template message send — Select an approved Gupshup RCS template and map its placeholders to Responsys profile fields.
2. Free-form message send — Compose non-template content when your agent's platform rules allow it.

Template selection and free-form composition are not combined in the same saved instance.

Prerequisites

1. Complete Installation and save at least one channel using Channel configuration.
2. Create a profile list with a mobile number field. Fields whose names include phone, mobile, or number appear under Send to.
3. For template sends, obtain approval for your RCS templates in Gupshup and confirm they are visible for the selected channel.
4. For free-form sends, confirm your agent's platform and conversation-window eligibility using the free-form rules below. Use an approved template when those rules require it.

Create a program

1. In Responsys, open Programs → Create Program.
2. Enter a name, folder, and profile list, then create the program.
3. Drag an App block onto the canvas, double-click it, and select the Gupshup RCS service. The service may be named Send RCS Message or Gupshup RCS Messaging for Oracle Responsys.
4. Click Configure app to open the service configuration screen.
5. Set Channel, Send to, and your message using either the template or free-form flow below. Click Save, then close the window.
6. Connect the App block to a Scheduled Filter, View, or other entry point and to End. Set the filter and Frequency or schedule, then publish.

Service configuration

Use these controls to configure your send:

For both template and free-form sends, set the channel and recipient field at the top of the configuration screen. After you save, Responsys stores the design. Reopen Configure app on the same instance to edit it.

Template message send

Send an approved RCS template from Gupshup and personalize it by mapping each placeholder to a Responsys profile field.

1. Select a template

1. Choose Channel and Send to.
2. Optionally filter with Categories or Search.
3. Under Select a template, review Template name and Type.
4. Click Select on the template you want.

2. Map placeholders and preview

1. On the template detail screen, use Placeholder values to map each token to a Responsys field. Click the parameter icon to open the field picker.
2. Map every placeholder. Save stays disabled until all mappings are filled in.
3. Use Preview to check the message with your mapped values.

Templates may use placeholders such as [first_name] or other tokens defined in Gupshup. Map each token to the corresponding profile column.

3. Save template configuration

1. Click Save.
2. Wait for the success confirmation, then close the configuration window.
3. Publish and run the program as described in Run the campaign.

Responsys invokes the service for each qualifying contact. At send time, Gupshup delivers the template message using your mapped field values.

Template tips and troubleshooting

• Only templates for the selected channel appear in the list.
• If the list is empty, confirm the templates are Approved in Gupshup and linked to the same HSM account as the channel.
• Rich card and carousel layouts and media come from Gupshup. In Responsys, you primarily map text placeholders.

Free-form message send

Use Free form message builder for non-template RCS messages (messages that are not registered as Gupshup templates). Free-form messages support session-style follow-ups after a customer engages, such as tapping a suggested reply or sending free text. Availability also depends on your agent's platform rules below.

Choose template or free-form mode for each service instance, not both.

Free-form eligibility

Eligibility depends on how your RCS agent was onboarded.

If you are unsure which platform applies to your agent or market, confirm with your Gupshup account team before relying on free-form sends in Program Designer.

1. Open the free-form builder

1. Set Channel and Send to as you would for a template send.
2. On the Select a template card, click Free form message builder at the top right. You do not need to select a row from the template table.

2. Choose a message type and compose

To personalize content, type [variableName] in text fields for per-recipient values. Map each token to a Responsys field under variable mappings, using the same field picker as template placeholders.

Use the Conversation panel to review a mobile-style preview as you edit. The interface enforces these limits:

3. Save free-form configuration

1. Complete the required fields for your message type.
2. Map every [variableName] you used.
3. Click Save in the composer.

The saved instance uses free-form mode. At runtime, Gupshup sends content messages built from your composition and field mappings.

When to use free-form versus templates

If a free-form send fails at runtime, confirm the platform (Vi or Jio), market, and conversation-window eligibility with your Gupshup account team. Use an approved template where required.

Optional: Return to template selection

Click Back in the free-form composer to return to the template list without saving.

To replace a saved free-form design with a template:

1. Open Configure app.
2. Select a template.
3. Map its placeholders.
4. Click Save.

Run the campaign

1. Connect the App block between your audience step (filter or view) and End.
2. Set the filter or view and Frequency or schedule on the entry block.
3. Publish the program.

When the schedule runs, Responsys sends profile data to Gupshup for each qualifying recipient using Send to and your variable mappings.

See also

• Installation
• Channel configuration