> ## 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

> Envoyez un message de notification et/ou une carte de téléchargement PDF vers un canal Microsoft Teams lorsqu'un devis est signé.

## Vue d'ensemble

Cette intégration publie un message dans un canal Microsoft Teams lorsqu'un devis est signé dans Qwoty. En option, elle envoie également une carte avec un lien de téléchargement direct vers le PDF du devis.

***

## Authentification

Les webhooks entrants Teams sont désormais créés via l'application **Workflows** — la méthode legacy via les Connecteurs a été remplacée.

1. Dans Teams, faites un clic droit sur le canal cible → **Workflows**
2. Recherchez **"Send webhook alerts to a channel"** et sélectionnez-le
3. Renommez le workflow si nécessaire, authentifiez-vous avec votre compte, puis cliquez sur **Suivant**
4. Sélectionnez l'**Équipe** et le **Canal** où les notifications doivent être publiées, puis cliquez sur **Ajouter le workflow**
5. Copiez l'**URL HTTP POST** générée et collez-la dans le champ **Token** dans Qwoty

<Note>
  Pour récupérer l'URL ultérieurement : ouvrez l'application **Workflows** dans Teams → sélectionnez le workflow → **Modifier** → développez **When a Teams webhook request is received**.
</Note>

<Warning>
  L'URL du webhook accorde un accès en écriture au canal. Traitez-la comme un secret et ne la partagez pas publiquement.
</Warning>

<Warning>
  La disponibilité du webhook dépend des paramètres de votre organisation. Si le modèle n'est pas visible, contactez votre administrateur informatique.
</Warning>

***

## Paramètres

| Clé             | Défaut | Description                                                    |
| --------------- | ------ | -------------------------------------------------------------- |
| `token`         | —      | URL du webhook entrant Teams (URL HTTP POST). **Obligatoire.** |
| `document_send` | `true` | Envoyer une carte de téléchargement PDF après le message.      |

***

## Sortie

### Message

Une carte de message est publiée dans le canal configuré dans la **langue du devis** (EN, FR, DE, IT, PT, ES).

| Champ du devis                         | Utilisé pour              |
| -------------------------------------- | ------------------------- |
| `owner.first_name` + `owner.last_name` | Nom complet du commercial |
| `customer.name`                        | Nom de l'entreprise       |
| `summary.one_off.net_amount`           | Montant net one-off       |
| `summary.metrics.mrr`                  | Revenu récurrent mensuel  |

**Exemple (FR) :**

```
🎉 BREAKING NEWS :
Emmanuel Laureau vient de signer l'entreprise Hubspot — One-off : 100,00 €
```

<Note>
  Les montants égaux à zéro ne sont pas affichés. Un devis avec One-off = 0 et MRR = 150 affichera uniquement `MRR : 150,00 €`.
</Note>

<Note>
  Si le devis n'a pas de propriétaire, le message utilise un format générique : `Nouvelle signature — Entreprise`.
</Note>

### Carte PDF

Si **Envoyer le lien du document** est activé, une Adaptive Card est publiée avec un bouton renvoyant directement vers le PDF du devis.

```
┌─────────────────────────────────┐
│ 📄 20260404-Hubspot.pdf         │
│                                 │
│  [ Télécharger le PDF ]         │
└─────────────────────────────────┘
```

<Note>
  Le lien PDF pointe vers `https://qwoty.app/api/projects/{id}/pdf`. Le destinataire doit avoir accès à Qwoty pour télécharger le fichier.
</Note>