Post Action Webhooks
Learn how to send campaign data with Post Action Webhooks.
Overview
A post action webhook is used to trigger a payload to your specified endpoint after sending a push notification.
Note
Contact our sales team at [email protected] to enable post action webhooks for your organization.
Use Case
You may want exact copies of all messages sent to each user and the message statuses as input to your recommendation engine. This can be solved by using a post action webhook.
You can enable the post action webhook during campaign creation under the Setup section.
After the configuration is enabled, the webhook endpoint is listed in the Setup section. Select the required webhook endpoint from the list.
Refer to the Webhook Setup guide to learn more about Webhook configuration,
Send Data
You can stream all the message-level data from a push campaign on your server by using a post action webhook.
Following is the sample payload structure for push data:
{
"targetId": 1628144342,
"profiles": [
{
"identity": "6425",
"all_identities": [
"[email protected]",
"6425"
],
"objectId": "-gdf3d1d914a65406a862bac176fb279f1",
"payload": {
"title": "Welcome to Acme!",
"body": "Click here to register for the next event.",
"kvs": {
"wzrk_cid": "ChannelID",
"wzrk_bi": "2",
"wzrk_bc": "",
"wzrk_ttl_s": 86400,
"wzrk_ttl": 24,
"wzrk_acct_id": "WZZ-ZZZ-ZZZZ"
}
}
}
]
}
Following are the key types in the payload:
Key | Type | Description |
---|---|---|
wzrk_cid | String | Refers to Channel ID. |
wzrk_bi | String | Keys Badge icon in push notifications. |
wzrk_bc | String | Key refers to badge count. |
wzrk_ttl_s | Integer | Time to live in seconds. |
wzrk_ttl | Integer | Time to live of notification. |
wzrk_acct_id | String | CleverTap account ID |
wzrk_pn | N/A | If present, this notification is sent from CleverTap. |
wzrk_id | string | Open rate tracking ID (can be empty or it may not be present). |
wzrk_bp | string | If present, the value will be a URL of an image displayed in the notification. |
wzrk_sound | boolean or string | If present, it signifies that the default or custom Android notification sound must be played. |
nt | string | Notification Title. If absent or empty falls back to the app name. |
nm | string | Notification Body. If absent or empty, ignore this notification. |
wzrk_dl | string | If present, this is a deep link that must be followed at the time of notification open. |
wzrk_d | N/A | If present, ignore this notification. |
ico | string | If present and not empty, it contains the URL of an image, that must be used as the small notification icon. |
wzrk_pivot | string | If present and not empty, it contains the URL of an image. It signifies the type of variant in A/B campaigns. |
wzrk_rnv | string | If present and not empty, it will raise Push Impressions event. |
wzrk_nms | string | If present and not empty, it contains the summary text to be displayed along with the image. |
wzrk_st | string | If present and not empty, it contains the subtitle text which is displayed next to the App name. |
wzrk_clr | string | If present and not empty, it contains the Hex value of the color to be applied on the small icon (and app name for Android Pie and below) |
The post action webhook can collect data only after the successful delivery of push messages.
Updated 9 months ago