This document guides the enterprise admin of a Microsoft 365 customer tenant through the process of deploying Tweelin for Microsoft Teams through policy.
Before you start...
- Make sure you are a Microsoft 365 and Teams administrator.
- Make sure you have started a Tweelin Free Trial or purchased the desired amount of licenses.
Tweelin for Microsoft Teams Deployment Process
STEP 1- Log in to the Microsoft Teams admin center
STEP 2 - Go to Teams apps > Manage apps
STEP 3 - Search for the Tweelin app and open it
Open the All apps tab and Search for “Tweelin”.
Click on “Tweelin” in the search results to open its properties.
STEP 4 - Define the app availability
Go to the Users and groups tab and edit the app availability as needed.
We recommend maximizing the availability to provide higher value through network effects.
STEP 5 - Grant the required permissions
Go to the Permissions tab, click on Grant admin consent, review the required permissions and grant them.
STEP 6 - Go to Teams apps > Setup policies
STEP 7 - Select the policy you want to use to deploy Tweelin
STEP 8 - Search and select Tweelin to install it via policy
In the Installed apps section, click on Add apps.
Search for “Tweelin” and select the resulting app, then click Add.
STEP 9 - Pin Tweelin to the left navigation bar
In the Pinned apps section, click on +App apps.
Search for “Tweelin”, selct it and click Add.
Drag Tweelin up/down to the desired menu position, then Save and Confirm.
STEP 10 - Set up the Application Access Policy for the Tweelin bot
Setting up the Application Access Policy is a fundamental step to allow end users to benefit from serendipitous conversations not only with colleagues within the same Microsoft 365 tenant, but also with coworkers and partners in other tenants.
This policy allows the bot component of the Tweelin App for Microsoft Teams to create meetings and therefore fulfill wishes for users across tenants.
Setting up the Application Policy may happen in two ways, reflected in the following options.
OPTION 1 - Install from PowerShell
OPTION 2 - Install from Azure Cloud Shell (Coming Soon)
OPTION 1 - Install from PowerShell
Instructions for Windows
For macOS go to the end of this section
1. Open Windows PowerShell as Administrator on your device
2. Install the Microsoft Teams PowerShell Module
If not already installed, run the following command: Install-Module -Name MicrosoftTeams
Then, Type ‘A’ and press enter to proceed.
3. Connect to Microsoft Teams
Use an admin account that has permissions to manage Microsoft Teams and related policies for your organization.
To connect via PowerShell, type: Connect-MicrosoftTeams
After pressing Enter, a sign-in popup will appear.
Sign in using your Microsoft 365 admin credentials.
If using MFA, complete the authentication.
On successful login, you will see your admin email, and the ‘Tenant ID’ (or the organization ID) of your organization.
MAKE A NOTE OF YOUR TENANT ID – YOU WILL NEED IT LATER.
4. Create the Access Policy
In PowerShell, type the following command:
New-CsApplicationAccessPolicy -Identity TweelinBotAccessPolicy -AppIds “40c028b3-19db-49e7-be67-be41646e6b23” -Description “Allows Tweelin bot to create online meetings.”
The AppId “40c028b3-19db-49e7-be67-be41646e6b23″ is the Azure AD App ID (Client ID) of the Tweelin bot.
This creates a new policy that authorizes the bot to access onlineMeeting Graph resources.
5. Grant the policy to your tenant
In PowerShell, type the following command to provide access to your tenant.
Grant-CsApplicationAccessPolicy -PolicyName TweelinBotAccessPolicy -Global
6. Verify the assignment
In PowerShell, run the following command:
Get-CsApplicationAccessPolicy
You should see the TweelinBotAccessPolicy listed for your tenant
Instructions for macOS
1. Install PowerShell
Use Homebrew and type the following command:
brew install –cask powershell
Launch PowerShell
2. Follow Windows instructions, steps 2-6 in the previous section
Follow the same Windows procedure, steps 2-6, starting from Install-Module -Name MicrosoftTeams – all
PowerShell commands are the same across platforms.