Omniconnect setup

This guide shows you how to set up an Omniconnect integration to connect third-party platforms with Bloomreach using webhooks.

Before you start

Ensure you have:

• A Bloomreach project with integration access.
• Basic knowledge of JavaScript.

Choose your platform

Pick the third-party platform you want to connect with Bloomreach. Your platform must support webhooks for this to work.

📘

Note

Different platforms use different names for webhooks. Your platform might call them API Notifications, Web Service Requests, or something else.

This guide uses Typeform as an example. You can follow the same steps with other platforms and adjust as needed.

Watch this short demo on how to integrate Typeform with Bloomreach.

Create the integration

1. In the Bloomreach application, go to Data & Assets > Integrations.
2. Click + Add new integration.
3. Search for Omniconnect.
4. Click + Add integration.

5. Give your integration a name and click Save integration.

   ❗️

   Warning

   Protect your API key group. Don't delete or rotate the API key group that Omniconnect creates. This key group processes all Omniconnect events. If you delete or rotate it, events will fail and you'll see 401 errors.

Connect your platform

1. Copy the Omniconnect URL from Bloomreach.

2. Go to your third-party platform's webhook settings. For Typeform: Workspace > Connect > Webhooks > Add a webhook.

3. Paste the Omniconnect URL into the webhook field.
4. Add a description that explains what this integration does.

Set up the transformation function

The transformation function converts incoming webhook data into a format that works with Bloomreach.

View incoming data

1. In the Bloomreach application, go to your Omniconnect integration.
2. Click Transformation.
3. Open the Incoming request dropdown and select the most recent request.
4. Check the Input tab to see the raw data from your platform.

Write your transformation function

The transformation function varies from integration to integration and allows for a high-level personalization of the integration using JavaScript.

1. Write JavaScript code to transform the incoming data.
2. Click Transform input to test your function.
3. Check the Output tab to see the transformed data.

Your transformation function varies based on your platform and needs. For Typeform examples, see the Use Cases article.

Requirements for successful requests

• Payload format: JSON (for example, )
• Content type: application/json
• Method: POST
• Payload size: 500 KiB or less recommended. Payloads of 1 MB or larger may cause issues or timeouts.

Response codes

Omniconnect returns these HTTP codes:

Test and launch

1. Click Save changes after you finish your transformation function.
2. Click Start to launch the integration.
3. Go to Data & Assets > Customers to see events from your platform. Customer profiles update automatically.

Set up notifications (recommended)

Get email alerts when your integration has issues.

🚧

Important

Turn on email notifications first. Ensure your email notifications settings are turned on, otherwise this feature will not work. To turn them on, go to User settings > Notification settings > Get notifications via email.

Add notification recipients

1. Go to your Omniconnect integration.

2. Click the three dots next to the Start button.

3. Click Notifications.

   

4. Enter email addresses for people who should get alerts. Bloomreach recommends adding your implementation partner, internal teams, or technical teams.

5. Click on Save.

Troubleshoot issues

Events aren't appearing in customer profiles

Check if the API key group was deleted or rotated. If so, recreate the integration.

Errors after platform changes

If your third-party platform changes its webhook payload format, your transformation function may break. The Bloomreach support team can check the Audit Log to see what changed.

Need help?

Contact Bloomreach Support with:

• Sample requests and headers.
• Error codes you're seeing.
• Description of the issue.