Skip to main content

Webhook Channels

Webhooks are the primary method for delivering recommendations to connected integrated systems.

Destinations are now called Channels
Feature Limitation
  • At this stage, webhook channels are only available on Custom Integrated Systems.

Creating a Webhook Channel​

In Cherry, click Promotions on the sidebar, then Channels and then click on Create New. Next, choose which Custom Integrated System you wish to associate the channel with. After creating the channel, go to the Configure tab. In the Webhook Endpoint field, enter the HTTP/HTTPS location of the webhook channel then save.

Screenshot of where to configure channel endpoint

This webhook will be called every time the campaign is invoked.

Assocating with Campaign​

In the campaign tabs, click on Delivery.

Screenshot of where to find the Delivery tab

Next, click Add Channel and choose which channel you wish to associate the campaign with.

Security​

All webhooks contain a signature validating that Cherry Recommends sent the webhook. The validation method is similar to Hubspot's X-HubSpot-Signature method.

The X-Cherry-Signature header contains an important value. Your should independantly calculate the signature, and compare the value to this header.

To calculate the signature value:

  1. Append the Request Body to the Application Secret of the associated Custom Integrated System.
  2. Take the SHA256 hash of that value.
  3. Convert the hashed value to a lowercase hexadecimal string.
Secret

Do not expose your Application Secret