Overview

Webhook integration allows you to integrate and send UserGuiding events and metadata to any third-party application that supports webhook URLs.

What do you need to enable Webhook Integration?

  • You need to be using a third-party application or a platform that provides a Webhook URL.

  • You need to create a new Webhook URL on your third-party application.

A Webhook URL acts like a phone number that UserGuiding can call when an event happens and talk to the receiving application.

It looks something like this (keep in mind that the domain changes based on the application):

Enabling Webhook Integration

You can enable this integration by using the toggle within the Integrations Tab under the Settings page.

  • Turn the toggle on.

  • Enter the Webhook URL from your application into the opening pop-up.

  • Click “Complete Integration”, and that's all! 🙌

Event Data We're Sending Through Webhook

Listed below are the user events and their metadata that we'll be sending to the third-party application you integrate.

Example event data;

1. Guide Preview Start:

It means that the first step of a guide is previewed by a user. To see which guide it is, check under guide started (userguiding).

You'll see the guide ID, name, the URL of the page on which the user has seen its first step, and the user ID.

2. Guide Preview Complete:

It means that a user has gone through all steps of a guide and seen its last step. To see which guide it is, check under guide completed (userguiding).

You'll see the guide ID, name, the URL of the page on which the user has seen its first step, and the user ID.

3. NPS Survey Display:

It means that your Promoter Survey is seen by a user. To see the URL of the page in which the user has seen the survey and the user ID, check under nps survey shown (userguiding).

4. NPS Score Submit:

It means that a user has given you a certain NPS score. To see the NPS score value, check under nps score submit (userguiding).

You'll see the survey question, the URL of the page on which the user has seen the survey, and the user ID.

5. NPS Feedback Submit:

It means that a user has given a written answer to the question of your NPS Survey. To see the answer, check under nps feedback submit (userguiding).

You'll see the feedback question, given feedback, the URL of the page on which the user has seen the survey, and the user ID.

6. Hotspot Interaction

It means that a user interacted with a hotspot group and seen hotspot content. Please note that hotspot groups can have multiple hotspots as contents.

This event is sent only once in one UserGuiding script load (page refresh).

To see which Hotspot it is, check under hotspot interacted (userguiding).

You'll see the hotspot group ID, interacted hotspot's ID/title, name of the hotspot group, the URL of the page on which the user interacted with the hotspot, and the user ID.

7. Checklist Item Trigger

It means that a checklist guide is triggered by a user. To see which guide is triggered from which checklist, check under checklist item triggered (userguiding).


You'll see the checklist name / ID, guide name / ID, the URL of the page on which the user has triggered the guide from the checklist, and the user ID.

8. Resource Center Guide Trigger

It means that a Resource Center guide is triggered by a user. To see which guide is triggered from which resource center, check under resource center guide triggered (userguiding).

You'll see the resource center name / ID, guide name / ID, the URL of the page on which the user has triggered the guide from the resource center, and the user ID.

9. Resource Center Checklist Guide Trigger

It means that a guide in a checklist that is put in a resource center as a module is triggered by a user. To see which guide in which checklist is triggered from which resource center, check under resource center checklist guide triggered (userguiding).

You'll see the resource center name / ID, checklist name / ID, guide name / ID, the URL of the page on which the user has triggered the guide from the resource center, and the user ID.

10. Resource Center External URL Click

It means that an external URL in a resource center is clicked by a user. To see which external URL is clicked from which resource center, check under resource center external URL clicked (userguiding).

You'll see the resource center name / ID, external URL, the URL of the page on which the user has clicked the external link from the resource center, and the user ID.

11. Resource Center Search Article Click

It means that a search article in a resource center is clicked by a user. To see which search article is clicked from which resource center, check under resource center article clicked (userguiding).


You'll see the resource center name / ID, article link, the URL of the page on which the user has clicked the article link from the Resource Center, and the user ID.

Disabling Webhook Integration

You can disable this integration by turning off the toggle within the Integrations Tab under the Settings page.

Related Articles:

Intercom Integration

Google Analytics Integration

Did this answer your question?