# MS Teams Integration

OvalEdge supports integration with Microsoft Teams through webhooks to receive notifications. Users who upgrade to the Microsoft Teams version must configure [Workflows](https://docs.ovaledge.com/references/my-resources/ms-teams-integration#microsoft-teams-workflows-integration) to receive Notifications.

### Microsoft Teams - Webhooks Integration

#### Create a Microsoft Teams space to receive notifications and generate a webhook link

1. Log in to the Microsoft Teams Application: <https://www.microsoft.com/en-in/microsoft-teams/log-in>.
2. Create a new Channel or click an existing channel to receive notifications.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FH458osF4WVBXw5YRy2uW%2Fimage.png?alt=media&#x26;token=126f3e49-221b-4d29-90f1-ba3f27b17602" alt=""><figcaption></figcaption></figure>
3. Go to Connectors and click on the **edit** button.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FBYKQKcdGVYlqulJlGJbU%2Fimage.png?alt=media&#x26;token=ec3e7942-d2cc-4768-847b-efa2ab7d0780" alt=""><figcaption></figcaption></figure>
4. Select the **Incoming Webhook**, then click the **Configure** button.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FdCdoh1h6NoUrr3DveuYu%2Fimage.png?alt=media&#x26;token=decacac7-4e86-4f43-8bd6-1a637119d1e7" alt=""><figcaption></figcaption></figure>
5. Provide the Application's name (OvalEdge), upload the OvalEdge application logo, and click the **Create** button.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2F8Bm0SGY1Mo69ekCqNgvG%2Fimage.png?alt=media&#x26;token=276fc07b-3d5c-481e-9740-62ef09e94099" alt=""><figcaption></figcaption></figure>
6. It will automatically generate the Webhook URL upon creation. Copy the Webhooks URL link.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2Fk7jzafs8ht7QsaAbxJy3%2Fimage.png?alt=media&#x26;token=029b92c1-ebd0-42c2-96f5-ea208b33afb7" alt=""><figcaption></figcaption></figure>

## Integrate Webhook in OvalEdge

1. Log in to the application.&#x20;
2. Open profile settings by clicking the user icon at the top-right corner and selecting **My Profile**.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FyemiPKcBPRcdPsnG4tKk%2Fimage.png?alt=media&#x26;token=31a652f6-eaba-449b-ad3e-d4489321270b" alt=""><figcaption></figcaption></figure>
3. Click on the **Edit Profile** or the edit icon. Enter the webhook link in the Microsoft Teams ID.
4. Click the **Validate** button to receive a test message in the Microsoft Channel space, then click the **Save** button.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FDRIGthp30OExPO8hJtql%2Fimage.png?alt=media&#x26;token=36956bdb-a012-445e-9491-9d4a467ac812" alt=""><figcaption></figcaption></figure>
5. A success message will be sent to the chat if the test is successful.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2Fxo1qiPIwYurrTzSOymel%2Fimage.png?alt=media&#x26;token=aedd5292-49cc-45a1-b87c-976dc677f6d5" alt=""><figcaption></figcaption></figure>
6. To receive notifications, users must select the check box next to Microsoft Teams in their My Profile Notification settings for the module.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FdNrEUZ3gqQ7H2ceEudt8%2Fimage.png?alt=media&#x26;token=db744af0-e1f9-41d7-b0d4-6052b1afeedb" alt=""><figcaption></figcaption></figure>
7. Users will now receive application notifications from OvalEdge.

{% hint style="info" %}
Users can configure only one Microsoft Teams webhook to receive notifications. &#x20;
{% endhint %}

## Microsoft Teams - Workflows Integration

When users update Microsoft Teams to a newer version, they must update the Microsoft Teams Webhook URL to the Microsoft Teams Workflows URL to continue receiving notifications in Microsoft Teams.

The steps below explain how to configure this URL in Microsoft Teams and add the generated URL in OvalEdge.

### Prerequisites

In the Administration > System Settings > Notifications, set the value to workflow for **ms.teams.integration.type**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcJhpLyrhond142y0yyqGcAaAI1wZltWO4Hb2keidDfcnfREIwmk5TwdCAccL7cJAFPI1-I6sfKQlebCpsm4auB2AVDv1zYeSnLHDgErl5RLHFHZlM1XbbE0n2D2EOSD4uLH5okIMnZ0Ds8PEJpe0hbB88Y?key=k2RiLVPBODQeuI06UQnbEA" alt=""><figcaption></figcaption></figure>

### Steps to generate URL in Microsoft Teams

1. Log in to MS Teams with valid credentials.
2. In the left pane, select **Chat**.
3. Select the icon **v** and then click **Create team**.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FUxS0xH73ua9SlGKnh2Nb%2Funknown.png?alt=media&#x26;token=ab565d43-21d8-461d-905b-a9ba7378929a" alt=""><figcaption></figcaption></figure>
4. Enter the **Team name** and the **First channel name \*** in the **Create a team** pop-up. Then click **Create**.\
   **Note:** Team type must be set to Public.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2F93qqVtwPGABrAtlWE1NW%2Funknown.png?alt=media&#x26;token=1089e2f2-d3c1-468f-9c93-7b781a9c23f8" alt=""><figcaption></figcaption></figure>
5. Now, the team with a channel is created. Click on the channel’s three dots and select **Workflows**.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2Fjg7hdieilNmumjQaA2pS%2Funknown.png?alt=media&#x26;token=5cbd1d30-e807-4840-9340-99d047b80ffe" alt=""><figcaption></figcaption></figure>
6. The **Workflows** pop-up is displayed.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2F9B1FKcZbNpQ7ueaijRwB%2Funknown.png?alt=media&#x26;token=571f3723-91d8-48ac-8f6f-c9e211fc37a3" alt=""><figcaption></figcaption></figure>
7. Search for the template **Send webhook alerts to a channel** and select it.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FEZMW2e0ci1YVpAAGlweG%2Funknown.png?alt=media&#x26;token=8aea7128-5370-4fca-85c1-320846d51f3c" alt=""><figcaption></figcaption></figure>
8. Select the created Team and Channel, and click **Save**.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2FKecPsr5jeJO0LcvxPURq%2Funknown.png?alt=media&#x26;token=7096381f-0d06-47b9-baf6-9842e6b5d043" alt=""><figcaption></figcaption></figure>
9. Click the **Copy webhook link**.

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2Fql1EVj3OtZNkyRSsgucT%2Funknown.png?alt=media&#x26;token=1280036e-9cf4-4b0f-a02d-4bf22fc69df2" alt=""><figcaption></figcaption></figure>

### Integrate Workflows in OvalEdge

1. Log in to the OvalEdge application.
2. Open profile settings by clicking the user icon at the top-right corner and select **My Profile**.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdrSU_BLQ9k1FRXd_HksBU5XhwBn02tJ88J32SgZV0I2xeXhfsISb6D6vdzPTcN4kE8JkH4cd10PKkgmNhUI0VYIcGaALBl3RjOhVbBFra6Vk58yZrgXn9vCD3QANpWeUPpEExpbNGPXtuHJ9f2QvUvs58T?key=k2RiLVPBODQeuI06UQnbEA" alt=""><figcaption></figcaption></figure>
3. Click on the **Edit Profile** or the edit icon. Enter the Workflow link in the Microsoft Teams Workflow URL field. (Paste the webhook link generated in Step 9 from above)

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcWidbYatCOclavYxwVGoFaPaGrcjM7iUXOuMziatcnJ6cAoDiuGyLHdl2mSgTmPRaHdCO3vs-G8Lg9U2u7ontZ_FNQEfKAwSEtrRDIJouy2DcfnX42zzxZbP89G3BoJYpcfRLTZ3Z-kkn3P7l4szeUleuD?key=k2RiLVPBODQeuI06UQnbEA" alt=""><figcaption></figcaption></figure>

   Then validate. After successful validation, click **Save**.
4. The Microsoft Teams Workflow URL is displayed as shown below.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcH3Pyb2gZDU_EkgqIxutqxCEH23HkUbGr0ApLKHHnLf_lCqT0oe2Ridyr_CXlOYe6wpx6-tIKSDx9mv2N9U6P5-JHvn5LD6V6KUGNpqVf_G4KnfDkKqPtea74bscgYK0sNPORGTnCZR_xs19bkjnQDoEo?key=k2RiLVPBODQeuI06UQnbEA" alt=""><figcaption></figcaption></figure>
5. A success message will be sent to the chat if the test is successful.&#x20;

   <figure><img src="https://1813356899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTnkoJQml0pok9awFDhx%2Fuploads%2F4kag67VBeeUOrOZ9yyWq%2Funknown.png?alt=media&#x26;token=379ecf83-b843-4a97-bb3f-fc21ffe923ae" alt=""><figcaption></figcaption></figure>
6. To receive notifications, users must select the check box next to Microsoft Teams in their My Profile Notification settings for the module.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXde8f40gmHbk1OC7bCt_a_G8D5baigElb1ItQjXpsCuRhWkoUTydgPgv0TB6dmaSKV6NWWxkN392eC3CyQVnEB7wd9qzL_UjTE0MJNtjGctdcNdF-BXNrwdP2viOLy4TIn81AAmiMPp0anSIoIFwosM2W0?key=k2RiLVPBODQeuI06UQnbEA" alt=""><figcaption></figcaption></figure>
7. Users will now receive application notifications from OvalEdge.

{% hint style="info" %}
Users can configure only one Microsoft Teams Workflow to receive notifications.
{% endhint %}

***

Copyright © 2025, OvalEdge LLC, Peachtree Corners GA USA