Creating referrals via Bloomreach Engagement
To make the most of your integration with Bloomreach Engagement, you can create referral codes directly from your Bloomreach Engagement platform using our generic CEP endpoints and use them in your customer engagement efforts.
In your Bloomreach Engagement scenario, you can use a combination of operators and actions to send referral codes generated in Talon.One to relevant users based on custom conditions. For example, when the user shares the URL of a product you wish to promote, you can email them a referral code.
Prerequisites
- Talon.One
- You understand the parameters required by the Create referral endpoint, for example, a valid campaign ID.
- Bloomreach Engagement
- You know your audience and scenario execution requirements, for example, your preferred email provider.
- You created the relevant events and properties in the Data Manager.
A good understanding of email marketing can help you tailor your scenarios effectively. We highly recommend you read the Bloomreach documentation first.
Creating an Integration API key
An Integration API key allows authentication for incoming webhook requests. In Talon.One, let's create an API key to aid authentication in a later step.
To create an API key:
- In your Talon.One Application, click Settings > Developer settings.
- Click Create API Key.
- For Do you want to use this API Key with a 3rd party service?, select Yes.
- From Platform, select Customer Engagement Platform.
- Select an expiration date, and click Create API Key.
- Copy the key for later use.
Configuring webhook authentication
In Bloomreach Engagement, let's configure the webhook authentication for Talon.One so that data can be passed securely in the webhook request. We will use this webhook authentication while creating a scenario in a later step.
To configure webhook authentication:
In Bloomreach Engagement, open Data & Assets > Integrations.
Click Add new integration > HTTP Authentication Schemas > Add integration.
In Endpoint, type the endpoint URL to create a referral from a generic CEP.
GET Create referralhttps://integration.talon.one/customer_engagement/referral
Click Custom headers, and enter the following headers:
Key Value Type Authorization
ApiKey-v1 <API-key>
, where<API-key>
represents the API key you generated.public destination-hostname
The base URL of your Talon.One deployment. public customer-engagement-platform-name
BloomreachEngagement
public Rename the integration appropriately.
Click Save integration.
Creating a scenario
In Bloomreach Engagement, let's create a scenario to automate the communication with our users based on custom conditions.
Specifically, let's use an action to send a webhook request to Talon.One for a new referral code. Let's then use another action to forward the received value from the first webhook's response in an email to our users.
Your scenario path may vary from the following steps depending on the actions you decide to implement and the dynamic data you choose to include in your user communication. See Personalization Using Jinja.
To create a scenario:
In Bloomreach Engagement, open Campaigns > Scenarios > Create new.
(Optional) Click the edit symbol in the scenario name to change it.
Create and configure the triggers and operators that best suit your campaign needs.
Create an action with the webhook request to Talon.One.
In the Editor tab of the action:
Enter the endpoint URL with the required parameters. To understand the request format, see the API Docs.
noteTo see the Application ID and campaign ID of your campaign:
Open your Talon.One campaign.
In your browser, check the URL. It should look similar to:
https://mycompany.europe-west1.talon.one/applications/198/campaigns/373
In this example, the Application ID is
198
, and the campaign ID is373
.
Click Do not process response, and select Process response as JSON.
In the Settings tab of the action:
- Enable Authentication and select the webhook authentication you created.
- In Other, select the required consent category for your users.
Click Done.
Create another action to send the generated referral code in a message to your users. For example, create an Email or SMS action.
In the Editor tab of the action, compose your message with the desired personalization.
In the message composition field, type the following placeholder value so the generated referral code is populated dynamically when the scenario runs:
{{ webhook.code }}
noteProperty names are case-sensitive. Type
webhook.code
with a lowercasec
, according to the response of the Create referral endpoint.In the Settings tab of the action, review your recipients and the tracking consent category.
Click Done.
Click Save.
You can also create a webhook preset, which is a reusable webhook template that you can use in your Bloomreach Engagement scenarios.
Next steps
Before you launch your scenario, you can test and preview the complete workflow in the Test tab. When you click Start, you will see a confirmation window indicating how many customers will be affected by the scenario run.