Introduction

Talon.One is a platform that allows you to create highly customizable promotional campaigns with the help of the Campaign Manager feature. With this integration, you can automate coupon generation and delivery to specific customer segments. You can embed Talon.One generated coupon codes directly into messages delivered through CleverTap. Thereby optimizing the reach by sending campaigns at the right time on the right channels.
For any issues with this integration, contact Talon.One Support team.

Prerequisites for Integration

The following are the prerequisites for setting up the integration:

• Must have integrated Talon.One SDK or API. For more information about detailed steps, refer to Talon.One Integration.
• Must have access to CleverTap account.

Send Talon.One Coupon Code Through CleverTap

To send the Talon.One coupon code through CleverTap:

1. Set Up Webhook in Talon.One
2. Set Up a Campaign in Talon.One
3. Create a Campaign in CleverTap

Set Up Webhook in Talon.One

To set up a webhook in Talon.One:

1. Ensure that you set up the payload as per the parameter and authentication headers recommended by Clevertap. For more information, refer to Upload Events API.

📘

Display in Rule Builder Checkbox

Ensure that you select the Display in Rule Builder checkbox to enable webhook for your campaign.

2. Select the request Verb from the dropdown list and then enter the URL. The following table lists the API endpoint for the region of your account:

3. Enter the following CleverTap account details to set up the authentication headers:
   • Project ID
   • Passcode

These details are obtained by navigating to the Settings > Project page of the CleverTap dashboard.

4. Set up the parameters in the webhook payload for sending coupon codes and update them to match your campaign requirements.

{
  "d": [
     {
         "type": "event",
         "evtName": "Coupon Generated",
         "$source": "Talon.One",
         "identity": "${$ProfileID}",
         "evtData": {
             "CouponGenerated":"${$CouponCode}"
         }
     }
     ]
     
 }

📘

Payload Parameters

• The evtName parameter defines the EventName displayed on the CleverTap dashboard when selecting the campaign action. You can define the evtName as per your preference.
• The identity is a mandatory parameter. This parameter is passed as the userID/ProfileID, which CleverTap uses to effectively trigger the required engagement action.

Set Up a Campaign in Talon.One

To set up a campaign in Talon.One:

1. Create a campaign.
2. Ensure that you add the Create a Coupon Code effect.
3. Select the Store generated value in session checkbox to send the effect-generated coupon code to CleverTap.

📘

Applying Effects to Campaigns

When applying effects to the campaign, ensure that you Create the Coupon Code and then Create a Webhook Trigger.

📘

Identify User

Use a universal ID as the profile ID to identify the user across Talon.One and CleverTap dashboards.

Create a Campaign in CleverTap

You can use Email, SMS, and Push channels on the CleverTap dashboard to send coupon codes generated on Talon.One dashboard.

Create an Email Campaign

1. Navigate to Messages > Campaigns.
2. Click + Campaign.
3. From the Messaging Channels list, select the messaging channel.

The Campaign page displays.

4. Select Live behavior under Start here section and then click Done.
5. Select Service Provider from the dropdown list.
   You can also Add a Service Provider by clicking Add a new service provider link. After adding a provider, click Refresh to reflect the changes.

6. Click Done.
7. (Optional) Set a goal for your campaign and then click Done.
8. Select Single action:New segment from the Find user from segment list with conditions as shown in the following figure:

9. Fetch the coupon code by typing “@” in the Email Editor under What section, which invokes a dropdown with the relevant event attributes.
10. Select the coupon code that was pushed as the attribute in the webhook.

For the remaining steps, follow the steps listed under the create campaign section of the respective messaging channels:

• Create an Email Campaign
• Create a Push Notification Campaign
• Create an SMS Campaign