Microsoft Teams
Configure a Microsoft Teams channel and webhook to receive procurement opportunity notifications as they are collated by POB.
Last Updated: 27 May 2022 • Page Author: Jillur Quddus
Overview
Microsoft Teams is an instant messaging and collaboration platform developed by Microsoft. This page provides instructions on how to create a Microsoft Teams channel and configure a webhook in order to receive procurement opportunity notifications from POB.
For further information regarding Microsoft Teams, please visit https://www.microsoft.com/en-gb/microsoft-teams/group-chat-software.
Setup
Channel
Please either create a new Microsoft Teams channel or select an existing one in order to receive procurement opportunity notifications from POB. For the purposes of these instructions, we shall assume that your chosen Microsoft Teams channel is named POB.
Webhook
In order for your chosen Microsoft Teams channel to receive procurement opportunity notifications from POB, we must create a new webhook associated with that channel. To do this, please follow the instructions below assuming that you have the permission to manage webhooks in your chosen Microsoft Teams channel (if you do not have permission, then please contact your chosen Microsoft Teams channel owner or Microsoft 365 administrator to create the new webhook for you):
Navigate to https://teams.microsoft.com.
Select your chosen Microsoft Teams channel (for example
POB).Select "Connectors" from the channel menu.
Search for "Incoming Webhook" and select "Add" to install and activate incoming webhooks for your channel.
Navigate back to "Connectors", locate "Incoming Webhook" and select "Configure".
Provide a name for the new webhook (for example
pob) and optionally upload an image for webhook avatar (for example https://avatars.slack-edge.com/2021-07-19/2282480381718_db5803e467659a04f9c5_192.png). Then press "Create".Make a note of the newly created Webhook URL. This will be similar to
https://org123.webhook.office.com/webhookb2/123/@abc-123/IncomingWebhook/def456/ghi7879.
Integration
The final step is to update POB's Application Configuration with your newly created Webhook URL. To do this, create the relevant secret in your chosen secrets management service (for example HashiCorp Vault, AWS Secrets Manager or Azure Key Vault). Then open src/main/resources/application.yml in the pob-configuration Maven module in your preferred text editor or IDE, enable the native Microsoft Teams publisher and finally enter a placeholder variable corresponding to the name of your Webhook URL secret, as follows:
Do NOT enter the Webhook URL directly in application.yml as plaintext as this could expose your Microsoft Teams channel to unwanted or malicious communications.
Deployment
You are now ready to deploy POB to your chosen target environment (for example a self-managed environment, or to the Amazon Web Services (AWS) or Microsoft Azure cloud computing platforms respectively). Once successfully deployed, your chosen Microsoft Teams channel will now automatically receive procurement opportunity notifications from POB as illustrated in the following screenshot:
Last updated
