Setting up a Microsoft Teams app (Public Cloud)

This feature is available with:

Don't know which module you're using? Find out here.

  • Module: Social Intranet
  • Add-on: Microsoft

We have a new MS Teams app! The instructions in this article are for the new MS Teams app configuration. If you are configuring your old app, please refer to the legacy Microsoft Teams setup article for assistance with your configuration: Setting up a Microsoft Teams integration (Legacy).

Are you looking to transition from an old to the new app? Read our recommended steps for a successful transition in this article.

Users can easily explore their Haiilo platform and its content right in MS Teams! You have the option to give them the full experience within Teams or just a view of your homepages. If you choose the full experience, users can see and interact with everything directly in Teams. If you go with the homepages view, they can still like and comment on content, but clicking a link will open the Haiilo platform in a new browser tab.

Additionally, users get notifications for new blog articles and Studio posts. They'll see the post title, a little teaser, and an image. Clicking the post will take them to the Haiilo platform in a browser to read the full article. When new posts are available, a number will appear on the app in Teams, notifying you to check the notifications.

To use the Microsoft Teams integration functionalities, you need to first set up an OpenID authentication provider and activate the Microsoft add-on. Please complete the Microsoft authentication setup and add-on activation before proceeding with these setup instructions.

1. Update Your Entra ID App

You need admin rights in your Microsoft Entra ID account to complete these steps.

  1. Log in to the Microsoft Azure Platform.
  2. Go to Microsoft Entra ID > App registrations > select the app that you created when setting up the Microsoft authentication and add-on for Haiilo.
    1. Go to Manifest.
    2. Set the attribute for "requestedAccessTokenVersion" to 2. In some versions, the default value is null, and it should be 2.ms graph manifest token.png
    1. Go to API permissions.
    2. Add permissions > Microsoft Graph > Application permissions.
    3. Add or make sure the following API permissions are added:
      • TeamsAppInstallation.ReadWriteSelfForUser.All
      • AppCatalog.Read.All
      • User.Read.All
    4. Select Grant admin consent for app_name for the added permissions and ensure the status for all permissions is marked Granted for your_tenant.api permissions ms graph for teams.png
    1. Go to Expose an API > Add scope
    2. In the field Application ID URI, add your Haiilo domain and Microsoft application ID in this format:
      • api://your_haiilo-domain/applicationId . Example: api://example.haiilo.app/e7d2fcb0-4c19-43a8-8ccc-2605be203fac
    3. Select Save and Continue.
    4. If the Application ID URI is successfully updated, another pop-up will appear. Fill out the fields as follows:
      • Scope name: access_as_user
      • Who can consent: Admins only
      • Admin consent display name: access_as_user
      • Admin consent description: access_as_user
      • State: Enabled
    5. Select Add Scope 
    6. Confirm that the new Application ID URI is added (this URl is always built as api://your_haiilo-domain/applicationId).
    1. In the same section as above (Expose an API), select Add a client application.
    2. Add both these Client IDs one by one:
      • 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (For the mobile and desktop MS Teams app)
      • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (For the browser MS Teams app)
    3. Select the checkbox to authorize the Client ID for the scope you created above
    4. Select Add Application
    5. Repeat once for the other Client ID. Both are required.

Continue to the next steps.

2. Download Haiilo's Teams App Manifest

You need "Manage integrations" permission to complete these steps.

  1. In Haiilo, go to Administration > Integrations > MS Teams.
  2. Toggle on the MS Teams settings.
  3. Scroll down to the bottom and find your Haiilo authentication provider that matches your Entra ID app. If you have multiple authentication providers, you need to set up the Teams app for each separately.
  4. Select Download next to the authentication provider to download the manifest.
  5. Under   , activate the MS Teams app. You can do this later as well, but we recommend doing it now so you don't forget. This will ensure your Teams app is active as soon as it is published.
  6. Select the platform experience for your Teams app(s). All your apps will use the same view. You can change the view later, and it will take effect in already installed MS Teams apps:
    • Full view: Your users can experience the full Haiilo platform within the Teams app. Currently, this excludes access to the Administration or using/viewing other Microsoft integration features.
    • Homepages only: Your users can only view the homepages within the Teams app. They can like and comment on posts on the timeline, but selecting any other element will open the platform in a browser.
  7. Continue to the next steps.

ms teams setup in haiilo.png

For technical reasons related to how Microsoft Teams currently handles external integrations, the Haiilo integration is embedded as an iFrame. This architectural constraint may, at times, affect the Haiilo platform experience within Teams. As a result, certain areas and functionalities may not appear or behave exactly the same as in the full browser version of Haiilo.

3. Import the Teams App

You need admin rights in your Microsoft Teams Developer Portal to complete these steps.

  1. Log in to the Developer Portal in Microsoft Teams.
  2. Go to Apps > Import app and choose the recently downloaded manifest. Screenshot 2023-12-15 at 14.48.41.png

  3. Haiilo pre-fills the app information based on information from your Haiilo platform and your Microsoft authentication provider. You can optionally edit some information, including the app name, description, branding, etc., to make the app work for your organization.

    • Please do not modify the following settings. They are pre-configured based on your Microsoft app and Haiilo authentication provider and are necessary for the app to function correctly.

      • Application (client) ID
      • App features
      • Domains
      • Single Sign-On
  4. After configuring the app, you can test it by selecting Preview in Teams and then adding the app to Teams.
  5. If the app works as expected, you can Publish it to your organization per your company guidelines.

Once published, your users can open the app in MS Teams! 

 

Homepages only experience ⬇️

MS Teams homepage gif.gif

Full view experience ⬇️

MS Teams homepages Full View.png

New blog and Studio notifications ⬇️

Blog and Studio notifications in MS Teams.png

Was this article helpful?

0 out of 0 found this helpful