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

# Slack

> Envoyer un message de notification et/ou le PDF du devis sur un canal Slack lorsqu'un devis est signé.

## Vue d'ensemble

Cette intégration publie un message sur un canal Slack lorsqu'un devis est signé dans Qwoty. Elle permet également, en option, de téléverser le PDF du devis sur le même canal.

***

## Authentification

Vous avez besoin d'un **Slack Bot Token** (`xoxb-...`) pour authentifier les requêtes.

1. Rendez-vous sur [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From scratch**
2. Sous **OAuth & Permissions**, ajoutez les portées suivantes au Bot Token :
   * `chat:write` — pour publier des messages
   * `files:write` — pour téléverser des PDF
3. Cliquez sur **Install to Workspace**, puis copiez le **Bot User OAuth Token**
4. Invitez le bot sur votre canal cible : `/invite @YourAppName`

<Warning>
  Le bot doit être invité sur le canal avant de pouvoir y publier des messages ou téléverser des fichiers. Dans le cas contraire, les appels API retourneront `not_in_channel`.
</Warning>

<Note>
  Utilisez l'**ID du canal** plutôt que son nom (ex. `C0123ABC456`). Pour le trouver, cliquez sur le nom du canal → onglet **À propos** → bas du panneau.
</Note>

***

## Paramètres

| Clé               | Défaut | Description                               |
| ----------------- | ------ | ----------------------------------------- |
| `token`           | —      | Slack Bot Token (`xoxb-...`). **Requis.** |
| `message_channel` | —      | ID ou nom du canal cible. **Requis.**     |
| `document_send`   | `true` | Téléverser le PDF du devis sur le canal.  |

***

## Résultat

### Message

Un message est publié sur 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 mensuel récurrent  |

**Exemple (FR) :**

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

**Exemple (EN) :**

```
🎉 BREAKING NEWS :
Emmanuel Laureau just signed 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>

### Téléversement du PDF

Si **Envoyer le document** est activé, le PDF du devis est téléversé sur le même canal.

Le fichier est nommé : `YYYYMMDD-NomEntreprise.pdf`

<Note>
  Si le devis ne possède pas de PDF, le téléversement est ignoré même si l'option Envoyer le document est activée.
</Note>