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:
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://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.
Start a Microsoft Teams Chat from Haiilo
What are the requirements?
In order to use this feature, a few requirements have to be met:
- Your instance is hosted in the Haiilo Cloud.
- You need a valid Microsoft 365 license and your Haiilo instance must have an active Microsoft 365 integration (Microsoft 365 add-on).
- Your role must have the "Send messages via Microsoft Teams" permission enabled.
- 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.
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.
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.
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.
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.
In the next window, first, check the box and then click on "Deploy".
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.
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.
That's it! Now you have all notifications in view for the future.