Skip to main content

Generic CEP integration

You can integrate with any customer engagement platform, or CEP, using the following endpoints designed for 3rd-party tools, rather than your own integration layer.

important

These endpoints are for general use with any platform. If you use a partner listed in the Customer engagement platforms section, do not follow this tutorial but instead, refer to a tutorial specific to your platform.

PlatformTutorials
Braze
Iterable

The following endpoints are available:

Authenticating

All these endpoints rely on Talon.One's 3rd-party API keys of type Customer Engagement. To generate one:

  1. Open your Talon.One Application in the Campaign Manager and click Settings > Developer settings.
  2. Click Create API Key.
  3. For Do you want to use this API Key with a 3rd party service?, select Yes.
  4. Select Customer Engagement from the dropdown.
  5. Select and expiry date and click Create API Key.
  6. Copy it for later use.

Use the key in the Authorization header of each of the endpoints. For example:

Authorization: ApiKey-v1 dbc644d33aa74d582bd9479c59e16f970fe13bf3

Create coupon

To create a coupon from a CEP platform, use the following endpoint:

GET Create coupon
https://integration.talon.one/customer_engagement/coupon

See the API reference docs.

note

You can modify the shape of Talon.One-generated coupon codes for any campaign:

  1. Open your campaign.
  2. Click Settings > Coupon codes.

Create referral

To create a referral from a CEP platform, use the following endpoint:

GET Create referral
https://integration.talon.one/customer_engagement/referral

See the API reference docs.

Fetch loyalty ledger

To fetch a loyalty ledger from a CEP, use the following endpoint:

GET Get loyalty ledger
https://integration.talon.one/customer_engagement/loyalty

See the API reference docs.