Webhooks

This guide covers the steps in setting up webhooks within the Convirza platform, detailing how to configure them to send call data to a specific endpoint.

Convirza webhooks can send call data in real time to an endpoint of your choosing. To set a webhook, follow the steps below:


Part 1: Setting up the Webhook

  • Log in to your Convirza account.
  • Navigate to Settings-> Customization ->
              Webhook.
  • Click the Create button.
              .
  • Fill out the required fields as shown below.
    • The Endpoint URL is where you will be sending
                your call data (The URL in the screenshot below 
                is a test endpoint. You can set up your own test
                endpoint by searching “webhook test site” or
                something similar in Google).
    • You can test your webhooks by clicking the Test
                Webhook button, and within a few seconds,  
                you should receive data at your endpoint.
  • Static parameters: To use basic authentication
              or any custom payload for your CRM/LMS, you
              can fill in the Field name and Static value fields
              in Static parameters.
             
                • You can find the list of tracking numbers/number pools associated with the webhook in two different tabs under Associated  tracking numbers.
                           


If a webhook is added at the top level or 2nd level group, it will be inherited by the subgroups.

Part 2: Adding the Webhook to Tracking Numbers

Now that your webhook is set up, you must add it to individual tracking numbers so it knows which numbers to send call data to.
There are two options for adding webhooks to numbers: post-call and pre-call.

Post-call webhooks are sent immediately after the completion of a call and can be set up to fire only if specific conditions are met. Post-call webhooks can include data append (caller name and address), indicator scores (if you utilize Conversation Analytics), and DNI logs (if using DNI) by simply checking all of the boxes in the above screenshot. Pre-call webhooks are always triggered at the start of a call and will fire for all calls. You can include DNI logs with your data if you check the box to ‘Include DNI logs’ in the screenshot above.

While post-call webhooks can send more data points, pre-call webhooks have the advantage of being sent as soon as a call connects, which can be helpful if you would like to know which campaign a caller is being referred from at the start of the call.

Post Call Webhooks


If you would like to add a post-call webhook, follow the steps below:

  • Navigate to a tracking number’s Conversation actions (you can go to Reports >> Tracking Number Settings and then click the link under the TN Name column)
  • On the tracking number page, click the Conversation Actions button.
  • Select a condition (In the screenshot below, the condition is set to fire the webhook for all calls over 0 seconds – which means it will fire for all calls)
  • Your action will Trigger the Webhook, and in the following drop-down, the Webhook you created will be available as an option.
Be sure to click Save




Pre Call Webhooks

If you would like to add a pre-call webhook, follow the steps below:

  • Navigate to a tracking number’s call actions (you can go to Reports >> Tracking Number Settings and then click the link under the TN Name column)
  • Once the tracking number is open, click the plus symbol to expand the advanced tracking number settings.
  • Check the box for the Pre-call webhook and then select your webhook from the dropdown or click ‘Create’ to create a new one.



  • Be sure to click Save