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

# Google Chat

> Envoyer un message de notification et/ou un lien de téléchargement PDF vers un espace Google Chat lorsqu'un devis est signé.

## Vue d'ensemble

Cette intégration publie un message dans un espace Google Chat lorsqu'un devis est signé dans Qwoty. Optionnellement, elle envoie également une carte avec un lien de téléchargement direct vers le PDF du devis.

***

## Authentification

Les webhooks entrants Google Chat sont auto-authentifiés — l'URL du webhook contient l'identifiant de l'espace et la clé. Aucun token supplémentaire n'est requis.

1. Dans Google Chat, ouvrez l'espace cible → **Apps & integrations** → **Add webhooks**
2. Donnez un nom au webhook (ex. `Qwoty`) et cliquez sur **Save**
3. Copiez l'**URL du webhook** générée et collez-la dans le champ **Token**

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

<Note>
  Chaque espace Google Chat nécessite sa propre URL de webhook. Si vous souhaitez recevoir des notifications dans plusieurs espaces, créez une intégration distincte pour chacun.
</Note>

***

## Paramètres

| Clé             | Défaut | Description                                               |
| --------------- | ------ | --------------------------------------------------------- |
| `token`         | —      | URL du webhook entrant Google Chat. **Requis.**           |
| `document_send` | `true` | Envoyer une carte de téléchargement PDF après le message. |

***

## Sortie

### Message

Un message est publié dans l'espace 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 mensuel récurrent  |

**Exemple (FR) :**

```text theme={null}
🎉 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 carte est publiée avec un bouton pointant directement vers le PDF du devis.

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