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
|
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 needs
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}}
- 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.
{
"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.
{
"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.
You can go ahead and Publish the campaign.