🎯 Overview
Cette page décrit comment intégrer Microsoft Teams avec kapptivate afin de recevoir des événements de la plateforme directement dans un channel Teams.
L’intégration repose sur l’utilisation d’un webhook HTTP fourni par Microsoft Teams, à configurer côté Teams puis à renseigner dans kapptivate.
Deux méthodes sont possibles :
- Workflows (méthode recommandée par Microsoft)
- Incoming Webhook (ancien connecteur, si encore disponible)
💬 Microsoft Teams — Intégration via Workflows (recommandée)
Microsoft recommande désormais l’utilisation des Workflows pour exposer un webhook entrant dans Microsoft Teams.
Ce workflow génère une URL HTTP qui doit ensuite être utilisée dans la configuration d’intégration côté kapptivate. Il faut, si vous ne l'avez pas encore installée, télécharger l'application Workflows sur Teams.
Option A — Création via un template (le plus simple)
1) Dans Microsoft Teams, ouvrez le channel cible puis cliquez sur More options → Workflows.
2) Sélectionnez un template du type “Send webhook alerts to a channel”.
3) Suivez l’assistant (nom du workflow, compte, channel) puis validez avec Add workflow.
4) Copiez l’URL du webhook générée par Teams.
Option B — Création manuelle du workflow
1) Ouvrez l’application Workflows dans Microsoft Teams.
2) Créez un workflow from blank avec le trigger When a Teams webhook request is received.
3) Ajoutez l’action Post card in chat or channel et sélectionnez le channel cible.
4) Sauvegardez le workflow et copiez l’URL HTTP POST générée.
💡 Documentation Microsoft (référence officielle) : Create incoming webhooks with Workflows for Microsoft Teams
💬 Microsoft Teams — Incoming Webhook (ancien connecteur)
Cette méthode repose sur l’ancien connecteur “Incoming Webhook” de Microsoft Teams.
Elle permet de générer une URL HTTP à utiliser dans kapptivate pour envoyer des événements vers un channel Teams. Il faut, si vous ne l'avez pas encore installée, télécharger l'application Incoming Webhook sur Teams.
⚠️ Microsoft tend à remplacer progressivement ce mécanisme par Workflows. Si cette option n’est plus disponible, utilisez la méthode recommandée via Workflows.
Étape 1 — Accéder aux options du channel
Dans Microsoft Teams, ouvrez le channel cible, puis cliquez sur More options (menu “…”).
Étape 2 — Ouvrir la gestion des applications
Accédez à l’onglet Apps ou Connectors (selon la version de Teams).
Étape 3 — Ajouter le connecteur “Incoming Webhook”
Recherchez Incoming Webhook, puis ajoutez-le au channel.
Étape 4 — Configurer le webhook
Renseignez un nom pour le webhook (ex : kapptivate alerts), puis validez la création.
Étape 5 — Copier l’URL du webhook
Une URL HTTP est générée par Microsoft Teams. Copiez cette URL : elle devra être renseignée dans la configuration d’intégration Microsoft Teams côté kapptivate.
Une fois l’URL configurée dans kapptivate, les événements envoyés par la plateforme apparaîtront directement dans le channel Teams sélectionné.