Skip to main content
Skip table of contents

Microsoft Teams Custom Imagicle Application

Overview

This article describes how to leverage Imagicle UC Suite applications within Microsoft MS-Teams desktop and mobile client, by using a specific Imagicle template.

Note: Imagicle apps are only available with MS-Teams thick client. Web-based client does not support Imagicle apps

Imagicle custom application for MS-Teams clients is available from 2021.Winter.1 release and above.

Please contact Imagicle to obtain the latest ZIP file including the Imagicle app for MS-Teams.

There are two possible ways to enable Imagicle apps in MS-Teams: by provisioning the apps at Corporate level to all MS-Teams user or by locally install the template in own MS-Teams client. Please find below both procedures.

Upload Imagicle applications in MS-Teams admin portal

Launch MS-Teams client on a PC and access to admin portal -> Teams Apps -> Manage apps -> Upload

Select the ZIP file provided by Imagicle and verify that the app "Imagicle" is published.

image-20250113-135622.png

Enable Imagicle apps in all MS-Teams clients

Now all Corporate MS-Teams user can leverage Imagicle apps. They just have to click on “…” button available in left pane. A list of items appears. Search for "Imagicle" and select relevant entry:

image-20250113-135644.png

The following window appears:

image-20250113-135659.png

Hit Add to actually add Imagicle apps to MS-Teams' left pane:

image-20250113-135712.png

Imagicle App access on M365 GCC environments

In such govt. environments, you might get an "Unable to access" error upon app access. This is happening because third-party apps are blocked by default:

image-20250207-143812.png

Please consult relevant Microsoft documentation for more details.

Procedure for local template installation in one client

Upload Imagicle applications in MS-Teams client

Launch MS-Teams client on a PC and click on “…” button available in left pane. A list of items appears. Hit More apps > link at the bottom of the list, to get the applications browser:

image-20250113-135722.png

Hit "Upload a custom app" option and choose the ZIP archive provided by Imagicle. If the template does not contain any error, you get the following message:

image-20250113-135735.png

Hit Add to actually add Imagicle apps to MS-Teams' left pane:

image-20250113-135745.png

If the template is faulty, you get the following message, where you can click on "Copy error" to copy the error details in PC clipboard:

image-20250113-135756.png

Trusted Digital Certificate Creation

MS-Teams accepts third party applications available through https access, together with a valid, trusted Digital Certificate. 

Imagicle UCX Suite includes by default a self-signed certificate, not suitable for MS-Teams apps.

To add a trusted certificate in Imagicle UCX Suite, please follow the procedure highlighted here

Procedure on MS-Teams client's workstation

Open Digital Certificate and import it for Current user. Hit Browse and select Trusted Root Certification Authorities installation path.

Troubleshooting

Can’t download recorded conversations

It might happen that you get the error “Couldn’t download – Needs authorization” while trying to download a recording:

image-20250207-144452.png

To override the problem, please click on "App permissions" to enable the access to external links:

image-20250207-144509.png

⬇️

image-20250207-144601.png

Additional hints and tips

If the Imagicle apps in MS-Teams are behaving in erratic way, not allowing to access some data or to perform some tasks, it might be the case you need to clean-up MS-Teams client's cache.

Please access to this folder on your PC: %appdata%/Microsoft/Teams  and delete all content. Then restart the client.

Please make sure that Microsoft domains are added in Imagicle UCX Suite IIS trusted sources, otherwise the Imagicle gadget doesn't work as expected. More details are available here.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.