What are Web Hooks?
Web Hooks let you push notifications for certain events (like a new ticket creation) that happen in your SupportBee account to other programs. Coupled with our API, webhooks can help you automate certain tasks that involve talking to other services. This push notification is simply an HTTP POSTtriggered by that event. This call contains data about the event and is made to the URL provided by you.
This feature is intended for businesses that want to integrate SupportBee deeply with their support workflow.
How do I create a Web Hook?
Web Hooks are offered as an integration in SupportBee. The permission to create and delete integrations is restricted to system admins. While logged in as an admin from your ticketing page:
Click on the Admin link in the top left corner of the main page
Choose the 'Web Hooks' tab from the left-side menu
Specify the URL to which the HTTP POST call has to be made.
For multiple URLs separate them with a comma (http://example1.com, http://example2.com)
Click on 'Update App'
Your web hook will be created and triggered every time the event that you created it for happens in your help desk.
How do I test/develop Web Hooks?
Once a Webhook is added to the system via the Webhook Integration, they can be tested by triggering the corresponding event in the system. For example, create a new comment on a ticket, to test the 'New Comment Created' webhook. We recommend using a service like Hookbin to test the webhooks.
An HTTP POST request will be made to the URL you have specified along with the data corresponding to the event you selected. The response for the POST call should be a success (HTTP Status Code 200). If the response is a failure, the call will be retried 3 times at an interval of an hour.
What events are currently supported?
An HTTP POST call will be made to all the web hook URLs registered by you for the following events
New Ticket Created
New Customer Reply Created
New Agent Reply Created
New Comment Created
Ticket Assigned to User
Ticket Unassigned from User
Ticket Assigned to Team
Ticket Unassigned from Team
Ticket Answered
Ticket Unanswered
Ticket Spammed
Ticket Unspammed
Ticket Trashed
Ticket Untrashed
Ticket Archived
Ticket Unarchived
How do I delete a Web Hook?
The permission to delete webhooks is restricted to the admins in the system. While logged in as an admin from your ticketing page:
Click on the Admin link in the top left corner of the main page
Choose the Web Hooks tab from the left-side menu
In the URLs text area, find the web hook that you want to delete, and remove it from the text area.
Click on 'Update App'