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.

RequirementDescription
Cordial AccountA Cordial account is required in order to take advantage of this integration.
Cordial API KeyA 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 emailThis 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 NameAvailable Variables
Advocate Welcome Emailsubject
message
advocateReward
friendReward
shareableLink
promoteUrl
Advocate Stats Emailsubject
message
advocateReward
friendReward
shareableLink
promoteUrl
numRewards
friends
Friend Share Emailsubject
message
advocateReward
friendReward
promoteUrl
shareableLink
Pending Reward Emailsubject
message
advocateReward
friendReward
promoteUrl
Earned Reward Emailsubject
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"
       }       
   }
}