Passer au contenu principal

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 Microsoft Teams lorsqu’un devis est signé dans Qwoty. Optionnellement, elle envoie aussi 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 des Connecteurs a été remplacée.
  1. Dans Teams, faites un clic droit sur le canal cible → Workflows
  2. Recherchez “Envoyer des alertes webhook à un canal” 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
Pour retrouver l’URL ultérieurement : ouvrez l’application Workflows dans Teams → sélectionnez le workflow → Modifier → développez Quand une requête webhook Teams est reçue.
L’URL du webhook accorde un accès en écriture au canal. Traitez-la comme un secret et ne la partagez pas publiquement.
La disponibilité des webhooks dépend des paramètres de votre organisation. Si le modèle n’est pas visible, contactez votre administrateur IT.

Paramètres

CléPar défautDescription
tokenURL du webhook entrant Teams (URL HTTP POST). Requis.
document_sendtrueEnvoyer une carte de téléchargement PDF après le message.

Résultat

Message

Une carte message est publiée dans le canal configuré dans la langue du devis (EN, FR, DE, IT, PT, ES).
Champ du devisUtilisé pour
owner.first_name + owner.last_nameNom complet du commercial
customer.nameNom de l’entreprise
summary.one_off.net_amountMontant net one-off
summary.metrics.mrrRevenu mensuel récurrent
Exemple (FR) :
🎉 BREAKING NEWS :
Emmanuel Laureau vient de signer l'entreprise Hubspot — One-off : 100,00 €
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.

Carte PDF

Si Envoyer le lien du document est activé, une Adaptive Card est publiée avec un bouton liant directement au PDF du devis.
┌─────────────────────────────────┐
│ 📄 20260404-Hubspot.pdf         │
│                                 │
│  [ Télécharger le PDF ]         │
└─────────────────────────────────┘
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.