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

> Send a notification message and/or a PDF download link to a Google Chat space when a quote is signed.

## Overview

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

***

## Authentication

Google Chat incoming webhooks are self-authenticating — the webhook URL contains the space ID and key. No additional token is required.

1. In Google Chat, open the target space → **Apps & integrations** → **Add webhooks**
2. Give the webhook a name (e.g. `Qwoty`) and click **Save**
3. Copy the generated **Webhook URL** and paste it into the **Token** field

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

<Note>
  Each Google Chat space requires its own webhook URL. If you want notifications in multiple spaces, create a separate integration for each.
</Note>

***

## Settings

| Key             | Default | Description                                     |
| --------------- | ------- | ----------------------------------------------- |
| `token`         | —       | Google Chat incoming webhook URL. **Required.** |
| `document_send` | `true`  | Send a PDF download card after the message.     |

***

## Output

### Message

A message is posted in the configured space 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, a card is posted with a button linking directly to the quote 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>