The webhooks integration lets you get automatic notifications related to campaign actions for individual recipients. From the settings page you'll be able to subscribe to different campaign events.
Navigate to Settings > Integrations > Marketplace > Webhooks and click on Connect.
Give your connection a Name that helps you easily identify it.
Enter the endpoint where you'll be sending the campaign events in the URL field.
The endpoint value should be a full URL, starting with
Select the type of authentication required: Basic Auth, which requires username and password or Bearer Token, which just requires a token. These should match the credentials your endpoint is configured to receive.
The settings section allows you to select the type of events you want to get notified about (for example, for message send, message open or message unsubscribe) and the channels for which you want to receive these webhooks (all single-stage campaign types are supported). For an exhaustive list of campaign events review the platform.
Click Connect to complete the setup.
More than one webhooks connection
It is possible to have additional webhooks connections by repeating the integration steps outlined in the section above.
This might be helpful in case you want to set up different endpoints for different message events or message types.
The HTTP requests made by Xtremepush to your webhook endpoint are sent with Content-type as
application/json and contain a JSON object in the request body.
The JSON object contains elements with the following keys:
event: String, for example: "message_send", "message_delivery".
time: Integer, UNIX timestamp.
properties: a nested JSON object containing elements described below:
message_type: Indicates the communication channel.
campaign_id: Indicates the campaign ID (by which it's possible to search from the Existing Campaigns page).
profile_id: The Xtremepush unique profile ID.
device_id: The Xtremepush unique device ID. Will only be populated in device-centric campaigns (such as mobile, web push or in-app campaigns).
trigger_id: Xtremepush's internal unique identifier for the action that triggered the campaign to be sent.
error_message: More information about the reason a message failed. Only available for Message failure events.
user_id: External unique identifier. Learn more about how to set the user ID.
Select the integration from Settings > Integrations > Marketplace > Configured Integrations. Go to the Settings tab and update any necessary setting; click Save to confirm. If you need to delete or deactivate the connection, click on the Actions button. You will be presented with the option to either Deactivate or Delete the integration. Clicking either of them opens a confirmation dialog.
Updated 3 months ago