Set up Webhook Integration

A webhook delivers data to other applications in real-time. Unlike typical APIs where frequent calls must be made to obtain real-time data, webhooks can be triggered automatically, for example in response to user events.

Before you begin, you should have the following information on hand:

• The destination URL, method and content type you would like to use

• If the destination URL requires authentification, please ensure you have the username and password that should be used when sending the webhook

• If you use a header for authentication or require other special headers, please also have these on hand

Setting up a Webhook Integration

• In the CrossEngage app, navigate to Settings > Integrations.

• Click the Add new integration button in the top right corner of the page.

• Search for 'webhook' and click Set up.

Using this information, you can now complete the setup form.

Sender Info

The sender information is the method (POST or PUT) and Destination URL that will be used to dispatch the webhook.

Authentication

You are able to use three types of authentication when using Webhooks on CrossEngage:

• Basic Authentication

• WSSE Authentication

• OAuth 2 authentication.

Append HTTP headers

If you require any special headers or authentication headers, please add the key - value pairs here.

Content type

At this stage, you are able to choose what type of content the webhook will send to your destination URL. We currently support Javascript, JSON, XML and URL-encoded content types.

Default Message Content

Since the structure of a webhook will not considerably change over the time, you can prefill the default message at this stage.

The information entered here will appear by default in every new message created on CrossEngage.

Additional Properties

You can define additional properties that will be added to events.