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:

See API Docs

Authenticating​

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

  1. In your Talon.One Application, 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. From Platform, select Customer Engagement.
  5. Select an expiration date, and click Create API Key.
  6. Copy the key for later use.

    7. note
    You cannot display the API key after this step. If you lose the value, create a new API key.

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

Authorization: ApiKey-v1 dbc644d33aa74d582bd9479c59e16f970fe13bf3

Creating a coupon​

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

GET Create coupon
https://integration.talon.one/customer_engagement/coupon
See API 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.

Creating a referral​

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

GET Create referral
https://integration.talon.one/customer_engagement/referral
See API Docs

Fetching a 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 API Docs