Put an end to parallel operations: Your Haiilo Cloud environment and Microsoft Teams now work together! Download the Haiilo app from the Microsoft Teams App Store and you can always be informed straight away about the latest company news via Microsoft Teams.

Note:
For the Cloud, these features are already available. For on-premises customers, the Haiilo Timeline and Haiilo Chatbot features in teams are not available.

Integrate Haiilo into Microsoft Teams

Integration takes place quickly: Look for "Haiilo" in the Teams App Store and download the app. Then open the Teams app "Haiilo" and log into the app with your Haiilo account via the command "Sign in". 

A new window then opens, in which you enter the URL of your Haiilo instance and then your login details. 

This is what it looks like

You will now be informedautomatically in Teams whenever a new blog article has been published in Haiilo. You get an article preview in the form of the title, picture, and short teaser text. To read the detailed article, simply click on the button "Read entire article on Haiilo" and you’ll be forwarded to the article in Haiilo. 

Integrate Haiilo centrally for all users in Teams

Microsoft Teams administrators can also preinstall the "Haiilo" app for all users in their organization. The users only need to dial in with their account to keep up to date. The Teams administrators can also set that the Haiilo app is positioned in the navigation to give users direct access to the Haiilo stream. 

Microsoft Teams integration is available for all Cloud customers.

Note:
The basic prerequisite for using this function is Microsoft 365 integration in your Haiilo instance. 

Integrate Haiilo homepages in the MS Teams app

Requirements

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.

Afterward, you switch to the API permissions to make sure that you have these permissions set up and granted by the admin:

email
offline_access
openid
profile
User.Read

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:

api://COYO-domain/applicationId

For example it will look like this:

api://core.coyocloud.com/e7d2fcb0-4c19-43a8-8ccc-2605be203fac

Note: 
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://next.coyostaging.com/web/teams/teams-tab). The Scope should be set as personal and the Context should be set as personalTab.

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.

Start a Microsoft Teams Chat from Haiilo

What are the requirements?

In order to use this feature, a few requirements have to be met:

1. Your instance is hosted in the Haiilo Cloud.
2. You need a valid Microsoft 365 license and your Haiilo instance must have an active Microsoft 365 integration (Microsoft 365 add-on).
3. Your role must have the "Send messages via Microsoft Teams" permission enabled.
4. You must be logged in via Microsoft Single Sign On.

How exactly does the feature work?

You navigate to the profile of the person you want to contact. If all requirements are met, you will see a Chat on Teams button. With one click, you open the dropdown menu and choose whether you want to start a chat with the person or call them with or without activated video.

If you have the Microsoft Teams desktop app installed, the app will open. Otherwise, you will have the option to use Microsoft Teams directly in the browser.

• coyo-notifications-ace.sppkg20 KB
• MS Teams Haiilo Manifest.zip7 KB