Rokt Calendar

Introduction

Rokt Calendar is a dynamic calendar marketing technology that enables brands to push 1:1 events and promotional communications in the form of calendar events and notifications.

MoEngage <> Rokt Calendar

The MoEngage and Rokt Calendar integration allows you to use to user events as trigger to update your Rokt Calendar subscribers. 

library_add_check

Prerequisites

  • Ensure you have access to your Rokt Calendar account. Contact sales-calendar@rokt.com to talk to an account manager. 
  • Ensure you have Rokt Calendar OAuth credentials.
  • Ensure you have External subscriber ID. This is the identifier used by the Rokt Calendar subscription process to match the calendar subscriber with the MoEngage user. This is something you will be passing to Rokt Calendar.   

Provide subscription integration points

To build an audience of calendar subscribers, you will need to offer a destination to which a user can navigate and subscribe. Some subscription integration point examples include:

  • Add a calendar button to your website
  • Adding a calendar link in an email or SMS
  • Add a calendar button to your app
  • Add a calendar link on social media

Promote the calendar

To build an audience of subscribers, you’ll need to promote the calendar to your audience so that they know how to subscribe. Some calendar promotion examples include:

  • Posts on social media
  • Email newsletters and updates
  • Blog posts
  • In-app notifications

Create a Rokt Calendar connector on MoEngage

Within MoEngage, you can set up a connector campaign or a connector within flows to either:

  • Send a new personalized event: Allow new events to be added to a segment of subscribers’ calendars.
  • Update a personalized event: Allow for an update to be made to an existing event in subscribers’ calendars.

To create a connector campaign on MoEngage, 

1. Navigate to Create Campaign >> Connectors >> Custom and choose the delivery type most suitable to your needsScreenshot_2022-02-21_at_10.48.46_PM.png

2. On step 2 of the campaign 

Send a new event

You can refer to Rokt Calendar Event APIs here 

  • Select the method as POST
  • Add Webhook URL as:
    https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}
    Screenshot_2023-04-18_at_10.10.52_PM.png
  • In Headers, add
    • Authorisation
      Basic base64encode(app_id:app_secret)
    • Content-Type:
      application/json
  • In the Body, you need to define the segment details. Use the following example to help structure your payload and enter your desired fields. 
JSON
{
"event": {
"eventId": "{{EventAttribute['ID']}}",
"title": "{{EventAttribute['title']}}",
"description": "{{EventAttribute['description']}}",
"location": "{{EventAttribute['location']}}",
"start": "{{EventAttribute['start_time']}}",
"end": "{{EventAttribute['end_time']}}",
"timezone": "{{EventAttribute['timezone']}}",
"notifyBefore": "{{EventAttribute['notify_before']}}"
},
"subscriptionIds": ["{{UserAttribute['rokt:subscription_id']}}"]
}

Update an existing event

You can refer to Rokt Calendar Event APIs here 

  • Select the method as POST
  • Add Webhook URL as:
    https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}/update
  • In Headers, add
    • Authorisation
      Basic base64encode(app_id:app_secret)
    • Content-Type:
      application/json
  • In the Body, you need to define the segment details. Use the following example to help structure your payload and enter your desired fields. 
JSON
{
"event": {
"eventId": "{{EventAttribute['ID']}}",
"title": "{{EventAttribute['title']}}",
"description": "{{EventAttribute['description']}}",
"location": "{{EventAttribute['location']}}",
"start": "{{EventAttribute['start_time']}}",
"end": "{{EventAttribute['end_time']}}",
"timezone": "{{EventAttribute['timezone']}}",
"notifyBefore": "{{EventAttribute['notify_before']}}"
},
"subscriptionIds": ["{{UserAttribute['rokt:subscription_id']}}"]
}

Preview your request 

At this point, your campaign should be ready to test and send. You can also test your connector configuration using the Test functionality available in Step 2 of Create Connector Campaign.Screen_Shot_2022-02-22_at_11.12.42_AM.png

You can go ahead and Publish the campaign.

Previous

Next

Was this article helpful?
1 out of 2 found this helpful

How can we improve this article?