> For the complete documentation index, see [llms.txt](https://docs.adalysis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adalysis.com/integrations/microsoft-teams.md).

# Microsoft Teams

Receive alert notifications in the Microsoft Teams channels of your choice

Alerts are only useful if someone sees them in time. Connect Microsoft Teams, and Adalysis posts your notifications to a Teams channel as cards. Each card has a title, a short summary, a line naming the platform, ad account, and login, the notification's rows (up to 25, then "and N more"), and an **Open in Adalysis** button that opens the right screen.

Teams works alongside email and Slack. You decide which notifications go to Teams, which go to email, which go to both, and which go nowhere.

**What you can send to Teams**

* Performance monitor alerts (on Meta logins these include rule findings)
* Performance goal alerts
* Critical alerts (issues stopping your ads from running), for Google Ads and Microsoft Ads logins
* Routine tasks reminder, for Google Ads and Microsoft Ads logins
* Health alerts, for Meta logins
* Budget spend alerts
* Budget pacing alerts
* Budget rollover

Teams also receives the notices Adalysis always sends, whatever is ticked: when it couldn't do something it was asked to do (for example, campaigns that couldn't be paused, budget changes that failed, or budget automation turned off because Google refused its changes), conversion set alerts, and connection alerts when a login loses access to its ad platform.

**Why this is useful**

* Critical alerts and budget pacing issues reach the whole team at once, so problems get fixed faster.
* The team shares one view of what needs attention, instead of each person forwarding emails.
* Personal inboxes stay quiet: send team-wide alerts to Teams and keep email for the things only you need.

***

**Before you connect**

* The **Owner and Admins** can add and remove Teams channels and choose which channel each login uses. An Admin can only choose channels for the logins they can open, and can't remove, test, or change a channel that also serves logins they don't manage.
* Adalysis connects through a Teams **workflow**. Your organization must allow the **Workflows** app in Teams.
* The cards are posted by the Workflows app on behalf of the person who created the workflow. If that person leaves your organization, the workflow stops, so ask a Teams admin to add a co-owner to the workflow.
* Each login sends to one channel, so you can, for example, give each client their own. An Adalysis account can have **up to 20 notification destinations** in all (Zapier hooks, Microsoft Teams workflows, webhooks, and Google Chat spaces together; Slack channels don't count).

***

**Setting it up**

1. In Teams, open the channel you want notifications posted to. Select **More options (…)** next to the channel name, then **Workflows**.
2. Choose the template **Send webhook alerts to a channel**. Pick the team and the channel, save the workflow, and copy the webhook link it shows.
3. Open your **Adalysis account** (the tile at the top of the rail on the left) and go to **Notifications**. On the **Notification destinations** card, click **Add a Microsoft Teams workflow**.

   ![Open your Adalysis account (1), Notifications (2), then Add a Microsoft Teams workflow (3)](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2F4mjkHxoXWwaKAi3qQetL%2FTM-01.png?alt=media)
4. Give it a name (for example, the name of its channel), paste the **Webhook link** and click **Add**.

   ![Add a Microsoft Teams workflow: a name (1), the webhook link (2), then Add (3)](https://3203600314-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGlXujWJyreRidNjZDCw2%2Fuploads%2FQCrvZwCzPAtjw1BFcZAE%2FTM-02.png?alt=media)
5. Adalysis sends a test first. If Teams refuses it, the workflow isn't added and you'll see why. If Teams can't be reached at that moment, the workflow is added anyway, and you'll be asked to send it a test event later. Repeat for any other channels you want.
6. Under **Ad platform logins**, the new channel is already chosen in the **Microsoft Teams** column for every login that didn't have one. To change a login's channel, or turn it off with **No Microsoft Teams**, choose it and click the **Save** next to it.
7. Open each login in the app, go to **Settings** > **Notifications** and tick the **Microsoft Teams** column for each notification you want sent there, then click **Save**. On a team, only the login's main user can change this column; other team members see it read-only.

Scheduled notifications arrive at the delivery time and time zone set in the login's **Settings** > **Notifications**. Budget alerts are sent as soon as they happen.

**Which link to paste:** the webhook link of a Teams workflow starts with `https://` and contains `environment.api.powerplatform.com`. Older kinds of link are no longer supported, because Microsoft has retired them:

* links containing `logic.azure.com` (older workflows): open the workflow in Teams, copy its webhook link again, and paste the new one;
* links containing `webhook.office.com` or `outlook.office.com` (Office 365 connectors): create a workflow as described above instead.

***

**Changing or removing a channel**

To send a login to a different channel, choose the new channel for that login under **Ad platform logins** and click **Save**. To stop using a channel, click **Remove** next to it.

If the workflow is deleted or turned off, or its link changes, Teams stops accepting messages and the channel shows **Microsoft Teams stopped accepting it: send a test event once it is fixed** on the **Notification destinations** card. The account's owner gets an email about it. In Teams, check that the workflow is on and copy its webhook link again, then add it in Adalysis, or click **Send test event** once it's fixed.

**A test card was accepted but doesn't show in the channel?** Teams accepts the message first and posts the card a moment later. If the card doesn't show within a minute, open the **Workflows** app in Teams and check the workflow's run history.

For everything else, such as delivery time, email address, and which accounts you get notified about, see [Notifications](https://docs.adalysis.com/onboarding/getting-started/core-account-settings/notifications).
