> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams App

> Install the official Microsoft Teams app to post payment, refund, dispute, subscription, and payout cards from Dodo Payments to a Teams channel.

## What the Microsoft Teams app does

The Microsoft Teams app posts a card to one Microsoft Teams channel when an event occurs in your Dodo Payments business. You select the events and the filters.

> [!NOTE]
>
> To send events to Microsoft Teams through your webhook endpoint and your transformation code, use the [Microsoft Teams webhook connector](https://docs.dodopayments.com/integrations/microsoft-teams.md).

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You can add a Workflows template to the Teams channel that you want to use.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Microsoft Teams** (publisher **Dodo Payments**) and select **Install app**.

![The Configure tab of the Microsoft Teams app with the Connect button and the alert switches](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/microsoft-teams-1.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=fa79cfbd9bd5bcb88f3e1d8528ec0b53)

**2. Make the workflow in Teams**

In Microsoft Teams, add the Workflows template **Send webhook alerts to a channel** to the channel for the cards. It uses the trigger **When a Teams webhook request is received**. Copy the HTTP URL of the trigger.

The URL is a secret, because it lets a person post in the channel.

**3. Connect Microsoft Teams**

In Dodo Payments, select **Connect**. Paste the URL in the **Workflow URL** field, then select **Connect**. Dodo Payments posts a welcome card to the channel.

![The Connect Microsoft Teams dialog with the Workflow URL field](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/microsoft-teams-3.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=249948ee8513997c943f7b0223b70c0f)

**4. Choose the alerts and filters**

Open the **Configure** tab. Turn on the alerts that you need. Scroll down, set the filters, then select **Save**.

![The Products, Currencies, and Minimum amount filters on the Configure tab of the Microsoft Teams app](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/microsoft-teams-2.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=98f5a06917270c12cb30f7e2d0158caf)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Successful payments | Posts a card for each successful payment. | On |
| Failed payments | Posts a card for each failed payment. | Off |
| Refunds | Posts a card when a refund succeeds or fails. | On |
| Disputes | Posts a card when a dispute opens and when its status changes. | On |
| New subscriptions | Posts a card when a subscription becomes active. | Off |
| Subscription payment problems | Posts a card when a subscription is on hold, past due, or failed. | On |
| Cancellations | Posts a card when a subscription is cancelled or expires. | On |
| Payouts | Posts a card when a payout succeeds or fails. | On |
| Daily summary | Posts the event totals of the previous day (UTC) one time each day. | Off |
| Products | Payment and subscription cards only for these products. | All products |
| Currencies | Payment, subscription, refund, and dispute cards only in these currencies. | All currencies |
| Minimum amount | Payment, subscription, refund, and dispute cards only from this amount. Use a whole number in the main unit of the currency, for example 10 for 10.00 USD. | No minimum |

## What is sent and when

Dodo Payments posts a card after the event occurs. Each card shows the event type, the amount in the major unit, and the currency code. It can also show the customer email (or the customer ID), the product names, the ID of the object, the dispute status, and the dispute reason.

The cards contain no card data, no address, and no customer name. Test mode and live mode use different connections. To use a different channel, connect the app again.

Workflows has no duplicate check for a card. In rare cases, a retry can post the same card two times.

## Test the app

**1. Use test mode**

Install and connect the app in test mode. Turn on **Successful payments**.

**2. Make a test payment**

Create a test payment.

**3. Check Teams**

Open the channel. A payment card appears.

## Troubleshooting

| Problem | What to do |
| - | - |
| **Connection needs attention** | Workflows refused the URL or the workflow is deleted or turned off. Make the workflow again, then select **Reconnect** and paste the new URL. |
| The cards stop, but the connection shows no error | Workflows accepts a request before it posts the card. If the workflow fails later, for example because you removed the channel, Dodo Payments does not know about it. Check the run history of the workflow in Teams. |
| The cards stop after a person leaves your organization | A workflow belongs to the person who made it. Make the workflow again with an active account, then reconnect. |
| No card arrives | Check that the alert switch is on and that the filters do not skip the event. |
| A card appears two times | Workflows has no duplicate check. This is rare. |

## Disconnect and uninstall

Turn off the alerts on the **Configure** tab to stop the cards. Uninstall the app to delete the Microsoft Teams connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).

![The Installed tab of the Apps page with Microsoft Teams in the list and the status Active](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/microsoft-teams-4.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=3be0cbec56deaff9bc0dabcbc2a006ee)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.