Successful two-way integration of TRIFFT and Bloomreach requires 4 steps:

Sending events from TRIFFT to Bloomreach

1. Creating API authorization in Bloomreach for TRIFFT
2. Setting up Bloomreach webhooks in TRIFFT

Sending data from Bloomreach to TRIFFT

3. Creating API authorization in TRIFFT for Bloomreach
4. Setting up TRIFFT webhooks in Bloomreach

1. Creating API authorization in Bloomreach for TRIFFT

To set up integration between TRIFFT and Bloomreach, you’ll need to configure the API URL, API Key, API Secret, and Project Token.

Retrieving connection details from Bloomreach

You can locate the required connection information within the Project settings of the Bloomreach platform:

1. Log in to the correct Bloomreach project.

2. Click the gear icon in the top-right corner of the interface.

3. Click on Project settings from the pop-up menu.

   

4. In the main navigation bar on the left, go to Access management > API section.

5. The Project Token and API Base URL are first items at the top of this section.

Generating the API Secret and API Key

To create the API Secret and Key, follow these steps:

1. Staying on the same API page, scroll down to the API groups section.
2. Select the New group option from the dropdown menu.
3. Set the access type to Private access.
4. Name the group, then click Create group.

5. the API Secret will be provided in a popup window

5. The API Key will be shown in the Group keys section.

Setting GET and SET permissions

After creating the new API group, ensure you assign the GET and SET permissions for both Customer Properties and Events. These permissions are necessary to enable proper synchronization between TRIFFT and Bloomreach.

2. Setting up Bloomreach Webhooks in TRIFFT

📘

Consult this guide for a general description of webhook setting in TRIFFT

Setting up API authorization

1. In the TRIFFT Content Cockpit, navigate to the Settings section.
2. From the left-hand menu, select Webhooks.
3. Switch to the Authorizations tab at the top of the Webhooks page and click on Add new button in the top-right corner

4. Fill out the fields as follows:

• Name: (top left): fill in a suitable name, e.g. “Bloomreach”
• Endpoint: Enter the API URL provided by Bloomreach.
• Type: Choose the authentication type, which should be BASIC for this integration.
• Username: Paste the API Key ID you obtained from the Bloomreach platform.
• Password: Enter the API Secret associated with the API Key.

5. Once all details are entered, click the yellow Save button in the top-right corner to complete the authorization setup and finalize the connection between TRIFFT and Bloomreach.

Creating webhooks

1. Switch back to Webhooks tab at the top of the Webhooks page and click on Add new button in the top-right corner
2. Fill out the fields as follows:
   • Name: (top left): fill in a name as you want the event to be named in Bloomreach (e.g. “mobile_app_opened”
   • Event: Select a relevant Member-associated event from the drop-down
   • Enable authorization: Set to Enable.
   • Authorization: Select Bloomreach (or whichever name you used in the previous step).
   • Endpoint URL: Append the URL filled in in the API authorisation section with /customer/events (alternatively, this can be added directly to the Endpoint field in API Authorisation).
   • Endpoint type: Select POST.
   • Log only errors: Set to Enable.
   • Payload type: JSON.
   • Payload: Create a JSON payload, leveraging available JINJA variables and as required by the Bloomreach project settings and intended event structure.
3. Once all details are entered, click the yellow Save button in the top-right corner. The integration should now be complete and a chosen TRIFFT member event will now be forwarded in real-time to a Bloomreach project

📘

Consult this guide for examples of the most common webhooks to share member events from TRIFFT to Bloomreach

3. Creating API authorization in TRIFFT for Bloomreach

Generate API key in TRIFFT

1. Navigate to API Keys: Go to Settings > API Keys in the Content Cockpit.
2. Add a New API Key: Click the Add new button.
3. Configure the Key:
   • Note: Enter Bloomreach.
   • Permissions: Enable both Read Access and Write Access.
4. Save: Click Save to generate the key.
5. Copy the generated API token: Click on the "copy" icon to the right from the asterisks (alternatively right-click and select "Show" to reveal the token.

Create HTTP Authentication in Bloomreach

1. Log in to your Bloomreach project
2. Navigate to Integrations: In the Bloomreach platform, go to Data & Assets > Integrations from the left-hand menu.
3. Add a New Integration: Click the yellow Add new integration button in the top-right corner.
4. Select Integration Type: Select HTTP Authentication Schemas
5. Configure Integration Details:

• Endpoint: https://api.trifft.io/v1
• Authentication Type: Switch to the Custom headers tab.
• Key, enter "Authorization" or similar.
• Value: provide the authentication token generated in the TRIFFT API Keys setting
• Type: set to secret.

6. Save the Integration: Once all necessary fields are filled, click Save to activate the integration.

4. Setting up TRIFFT Webhooks in Bloomreach

Using TRIFFT public REST API endpoints, create webhooks that can be triggered in Bloomreach scenarios.

1. Open Integrations: In Bloomreach, go to Data & Assets > Integrations from the left-hand menu.
2. Choose the Webhook Preset: From the available options, select Webhook preset to configure your custom webhook.
3. Configure the Webhook: After selecting the preset, enter the necessary details such as the webhook URL, headers, and payload, depending on your integration needs.
4. Save the Webhook: Click Save to activate the webhook for use in various Scenarios within Bloomreach.

📘

Most TRIFFT APIs support bulk communication. Depending on a particular scenario, bulk API connection will be the only reliable approach (e.g. when adding thousands of members into a segment.

Example:

Adding individual members to a TRIFFT segment:

To add a member to a segment:

1. Create a new Scenario in Bloomreach
2. Set an appropriate trigger and scenario logic
3. Click on Actions > Other and select the pre-built custom webhook
4. Test and execute the scenario

Example: In this scenario, on event "Booking", a user is added to a TRIFFT segment "Booked"