Microsoft Teams

Add Cortex Hub, or a single app, to your organisation's Microsoft Teams: publish, update, approve, pin and fix what the status line reports.

Many people spend their day in Microsoft Teams. Add to Teams puts Cortex Hub in the app list of your organisation's Teams, so they can ask Cortex a question, decide a task or open a dashboard without leaving the place where they talk to colleagues. You can do the same for a single app, which then gets its own entry in Teams.

This page is the administrator's side: publishing, updating and keeping it in step. What people see once it is there is described in Cortex in Microsoft Teams.

Who can do this

Admins of Cortex Control. The Hub block is on Settings, Channels (in the group Rules & cost), under Microsoft Teams. The block for one app is on the app's own page, and is for admins only. Some steps also need your organisation's Teams administrator.

How it fits together

Control publishes

Cortex Control makes the Teams package and puts it in your organisation's Teams app list.

Teams admin approves

Only when your Teams settings ask for it. Teams can take up to two days to show the app.

You pin it

Optional: pin the app for people in the Teams admin center. Cortex never pins it by itself.

People open it

Under Apps, Built for your org, or in the left bar when pinned.

You publish, your Teams administrator approves where needed, and people find it in Teams.

The Teams block

The Microsoft Teams block with a status line, the main button, the Download package button and the link to pin the app in the Teams admin center.
Settings, Channels, Microsoft Teams. Here an update is available, so the main button is Update Teams. 1 is Download package, 2 the link to the Teams admin center.

The block shows a status line with the Teams icon, and under it the main action for that status. You always see two things next to it:

  1. Download package. Downloads the Teams package as a zip file, for when Cortex cannot publish by itself (see below).
  2. Pin it for people (Teams admin center). Opens the place in the Teams admin center where you pin the app for people. Cortex does not pin it for you.

After a first publish, the status line also says who published last ("Last published by …").

Add Cortex Hub to Teams

Open the block

Open Settings, then Channels, and scroll to Microsoft Teams. The status line says where things stand.

Choose Add to Teams

When the line says Not in Teams yet., choose Add to Teams. The button shows Publishing… while it works, and a message says what happened ("Version … is in Teams." or "Version … is waiting for your Teams admin's approval.").

Wait for approval if needed

If your Teams administrator must approve new apps, the line says Waiting for your Teams admin to approve version … in the Teams admin center. Ask them to approve it. After it is published, Teams can take up to two days to show the app in its app list.

Pin it for people (optional)

Choose Pin it for people (Teams admin center) to open the Teams admin center, where you can add the app to a setup policy so it appears in everyone's left bar. This is optional: people can always find the app under Apps, Built for your org.

What the status line can say

Status lineWhat it meansWhat you do
Not in Teams yet.Cortex Hub is not in your Teams app list.Choose Add to Teams.
"… is already in Teams (…), uploaded by hand. Update that one instead of adding a second."An earlier copy was uploaded by hand.Choose Update it, or Add as a new app if you really want a second one.
Waiting for your Teams admin to approve a versionPublished, but your Teams administrator has to approve it first.Ask the administrator to approve it in the Teams admin center.
"Published version …. Teams can take up to two days to show it in its app list."Published and accepted; Teams is still spreading it.Wait.
"In Teams, version …. Up to date."Nothing to do.Nothing.
"Update available: what Teams shows has changed since …"What Teams shows has changed since the last publish.Choose Update Teams.
"Removed in the Teams admin center."Someone removed the app in Teams.Choose Add to Teams again.
"Control may not publish Teams apps yet. An administrator who can grant organisation-wide permissions allows it once."The first time, Cortex Control needs permission to publish Teams apps.Choose Allow Control to publish Teams apps. A Microsoft administrator who can grant organisation-wide permissions approves it once, and you return to this page.
"Control has no Microsoft Graph credentials, so it cannot publish to Teams. Download the package and upload it in the Teams admin center."Cortex cannot publish by itself on this install.Choose Download package and upload the zip in the Teams admin center.
"Teams could not be reached: …"Microsoft did not answer.Try again in a moment.
"Set the Hub address on Control first."The install is missing the address of the Hub.Ask whoever runs your Cortex install.
"Could not load the Teams status."The status could not be read.Use the retry button, or reload.

Hub updates reach Teams by themselves: the app in Teams opens the live Hub. You publish again only when the page says that an update is available.

Put one app in Teams

An app can get its own entry in Teams: one tab that opens just that app through the Hub, with the same sign-in and the same access.

Open the app

Open Apps and choose the app, or open it from Experiences.

Find the Teams card

On the Overview tab, find the card Teams. It reads: "Give this app its own entry in Teams: one tab that opens the app through the Hub, with the same sign-in and access."

Add, update or download

It works exactly as for the Hub: Add to Teams, Update Teams, Download package, and the same status line. When the app has a logo, Cortex draws the Teams icons from it; when that fails you are told "The app's logo could not be drawn, so the Cortex icons are used."

Example: Brightwater Foods puts the Hub in Teams

Brightwater Foods runs its morning meeting in Teams. The plant manager wants the OEE dashboard one click away.

  1. Sam de Vries opens Settings, Channels, Microsoft Teams. The line says Not in Teams yet. and Sam chooses Add to Teams.
  2. The line changes to "Waiting for your Teams admin …". Sam asks Priya, the Teams administrator, who approves the version in the Teams admin center.
  3. Priya also pins the app for the plant team through Pin it for people (Teams admin center).
  4. Next day the line says "In Teams, version …. Up to date." The plant manager opens Cortex Hub in Teams and sees the same dashboards as in the browser.

Questions and problems

On this page