Troubleshooting Retreaver Webhooks


Retreaver uses webhooks to transfer data for third party platforms. Webhooks are used to interact with various tools that can help process and utilize your caller data to create an effective caller experience.

There are 2 main types of webhooks inside of Retreaver:

  1. Publisher Postback
    Postback webhooks send data into Retreaver before a call is processed inside a campaign. These webhooks typically contain data that will influence call routing decisions [ Caller Interest & Profile data ], they can also be used to pass along critical data for Retreaver campaign triggered webhooks [ Lead Identification & Verification ].
  2. Retreaver Campaign Triggered Webhooks
    Retreaver webhooks are used to forward any tags that were associated with a caller into another platform using HTTP requests. These HTTP requests deliver packaged information to various endpoints which are then used to trigger various actions using APIs, scripts or online utilities.

    View our Zapier Integration guide to learn more about how Retreaver webhooks can drive various actions to process your calls.


Troubleshooting Publisher Postback Webhooks

Publisher Postback Webhooks ( aka Call Data Writing ) are used to send data into Retreaver which are then processed into tags and associated with a pending incoming caller. View our Call Data Writing guide for more information. 

Head into "Setting -> Company -> Postback Logs" to view your postback logs using the Retreaver navigation sidebar.


This will display a list of postbacks that your company has received. Clicking on a postback ID will bring you to the postback properties page:


Viewing your postback log can help you determine if postbacks are being received successfully. You will be able to view the payload that was delivered in JSON format and see what information your publishers are sending.

Retreaver automatically parses the JSON payload into tags using key:value format. Use this information to debug any issues with incoming postbacks.

Common issues to look for when debugging Publisher Webhooks are missing/empty fields or misconfigured key:value pairs.


Troubleshooting Campaign Webhooks

Retreaver can trigger its own Webhooks using Start Pings. These webhooks are triggered from within a tracking call campaign and are used to process information, webhooks can be triggered before call routing decisions are made or after a call has been processed. View our Start Ping Webhook guide to learn more.


Viewing triggered campaign webhooks from the call log:

Retreaver Webhooks can be viewed from the call log. They are listed under the "Pixels Fired" column on the very right of a call log record. Clicking on a particular record will take you to the webhook overview page.


Retreaver Webhooks can also be accessed from inside the Call UUID overview page. Scroll down to the "Fired Pixels" column and click on the numerical property to navigate into the webhook overview page.




Understanding the Webhook Overview Page


The webhook overview page lists various properties of a particular webhook. Information such as success status, created time, trigger source, endpoint destination, payload and response are all visible under the overview page. Use this information to debug any webhook issues and isolate any problems that might be occurring.


Here are some common issues that can occur when working with Retreaver webhooks:

Issue Solution
Webhooks are not firing

Make sure your webhooks can execute successfully by reviewing the webhook trigger. Webhooks may trigger at the beginning of a call, at the end of a call or under specific conversion/timer circumstances. Review the Start Ping guide to see all available webhook triggers.

Incoming Webhook Responses are missing Tags

When using webhooks to ping a system for additional information, make sure to review the response body of those requests. Webhooks might be misconfigured to send incorrect or missing information back. Review your API documentation or custom scripts to ensure responses are being returned to Retreaver in valid JSON format.

Outbound Webhooks are missing Tags

Retreaver uses replacement tokens in order to package tags into Webhooks. Review the third party documentation and your replacement tokens to ensure valid parameters are being forwarded.

Use replacement tokens to supply tag values into your webhooks:[TagValue]&TagName2=[TagValue2]

      • The "TagName" portion of the request is the Key that the API is expecting to associate with a value.
      • The [TagValue] portion of the request will be supplemented with the tag value stored inside a Retreaver Tag Key.

        For example to send a zip code in your webhook, you would place:[caller_zip]&Caller=[caller_number]
 Error Response from APIs

Review your third party API documentation and webhook logs to ensure that you are sending valid parameters through your webhooks.

Oftentimes required parameters are either missing or lay outside of an accepted range such as the case when sending invalid/unsupported zip codes or missing caller information. This will typically elicit an "error" response back from the API into Retreaver.

Webhooks are delayed


Retreaver webhooks are typically fired, processed and returned in under a second. Any delays outside of that range is caused by the external infrastructure that is being used to process those webhooks.

Typically during busy industry seasons, systems are overloaded leading to slower than usual server response times. There are instances where webhooks are delayed by 10 seconds or more which could potentially affect any time critical events from being triggered correctly.

If you are attempting to request a response from an API in time before a call is routed, such as when submitting a call lead to a system and waiting for a dynamic call buyer endpoint, we recommend using a ringing audio.mp3 or an IVR message greeting.

The greeting will buy some time with the caller while Retreaver webhooks finish processing. Having a 5 second greeting will ensure that your webhooks will be processed in time prior to connecting the caller with an agent.


0 out of 0 found this helpful



Please sign in to leave a comment.