Microsoft Teams notifications - using an Incoming Webhook Connector
TLDR;
The Incoming Webhook connector enables ALIS to notify you about certain events that you want to track. Once you configure an incoming webhook for a Teams Channel, you will get an URL link. You can copy this URL and use it to configure the notification in ALIS. This way, your Teams channel can receive notifications from ALIS.
What is Incoming Webhook in Microsoft Teams
An Incoming Webhooks is a special type of connector in Microsoft Teams that lets an external applications share content in Microsoft Channels. The webhooks are used to track and notifiy (Reference).
How to create an incoming webhook
Navigate to the channel where you want to add an Incoming Webhook → select Manage Channel (NOT Manange Team).
![image-20240421-165119.png](../__attachments/2406973903/image-20240421-165119.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
If you don’t have a team, see FAQ question1 to create a new team.
If you want to add a new channel, see FAQ question2.
Select Edit under connectors section.
![image-20240421-165134.png](../__attachments/2406973903/image-20240421-165134.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
If you cannot edit, it means that you don’t have the permission. See FAQ 3.
Search for the Incoming Webhook and select Add.
![image-20240421-165200.png](../__attachments/2406973903/image-20240421-165200.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Select Add
![image-20240421-165221.png](../__attachments/2406973903/image-20240421-165221.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Enter the Incoming Webhook’s name and select Create.
![image-20240421-165255.png](../__attachments/2406973903/image-20240421-165255.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Copy the URL (will be used later to set up ALIS notification)
![image-20240422-073038.png](../__attachments/2406973903/image-20240422-073038.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
How to set up notification in ALIS using an Incoming Webhook in MS Teams
Log into ALIS instance and navigate to notification targets → add a new notification target.
![image-20240421-165431.png](../__attachments/2406973903/image-20240421-165431.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Choose transportation as Microsoft Teams and paste the URL copied from Step 6.
![image-20240421-170443.png](../__attachments/2406973903/image-20240421-170443.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Create a new notification subscription.
![image-20240421-171337.png](../__attachments/2406973903/image-20240421-171337.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Enter the details and choose an event. Choose a target that was previously set up in Step 8.
![image-20240421-165704.png](../__attachments/2406973903/image-20240421-165704.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Event
There are currently 2 types of events that can trigger the notification.
Work Order | Observation |
---|---|
|
|
Initiate an event that you have previously chosen in Step 10
Example:
Createa a new work order
![image-20240421-183119.png](../__attachments/2406973903/image-20240421-183119.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Complete a work order
![image-20240421-183124.png](../__attachments/2406973903/image-20240421-183124.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Create a new observation
![image-20240421-183142.png](../__attachments/2406973903/image-20240421-183142.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
Check the status
When an event is triggered, the notification will be sent to the team channel. You can see their statuses if the notifications are successfully delivered or not.
![image-20240421-165723.png](../__attachments/2406973903/image-20240421-165723.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
![image-20240422-072522.png](../__attachments/2406973903/image-20240422-072522.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)
If error occurs, you should go back to check the set up of your Targets or Subscriptions again.
Receive the notifications in your teams channel!
![image-20240421-165754.png](../__attachments/2406973903/image-20240421-165754.png?inst-v=0dc40ebd-85bc-4a81-94f4-589c88c7b26c)