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.
Vue d’ensemble
Cette intégration publie un message sur un canal Slack lorsqu’un devis est signé dans Qwoty. Optionnellement, elle télécharge aussi le PDF du devis sur le même canal.Authentification
Vous avez besoin d’un Slack Bot Token (xoxb-...) pour authentifier les requêtes.
- Allez sur api.slack.com/apps → Create New App → From scratch
- Sous OAuth & Permissions, ajoutez les Bot Token Scopes suivants :
chat:write— pour publier des messagesfiles:write— pour télécharger des PDFs
- Cliquez sur Install to Workspace, puis copiez le Bot User OAuth Token
- Invitez le bot sur votre canal cible :
/invite @VotreNomApp
Utilisez l’ID du canal plutôt que le nom du canal (par ex.
C0123ABC456). Trouvez-le en cliquant sur le nom du canal → onglet À propos → bas du panneau.Paramètres
| Clé | Par défaut | Description |
|---|---|---|
token | — | Slack Bot Token (xoxb-...). Requis. |
message_channel | — | ID ou nom du canal cible. Requis. |
document_send | true | Télécharger le PDF du devis sur le canal. |
Résultat
Message
Un message est publié 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 mensuel récurrent |
Les montants égaux à zéro ne sont pas affichés. Un devis avec One-off = 0 et MRR = 150 n’affichera que
MRR : 150,00 €.Si le devis n’a pas de propriétaire, le message utilise un format générique :
Nouvelle signature — Entreprise.Téléchargement du PDF
Si Envoyer le document est activé, le PDF du devis est téléchargé sur le même canal. Le fichier est nommé :YYYYMMDD-NomEntreprise.pdf
Si le devis n’a pas de PDF, le téléchargement est ignoré même si Envoyer le document est activé.