---
title: "Intégration Microsoft Teams"
sidebarTitle: "Microsoft Teams"
description: Connectez Microsoft Teams à Kapptivate pour recevoir les alertes d'incident et les digests de monitoring dans un canal que votre équipe lit déjà.
lastUpdated: "2026-09-23"
---
> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.
Connecter Microsoft Teams permet à Kapptivate de publier les alertes d'incident et les digests de monitoring directement dans un canal Teams, plutôt que dans une boîte mail que personne n'ouvre. La connexion se fait une seule fois, depuis **Administration → Integrations**, et elle s'appuie sur une application que vous déclarez dans Microsoft Entra ID (anciennement Azure Active Directory).
Il vous faut deux choses : le droit de déclarer une application dans votre tenant Microsoft, et un accès administrateur à votre workspace Kapptivate.
Deux réglages décident si la connexion fonctionne, tout simplement : le type de compte doit être **multi-locataire**, et l'URI de redirection doit correspondre au caractère près à l'URL de callback de Kapptivate. Les deux se règlent à la déclaration (étape 1 ci-dessous). Si l'un des deux est faux, Microsoft interrompt le parcours avant même d'afficher l'écran de consentement.
## Déclarez l'application
Rendez-vous sur [portal.azure.com](https://portal.azure.com), ouvrez **Microsoft Entra ID → Inscriptions d'applications**, et cliquez sur **Nouvelle inscription**.
Donnez-lui le nom que vous voulez, du moment qu'il parlera à la personne qui tombera dessus plus tard, par exemple `Kapptivate Integration Center`.
Sous **Types de comptes pris en charge**, sélectionnez **Comptes dans un annuaire organisationnel quelconque (tout annuaire Microsoft Entra ID, multi-locataire)**.
Ce n'est pas une préférence, c'est une obligation. Kapptivate passe par l'endpoint partagé `/common` de Microsoft, que Microsoft refuse de servir à une application mono-locataire déclarée après octobre 2018. La connexion échoue avec le code **AADSTS50194** avant même l'écran de consentement, et rien n'est journalisé côté Kapptivate.
Toujours sur le formulaire d'inscription, sous **URI de redirection**, choisissez la plateforme **Web** et collez l'URL ci-dessous, avec votre propre domaine Kapptivate à la place de ``. Puis cliquez sur **Inscrire**.
```text URI de redirection
https:///api/integrations/oauth/callback/teams
```
Exemple : `https://app.kapptivate.com/api/integrations/oauth/callback/teams`
Recopiez-la exactement. Un slash en trop, un `http` au lieu de `https` ou le mauvais domaine suffisent à ce que Microsoft refuse la redirection avec le code **AADSTS50011**.
Ouvrez **Autorisations d'API → Ajouter une autorisation → Microsoft Graph**, choisissez **Autorisations déléguées**, et ajoutez ces quatre permissions :
| Permission | Ce qu'elle autorise |
|---|---|
| `ChannelMessage.Send` | Publier le message d'alerte dans le canal |
| `Channel.ReadBasic.All` | Lister les canaux dans le sélecteur de canal |
| `Team.ReadBasic.All` | Lister les équipes dans le sélecteur d'équipe |
| `offline_access` | Maintenir la connexion au-delà du premier jeton |
`offline_access` n'est pas optionnelle. Sans elle, Microsoft n'émet pas de refresh token, et l'intégration bascule en **Reconnection required** dès l'expiration du premier jeton.
Deux valeurs sont à récupérer sur l'inscription.
| Valeur | Où la trouver |
|---|---|
| **Client ID** | La page **Vue d'ensemble**, champ **ID d'application (client)** |
| **Client secret** | **Certificats et secrets → Secrets client → Nouveau secret client**, puis la colonne **Valeur** |
Copiez le secret tout de suite. La colonne **Valeur** n'est lisible que tant que vous êtes sur cette page : si vous la quittez, il faut créer un nouveau secret. Et prenez bien la **Valeur**, pas l'**ID de secret** affiché à côté, qui n'est pas l'identifiant attendu.
## Connectez depuis Kapptivate
Allez dans **Administration → Integrations** et ouvrez la carte **Microsoft Teams**. Collez le **Client ID** et le **Client secret**, puis cliquez sur **Connect**.
Une fenêtre s'ouvre et vous demande de consentir aux permissions pour votre organisation. Une fois que vous validez, vous revenez dans Kapptivate et la carte Microsoft Teams affiche **Connected**.
Les deux valeurs sont stockées chiffrées, et ne se retrouvent jamais dans un fichier de configuration.
## Choisissez l'équipe et le canal par défaut
Une intégration connectée doit encore savoir où publier. Dans le panneau **Integration details**, sous **Default settings**, choisissez une **Default team** et un **Default channel**, puis cliquez sur **Save**. Une alerte qui ne précise pas de canal atterrit ici.
Les sélecteurs listent ce que l'intégration peut voir avec les permissions accordées, pour le compte qui a donné son consentement. Si une équipe manque dans la liste, vérifiez que ce compte en est bien membre dans Teams.
## Si la connexion échoue
La fenêtre d'autorisation se referme sur une erreur générique et ne journalise rien, parce que l'échec se produit côté Microsoft, avant le retour vers Kapptivate. Pour lire la vraie raison, ouvrez l'URL d'autorisation dans un onglet normal : Microsoft affiche alors sa propre page d'erreur, avec un code.
| Code | Ce qu'il signifie | Correction |
|---|---|---|
| `AADSTS50194` | L'application est déclarée en mono-locataire | Passez **Types de comptes pris en charge** en multi-locataire, dans **Authentification** |
| `AADSTS50011` | L'URI de redirection ne correspond pas à celle que Kapptivate appelle | Comparez l'URI au caractère près avec celle de l'étape 3 |
## Déconnectez
Dans le panneau **Integration details**, cliquez sur **Disconnect**. Kapptivate arrête de publier dans Teams, et la carte repasse en **Not connected**. L'inscription d'application, elle, reste dans votre tenant : une reconnexion plus tard ne demande que de recoller les identifiants.
## Autres intégrations
Envoyez les mêmes alertes dans un canal Slack
Transformez un incident en ticket dans votre projet