What are webhooks and how are they used with KV?

Modified on Tue, 28 Jan at 1:53 PM

Webhook Notifications enable building custom tracking and reporting integrations between KnowledgeVision and third-party systems. KnowledgeVision data can be imported into many third-party systems by uploading Excel report files, but this process is manual and time-intensive. Webhook Notifications automate the process by creating a continuous stream of tracking data from KnowledgeVision to the third-party system.

For example, Webhook Notifications can be used to transmit tracking data into a CRM system like Salesforce.com, or they could be used to validate course completion in a custom training application. Custom development work may be required to build an adapter that can handle the stream of data coming in from KnowledgeVision, process it, and store it appropriately in the third-party system. Tools like Zapier (zapier.com) can simplify this integration by mapping the data coming from KnowledgeVision and feeding it into popular third-party applications without any coding required.

Background

Webhooks are a mechanism for passing data between online applications using basic HTTP requests. While there are no strict standards for Webhooks, they often take the format of HTTP POST requests.

Webhook Notifications are triggered after a viewer has completed watching a KnowledgeVision presentation and earned an Engagement Score above a specified threshold. KnowledgeVision generates an HTTP POST request containing relevant tracking data to the Webhook URL specified by the user.

Request Format

The Webhook Notification request contains most of the tracking data available in the downloadable report for a particular viewing session. Each individual piece of data is provided as a separate parameter within the request.

Example

Tracking a user through their email address:

www.knowledgevision-presentation.com?kvid=name@company.com

by appending the ?kvid=email address to the presentation URL you have now created a unique ID for tracking that individual user.

For help with setting your webhooks or URL parameters up, please contact support@knowledgevision.com to set up a meeting.