Please Note: The new Teams experience breaks the current version of the CloudRadial Teams application. The new Teams version is in Preview mode and does not support the function to add custom apps, breaking the CloudRadial app in the process.
With CloudRadial, you can present your portal as a tab inside your client's Teams application across all the platforms that your clients utilize Teams (PC, Mac, and Mobile). Not only does this make your portal easily accessible, but it also uses the users' Teams identity to automatically log them into the portal.
Setting up the Application
- Go to Partner > Settings
- Choose Teams App (located under the Configuration column on the right).
- Select Settings at the top right.
- Define your app information and icons. Icons must be stored in the Media section under Partner > Account.
- For images, you'll need two icons both in PNG format:
- Full-color icon used in information screens. This icon should have a transparent background. (192x192px)
- Single color icon for use in the Teams navigation bar. This icon should be white on a transparent background. (32x32px).
- Finalize your settings and select Submit at the bottom to save.
- Once the application settings have been set, the option to Download App will be available below to create the ZIP file to deploy.
Setting up Team's Theme Support
CloudRadial includes two new themes to support Teams in both light and dark variations. Users have the option of choosing these themes in regular use or you can specify that these Teams-designed themes are use whenever CloudRadial is run inside of Teams. To set automatic theme switching:
- Go to Partner > Settings
- Choose the Account & Branding at the top right of the page.
- Choose the Branding tab.
- Check the box for "Automatically override theme when running inside Teams?"
- You can also specify alternate logos for your partner account based on the light or dark nature of the themes. Teams-designed themes use the dark variation of the logo.
Adding Custom Links for All Clients
- Go to Partner > Settings and choose the option for "Teams App".
- Click the Add Tab at the top right, The Custom Tabs you configure on this page will appear in the Teams App. You may add up to fifteen tabs.
- Links can reference web applications or specific CloudRadial pages.
Downloading Your App
- Go to Partner > Settings and choose Teams App.
- Choose the Download App button to download the current version. If this button does not appear you must setup your app's settings (see above).
- If you make changes to your portal name or desktop icon, you will need to redownload the app and reinstall for clients.
Installing Your App in Teams:
Method 1 - Within Teams
- Click the Apps option on the lower left side of your Teams client.
- Choose the Manage your apps at the bottom of the screen
- Select Upload an app within the Teams client (near the top of Teams)
- Select Upload a custom app from the popup that appears
Follow through with the prompts to add it to your local Teams client.
Method 2 - Using Teams Admin
- Go to the Microsoft Teams admin center (for your company or the desired client): https://admin.teams.microsoft.com/
- Upload the ZIP file using the +Upload button at the top of the Apps list.
- This must be done for each client in their respective Microsoft Teams Admin Centers.
- In order to deploy the app, you need to have a licensed admin user. You can assign a license, install it, then "unlicensed" the user in case your admin accounts don’t have a license.
Clearing Teams Cache
When installing or updating your Teams App, the prior version may be cached. Teams does not have a way to clear its cache, so the following workaround is required.
- Quit Microsoft Teams. Right-click the icon and select Quit.
- Cut and paste the following location into File Explorer: %appdata%\Microsoft\Teams
- Delete the contents of the entire folder.
- Restart Microsoft Teams.
Alternatively, you can also download a PowerShell script here that will clear the cache for you.
Note: We also recommend clearing the Teams cache while troubleshooting issues with login to CloudRadial in Teams.
Uploading via PowerShell
Microsoft provides PowerShell features manage Teams including uploading apps. More information on Microsoft's PowerShell Teams capabilities are located here:
More Information from Microsoft
If you're having trouble adding the custom app, refer to Microsoft's documentation on additional ways to deploy the application:
Using the Teams App
As a tab, CloudRadial performs just as it does in the web version with a few exceptions:
- There is no logout button. Users are verified by their Teams user Id and the concept of logging in as a separate user is not available.
- Impersonation and other activities will open a separate browser window and won't stay within Teams.
- Downloads are stored in the default downloads directory or are accessible under the Files tab on the left side of Teams.