Teams integration

The Teams integration allows you to start an instant meeting or join a meeting in the Weavy Messenger.

Setting Up Teams Online Integration

Prerequisites

  • An Azure account.
  • A Microsoft Teams account.

Creating an Azure app

The first thing you need to do is to create an Azure app. Sign in to your Azure account and go to the Azure Portal.

  1. Go to Azure Active Directory -> App registrations
  2. Click on New registration
  3. Choose a name for the app and select the Supported account types best suited for your app.
  4. For Redirect URI, enter the url https://[your-weavy-url]/meetings/teams/auth
  5. Click on Register to complete the app registration
  6. On the App details page, select Authentication from the left hand menu. Click on Add a platform and select Web. Enter the same Redirect URI as in the previous step. When you are done, click on the Configure button
  7. On the App details page, select Certificates & secrets from the left hand menu.
  8. Click on New client secret. Enter a name and select when the client should expire. Click Add to add the secret. Copy and save the secret now. This will not be visible again! You need the secret when you are going to configure Weavy.
  9. On the App details page, select Overview from the left hand menu.
  10. Take note of the Application (client) ID and Directory (tenant) ID. You will need it in the next step.
  11. You're done!

Configuring Weavy

Now it's time to configure Weavy and enable the Teams Online integration. Depending on where you keep your Weavy settings (appsettings.json or Azure) this step is different. Please take a look at Configuration for the different methods you can use for specifying settings. The following settings are required to enable the Teams Online integration:

Option 1. Configuration in Azure

  • Weavy:Features:TeamsMeetings - Set to true to enable the Teams feature.
  • Weavy:Azure:ClientId - The Client Id from step 10.
  • Weavy:Azure:ClientSEcret - The Client Secret from step 8.
  • Weavy:Azure:TenantId - The Tenant Id from step 10.
  • Weavy:Azure:Scopes - Set to offline_access OnlineMeetings.ReadWrite.
  • Weavy:Azure:AuthenticationUrl - The value for the Teams Online default authentication url. This should be in the format: https://login.microsoftonline.com/[TenantId or common]/oauth2/v2.0/authorize?client_id=[Client Id]&response_type=code&redirect_uri=[your-weavy-url]/meetings/teams/auth&response_mode=query&scope=offline_access OnlineMeetings.ReadWrite. Please note that either a Tenant Id or the word "common" could be specified in the url depending on which "Supported account types" you choose in step 3.

Option 2. Configuration in appsettings.json

{
    "Weavy": { 
        "Features": {
            "TeamsMeetings": true
        },
        "Azure": {
            "ClientId": "The Client Id",
            "ClientSecret": "The Client Secret",
            "TenantId": "The Tenant Id",
            "Scopes": "offline_access OnlineMeetings.ReadWrite",
            "AuthenticationUrl": "https://login.microsoftonline.com/[TenantId or common]/oauth2/v2.0/authorize?client_id=[Client Id]&response_type=code&redirect_uri=[your-weavy-url]/meetings/teams/auth&response_mode=query&scope=offline_access OnlineMeetings.ReadWrite"            
        }        
    }
}

Note. Replace the client Id, Tenant Id and Redirect url in the AuthenticationUrl setting above with the correct values

Test the Teams Online integration

Open up a Weavy Messenger and select or create a new conversation.

You should now see a new Video icon next to the message input field. Click the icon to add a new Teams Online Meeting. The first time you add a meeting, you will need to Sign in to continue. Click on the Sign in link and enter your credentials.

When signed in, you can add a message, attach document or just send the message. A meeting will be created in Teams Online and a Teams Online Meeting card will be attached to your Weavy message. Click on the Start meeting button to open up Zoom and start the meeting. Other users will se a Join link to the meeting.

Weavy Docs