The urgency of the work sometimes outweighs the luxury of learning, creating a big challenge for the L&D teams in supporting employees in their daily operations.
What if we could use the workflow to drive learning? One way to connect the daily workflow with the Growth platform is webhooks.
This article is a simple guide to webhooks and adding automations that allow other web apps you use to trigger an action on the platform:
Setting up webhooks in TinQwise Control
1. What are webhooks?
Webhooks are a way for external apps to send information to the platform. This connection allows the external app to push data to the platform, which triggers automations. This way, you can run automation that are based on daily events to reward learners or support them with relevant learning content.
Example:
Let's imagine an internal application that is used to track the response time in customer service. You want to encourage the team to provide excellent support and customer satisfaction. You can set up two webhook automations for this purpose:
Add to Programme group to unlock "Time-based email alerts" training when a user's customer service response time is higher than twice the average.
Grant badge when a user's customer service response time is half the average.
2. Setting up webhooks in TinQwise Control
Go to Behaviour > Automations > Create a new automation > Choose Webhook event and save.
Choose the condition of this automation to be applied.
For example, use the condition Is group to limit this automation to only a specific group on the platform.
Choose the action to select what you want this webhook event to trigger.
For example, Notify user to send (email) notifications.
Save the automation.
Once you save the automation, the configuration of the webhook will automatically be generated.
Click on Webhook event to see the authentication details:
Webhook URL
Secret
Use this info to set up the webhook on the other app that you would like receive data from.
Tip: You'll often find webhook related settings under the "webhook", "workflow", or "integration" settings, depending on your app. If you don't know where to get started with webhooks, consult to your IT or engineer colleagues 😉
Developer tip 👩💻 just want to try it out? use the following cURL statement:
curl -X POST -H 'content-type: application/json' \
-H 'Authorization: Bearer [YOUR SECRET]' \
--url [YOUR WEBHOOK URL] \
-d '{"employee_email": "[YOUR EMAIL ADDRESS IN GROWTH PLATFORM]"}'
Good to know 👀
We recommend to use webhooks for sending notifications and adding users to groups for an optimal performance. They should not be used to unlock activities or journeys directly. If you want to unlock content on the platform based on the data received from the web apps you can create a group and set up an automation that unlocks the content when the users are added to that group.