Cordial
Set up a connection between your Extole programs and Cordial's automated marketing platform.
Overview
Cordial is an Automated Marketing Platform designed to drive conversions and build loyalty. The Extole integration with Cordial allows you to seamlessly opt users in to email communications as well as send your Extole program emails through Cordial.
Prerequisites
The table below lists the prerequisites you need to complete this integration.
Requirement | Description |
---|---|
Cordial Account | A Cordial account is required in order to take advantage of this integration. |
Cordial API Key | A Cordial API Key can be created within the Settings of your Cordial account. Follow Cordial's guide to generate an API Key. |
Cordial Automation Template Keys for each email | This integration leverages Cordial’s Automation Template APIs to trigger emails to users. Template keys are the unique names of your individual template instances (e.g., sports_newsletter_Jan_2018_week1 ). |
Integration
Generate Cordial API Key
Follow Cordial's guide to generate an API Key. Save the key in a safe place so you can use it to create an Extole outbound webhook.
Create An Extole Outbound Webhook
Work with your Extole team to create an outbound webhook in the Tech Center of your Extole account.
Select Email Variables
Through Cordial’s Automation Template APIs, Extole uses extVars
to pass dynamic data into your email templates such as share links, promotion links, or reward amounts.
The following table displays the Extole emails available to you as well as each email's dynamic variables. Make sure you update the listed variables in Extole since they will be pulled in by Cordial.
Please note that all of the design and copy elements of these emails must be set up in Cordial.
Email Name | Available Variables |
---|---|
Advocate Welcome Email | subject message advocateReward friendReward shareableLink promoteUrl |
Advocate Stats Email | subject message advocateReward friendReward shareableLink promoteUrl numRewards friends |
Friend Share Email | subject message advocateReward friendReward promoteUrl shareableLink |
Pending Reward Email | subject message advocateReward friendReward promoteUrl |
Earned Reward Email | subject message advocateReward friendReward shareableLink promoteUrl couponCode |
Example Request Sent to Cordial
{
"identifyBy": "email",
"to": {
"extVars": {
"promoteUrl": "https://share.clientname.com/zone/promote_destination?journey.campaign_id=7436087871111737566&source=advocate_welcome_email",
"shareableLink": "https://share.clientname.com/test1234",
"subject":"This is the subject of the email",
"message":"This is a message within the email",
"advocateReward":"$20",
"friendReward":"$20",
"numRewards":1,
"friends":[
{
"firstNameOrEmail":"friend",
"initials":"F",
"email":"friend@example.com",
"profilePictureUrl":"",
"status":"converted"
}
],
"couponCode":"testing-coupon1234"
},
"contact": {
"email": "test@example.com"
}
}
}
Updated about 1 month ago