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

# Microsoft Teams

> Send a notification message and/or a PDF download card to a Microsoft Teams channel when a quote is signed.

## Overview

This integration posts a message to a Microsoft Teams channel when a quote is signed in Qwoty. Optionally, it also sends a card with a direct download link to the quote PDF.

***

## Authentication

Teams incoming webhooks are now created via the **Workflows app** — the legacy Connectors method has been replaced.

1. In Teams, right-click the target channel → **Workflows**
2. Search for **"Send webhook alerts to a channel"** and select it
3. Rename the workflow if needed, authenticate with your account, then click **Next**
4. Select the **Team** and **Channel** where notifications should be posted, then click **Add workflow**
5. Copy the generated **HTTP POST URL** and paste it into the **Token** field in Qwoty

<Note>
  To retrieve the URL later: open the **Workflows** app in Teams → select the workflow → **Edit** → expand **When a Teams webhook request is received**.
</Note>

<Warning>
  The webhook URL grants write access to the channel. Treat it as a secret and do not share it publicly.
</Warning>

<Warning>
  Webhook availability depends on your organization's settings. If the template is not visible, contact your IT admin.
</Warning>

***

## Settings

| Key             | Default | Description                                               |
| --------------- | ------- | --------------------------------------------------------- |
| `token`         | —       | Teams incoming webhook URL (HTTP POST URL). **Required.** |
| `document_send` | `true`  | Send a PDF download card after the message.               |

***

## Output

### Message

A message card is posted in the configured channel in the **language of the quote** (EN, FR, DE, IT, PT, ES).

| Quote field                            | Used for                  |
| -------------------------------------- | ------------------------- |
| `owner.first_name` + `owner.last_name` | Sales rep full name       |
| `customer.name`                        | Company name              |
| `summary.one_off.net_amount`           | One-off net amount        |
| `summary.metrics.mrr`                  | Monthly recurring revenue |

**Example (FR):**

```text theme={null}
🎉 BREAKING NEWS :
Emmanuel Laureau vient de signer l'entreprise Hubspot — One-off : 100,00 €
```

<Note>
  Amounts equal to zero are not displayed. A quote with One-off = 0 and MRR = 150 will show only `MRR : 150,00 €`.
</Note>

<Note>
  If the quote has no owner, the message uses a generic format: `New signature — Company`.
</Note>

### PDF card

If **Send document link** is enabled, an Adaptive Card is posted with a button linking directly to the quote PDF.

```text theme={null}
┌─────────────────────────────────┐
│ 📄 20260404-Hubspot.pdf         │
│                                 │
│  [ Download PDF ]               │
└─────────────────────────────────┘
```

<Note>
  The PDF link points to `https://qwoty.app/api/projects/{id}/pdf`. The recipient must have access to Qwoty to download the file.
</Note>