No more parallel operation: Your Haiilo environment and Microsoft Teams now work together. The new integration brings the content of your Haiilo homepage(s) directly into your Teams.
First, you create the prerequisites within Microsoft Azure. For this you need to navigate to the app registration you have already created for the Microsoft 365 integration with Haiilo (article: Microsoft 365 integration).
Now you need to adjust the attribute "accessTokenAcceptedVersion" in the manifest you can find on the left side. The default value is 0 and this needs to be 2.
Afterwards you switch to the API permissions to make sure that you have these permissions set up and granted by the admin:
When these are set up you navigate to "Expose an API" and click "Add a scope":
You need to fill out "Add a scope" like this:
In the same menu but at the top of the page you need to edit the "Application ID URI". This URl is always built like this:
For example it will look like this:
Please write down this Application ID URI because it is needed later on
In the last step you need to add a client application in the same menu but at the bottom of the page. It is important that you will add exactly these client IDs:
- for the mobile and desktop Teams app: 1fec8e78-bce4-4aaf-ab1b-5451cc387264
- for the browser Teams app: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346
Upload, configure, and publish the Teams app
Now we will configure the Teams app within the Developer Portal of MS Teams.
Navigate to "Apps", click on "Import app" and upload the manifest "COYO_MS_Teams_Manifest.zip" that is attached to this knowledge base article.
Click on the newly imported app and navigate to "Branding" to adjust icons and the color of the Teams app.
Now you need to adjust the URL of the "Home" tab inside the Teams app. For this you navigate to the "App features", "Personal app" and edit the option "Home".
This URL always needs to be your Haiilo domain + "/web/teams/teams-tab" (e.g. https://test.coyocloud.com/web/teams/teams-tab).
Done - the home tab is customized. For the final configuration of the chat bot, navigate back to the "App Features" and go to "Bot". There you have to select the bot with the ID "b9b1a423-1e58-458b-9ef6-4b4c7ddb5271" and the following settings:
If this is correct you navigate to "Basic information" and adjust the "Application (client) ID" with the one you can find in your Azure app registration.
You can also adjust the name and description of the app if wanted.
Afterwards you navigate to "Single sign-on" and enter your Application ID URI you have entered before (e.g. api://core.coyocloud.com/e7d2fcb0-4c19-43a8-8ccc-2605be203fac).
To check if everything worked correctly you can navigate to "Domains" and see if your domain was added automatically.
Now you can publish your Teams app for everybody in your Teams organisation or even globally. Please check the official Microsoft documentation for further publishing steps.