Microsoft Teams

Send Coalesce Quality alerts to channels in Microsoft Teams, and mention team members in them.

​

Before you start

• One integration per team. Each Microsoft Teams team you want alerts in is its own integration in Coalesce Quality.
• Install the app once per team, never per channel. One install covers every standard channel in the team.
• Only standard channels can receive alerts. Private and shared channels are not listed and cannot be chosen.
• A team can be connected to one Coalesce Quality workspace only.

​

Install the app in your team

Ask your Microsoft Teams admin to install the Coalesce Quality app, available here, in the team you want alerts in. The simplest way is to open the team’s menu, choose Manage team, then Apps, and upload the app there.

You can also connect the team in Coalesce Quality first and install the app afterwards. See below.

​

Connect the team in Coalesce Quality

1. In Microsoft Teams, open the team’s menu and choose Get link to team.
2. Add an integration on the and choose Microsoft Teams.
3. Paste the link into Team URL and save.

When you save, Coalesce Quality checks the team with Microsoft Teams:

• The app is installed: you see the channels alerts can be sent to, and the integration is ready.
• The app is not installed yet: saving is still fine. The integration waits for the install and checks again every 20 minutes. To pick it up straight away, press Refresh on the integration page once the app is installed.
• “This isn’t a Microsoft Teams team link”: the link is for a channel or a chat, not the team. Copy it again with Get link to team.
• “This Microsoft Teams team is already connected to another Coalesce Quality workspace”: the team can only be connected once. Remove it from the other workspace, or use a different team.
• Microsoft Teams refuses the app (your admin has disabled it, or it is not allowed in your tenant): the integration is not saved. Fix what the message says, then save again.
• Microsoft Teams could not be reached: the integration is saved anyway and checked again automatically.

​

Keep channels up to date

Coalesce Quality reads the team’s standard channels from Microsoft Teams every hour. The integration page has a Channels section with a Refresh button that reads them right away and shows the result.

Press Refresh:

• after installing the app in the team,
• after adding or renaming a channel, if you want to use it before the next hourly read,
• after fixing anything a health message asks you to fix (see below).

The refresh button next to the Channel picker on an owner only reloads the list Coalesce Quality already has. It does not ask Microsoft Teams for new channels. Use Refresh on the integration page for that.

​

Send alerts to a channel

To send alerts to a channel through an owner, create or edit the owner. Under Notification method, the Microsoft Teams section has:

• Channel: the channel alerts for this owner are sent to.
• Mentions: optional team members to mention in each alert.

Every alert sent to that owner then lands in the chosen channel.

You can also send an alert straight to a channel, without an owner, with Add Teams channel on the alert. See Routing alerts.

​

Integration health messages

The integration reports its health on the integrations page and in the workspace status in the header. The team check (the first five messages below) reports only when its result changes, so its message stays until the next change. Every alert sent reports its own delivery result, so a delivery message is replaced by the next alert’s, and a successful one reads “Message delivered”.

Message starts with	What it means	What to do
Connected to Microsoft Teams	The app is installed and Coalesce Quality can see the team’s channels.	Nothing.
Install the Coalesce Quality app in this team	The integration exists but the app is not installed in the team yet. Coalesce Quality checks again every 20 minutes.	Install the app in the team, then press Refresh.
Your Microsoft Teams admin has disabled the Coalesce Quality app	Your tenant’s admin has blocked the app. Nothing is delivered.	Ask your admin to allow the app, then press Refresh.
Microsoft Teams rejected the Coalesce Quality app’s access	Microsoft Teams no longer accepts the app’s access to the team.	Reinstall the app in the team, then press Refresh. Contact support if it happens again.
Microsoft Teams refused the Coalesce Quality app access	The app is not allowed in your tenant, or not installed in this team.	Check that the app is allowed in your tenant and installed in the team, then press Refresh.
Channel ’…’ no longer exists in Microsoft Teams	An alert was sent to a channel that has been deleted.	Choose another channel for the owner or alert that uses it.
Delivery failed: Microsoft Teams refused the Coalesce Quality app	An alert could not be delivered because the app is not allowed or not installed.	Check that the app is allowed in your tenant and installed in the team.
Delivery failed: Microsoft Teams authorization was revoked	An alert could not be delivered because the app’s access was revoked.	Reinstall the app in the team, then press Refresh.
Delivery skipped: the integration is disabled	Delivery is paused until the integration is working again.	Reinstall the app in the team, or ask your admin to allow it, then press Refresh.
Delivery failed after … attempts	An alert could not be delivered after several retries.	Check the rest of the message. If the problem persists, contact support.
This Microsoft Teams integration no longer exists	The integration was removed.	Add the integration again if you still need it.

​

Troubleshooting

• There is no Microsoft Teams section on an owner. The workspace has no Microsoft Teams integration yet. Connect the team first.
• An owner or alert says “The Coalesce Quality app is not installed in your Microsoft Teams team yet”. Install the app in the team, then press Refresh on the integration page.
• A channel is missing from the Channel picker. Private and shared channels cannot receive alerts. For a new or renamed standard channel, press Refresh on the integration page, then reload the picker.
• Saving the integration says the team is already connected to another workspace. A team can be connected to one Coalesce Quality workspace only. Remove it there first, or use a different team.