Setting Up an Incoming Webhook in Microsoft Teams and Integrating with Guardey

What is an incoming webhook in Microsoft Teams?

An incoming webhook is a type of connector in Microsoft Teams that allows external services like Guardey to send automated messages and notifications to a specified Teams channel.

What notifications will I receive through this webhook?

Once set up, this webhook will provide notifications in the Teams channel whenever there is a new challenge available in Guardey.

How do I set up an incoming webhook in Microsoft Teams?Choose the Teams Channel: Open Microsoft Teams, navigate to the channel where you want to receive notifications.

1. Add a Webhook Connector: Click on the three dots next to the channel name, select "Connectors" or add a new tab in the channel and a new app. Depending of your MS Teams version. 
2. Configure Webhook: Search for "Incoming Webhook," click "Add," and then "Configure."
3. Name Your Webhook: Give your webhook a name and, optionally, upload the Guardey logo to represent it.
4. Copy the Webhook URL: After configuration, you'll receive a unique URL. Copy this URL; you'll need it for integration with Guardey.

How do I integrate the incoming webhook with Guardey? 

1. Access Guardey Admin Portal: Log in to the Guardey portal and navigate to the admin section.
2. Go to Users and Groups: Select "Users" and then "Groups."
3. Manage Group Settings: Choose the group you want to configure and click on "Settings," then select "Advanced."
4. Enter Webhook URL: In the advanced settings, enter the Webhook URL you received from Microsoft Teams.

Can I use the same webhook for multiple groups in Guardey

Yes, you can use the same webhook URL for multiple groups in Guardey, but not needed if you already add your required Teams channel. However, the notifications will be sent to the same Teams channel. For different channels, you need to create separate webhooks. 

Is it secure to use webhooks for notifications? 

Webhooks are generally secure as they only allow one-way communication from Guardey to your Microsoft Teams channel. However, it's important to keep the webhook URL confidential to prevent unauthorized use.

Can I edit or delete the webhook later?

Yes, you can edit or delete the webhook anytime in both Microsoft Teams and Guardey. In Teams, go to the channel's connectors settings, and in Guardey, visit the group's advanced settings.

Who should I contact if I encounter issues with webhook integration?

For issues related to Guardey settings, contact Guardey support via support@guardey.com . For Microsoft Teams issues, consult your IT admin.