Create Post-Call Webhook

Webhooks are available at the Network, Advertiser and Publisher account level. The parameters available change depending on the account level where the webhook is created, and the platform’s network settings. All available parameters are listed via the "Add substitution parameter" link on the New Webhook page. 

To create a Post-call webhook

From the Navigation Bar (Network, Advertiser, or Publisher), hover on Integrations and select "Manage Webhooks".

 
  1. Click "Add Webhook".
  2. Select Webhook type: "Post-Call".
  3. In the New Post-Call Webhook page, enter a unique Name.
  4. Select an action to "Fire Webhook On".

5. Select related advertisers or campaigns: 

If you are creating a Network level Webhook, select "All Advertisers" or a specific advertiser for the webhook to fire on.

If you are creating an Advertiser or Publisher level Webhook, select "All Campaigns" or a specific campaign for the webhook to fire on.

6. Select Webhook Format. Note that only JSON supports Signal, Retrying, Batching and Call Corrections.  Also, the option for Authentication is only relevant for customers with an Invoca for DoubleClick Integration.

If you select GET

Enter the Webhook URL. Click "Add Substitution Parameter" to view and add parameters to the webhook URL. In the example below, the Webhook URL is appended with the substitution parameter advertiser_campaign_name. 


Enter HTTP Headers. Enter each parameter in its own line using the format "name:value".

If you select JSON POST,

Enter the Webhook URL. Click "Add substitution parameter" button to view and add parameters to the Webhook URL. 

If integrating with DoubleClick Search (DS3), Invoca for DoubleClick authentication is required. Select the integration from the dropdown list. 

Enter HTTP Headers. Enter each parameter in its own line using the format "name:value". 

Enter the Post Parameters. Enter each parameter in its own line using the format {"parameter name": <POST_substitution_parameter_value>} Separate parameter name:value pairs with a comma. Note: Post parameters are required for JSON webhooks.

Select “Reliable Webhook” to re-fire failed JSON webhook posts.

If "Reliable Webhook" is enabled, select “Fire Webhook for Call Corrections” to fire a JSON webhook for call correction transactions. Ensure that your server is provisioned to accept and process a call correction transaction. When an existing transaction is corrected, the correction appears as a new transaction that refers to the original through the corrects_transaction_id field. When you receive a correction, replace the original transaction with the new attributes from the correction.

Select "Batch Requests" to select the frequency of re-firing and batch size limit if applicable. When “Batch Requests” are chosen single webhooks continue to fire, however a batch will be fired up to the Maximum batch size based on the frequency selected. Note: if you batch JSON webhook posts, ensure that your server can support batch submissions. Batching is intended as a way to throttle the requests to the receiving end point.


If you select HTTP Form Post,

Enter the Webhook URL. Click "Add substitution parameter" button to view and add parameters to the webhook URL. 

Enter HTTP Headers. Enter each parameter in its own line using the format "name:value".

Enter the Post Parameters. Enter each parameter in its own line using the format parameter name = parameter value. Post parameters are required for HTTP Form Post webhooks.

If you select XML Post, 

Enter the Webhook URL. Click "Add substitution parameter" button to view and add parameters to the Webhook URL. 

Enter the HTTP Headers. Enter each header in its own line using the format: name:value.

Enter XML parameters using the format: <Name>[value]</Name>. Click "Add XML substitution parameter" button to view and add XML substitute parameters in the XML field. In the example below, the XML Post is passing a hard-coded value for custID and a custom RingPool parameter value for sessionID. Note: XML parameters are required.



If you select Google Analytics,

Enter the Google Analytics ID. 

Enter the Analytics Domain. 

See Google Analytics Integration for more information.

7. Click Save Changes.

8. To test a Webhook, From the Webhooks table, click the Test Icon



Automatic test webhooks can only be sent when using a  GET webhook type. Other types of webhooks require the user to make a test call.

Feedback and Knowledge Base