Microsoft Teams Integration: Setup (Cloud)

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". 

commands.png

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. 

ms-teams_messages_-_de.png

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.

Azure_Manifest.png

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

API-Berechtigungen.png

When these are set up you navigate to "Expose an API" and click "Add a scope":

API_verfu_gbar_machen.png

You need to fill out "Add a scope" like this:

Bereich_hinzufu_gen.png

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

Anwendungs-ID-URL.png

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.

Developer_Portal.png

 

Navigate to "Apps", click on "Import app" and upload the manifest "COYO_MS_Teams_Manifest.zip" that is attached to this knowledge base article.

App_importieren.png

Click on the newly imported app and navigate to "Branding" to adjust icons and the color of the Teams app.

Branding.png

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".

App_Features.png

Perso_nliche_App.png

This URL always needs to be your Haiilo domain + "/web/teams/teams-tab" (e.g. https://test.coyocloud.com/web/teams/teams-tab).

Registerkarte.png

Perso_nliche_App_speichern.png

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:

Bot.png

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.

Grundlegende_Informationen.png

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).

SSO.png

To check if everything worked correctly you can navigate to "Domains" and see if your domain was added automatically.

Doma_nen.png

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.

Screenshot_2022-06-16_at_14.58.50.png

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.

Screenshot_2022-06-16_at_15.00.47.png

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.

Haiilo notifications in the Microsoft Viva Dashboard

Finally, all notifications at a glance! Do you use Microsoft Teams and don't want to miss any notifications? No problem, the Microsoft Viva dashboard brings Haiilo notifications to your Teams.

Note:
At least version 41 in the cloud is required for the integration. Additionally, an active Microsoft 365 integration and the add-on "Microsoft 365" is required.

Prerequisites

First, you create the prerequisites within Microsoft Azure.
First, navigate to the Haiilo app created in Azure.

Note:
You have created this app within the authentication of the Microsoft 365 integration. You have not yet performed authentication? Then you can find the corresponding explanation here.

Now rename the app to "COYO App". At this point it is important that you pay attention to the exact spelling as well as upper and lower case.

 

azure_essetials.png

Now copy the "Directory ID (client)" and keep it in the clipboard for the next step. Alternatively, you can also store it in a safe place.

azure_settings.png

Now open Haiilo and navigate to Administration. Here, under the "Authentication" tab, you will find the "Authentication provider" that you added during the activation of the Microsoft 365 integration.

In the "Settings" section, enter the previously copied "Directory ID (Client)" in the "Customer ID" field.

coyo_administration.png

Installing the card

Install the attached file "haiilo-notifications-ace.sppkg" on your SharePoint tenant.

Note:
In this area of the SharePoint administration there is no German language variant on the part of Mircosoft. Therefore we have used English screenshots in the following.

Log in to your SharePoint environment with your admin account, open the "SharePoint App Catalog" and navigate to the category "Apps for SharePoint". Click on "Upload" and upload the file previously provided by the Haiilo Service Desk.

mceclip5.png

In the next window, first, check the box and then click on "Deploy".

mceclip6.png

Finally, navigate to the "SharePoint Admin Center". Here you will find the settings for "API access" under the "Advanced" tab and confirm both access requests of the "Haiilo notifications" application.

mceclip7.png

The card should now have been successfully added to the catalog.

Putting on the card

Almost done! All preparations are done. Now you can install the new map in the Microsoft VivaDashboard in just a few steps.

To do this, open the Microsoft Viva Dashboard, enter the "Edit Mode" and add the "Haiilo Notifications ACE" map to the Dashboard.

Finally, edit the map by clicking on the pencil icon and enter the URL of your Haiilo instance in the "Tenant URL" field.

settings_viva_card.png

That's it! Now you have all notifications in view for the future.

Was this article helpful?