Configurer Azure pour les bots Microsoft Teams

MyZapp peut dialoguer dans Microsoft Teams avec deux bots distincts : Notifications et Assistant. Cette page explique comment les déclarer dans Azure. Aucun programme n'est installé sur Azure : le service Azure Bot relaie simplement les messages vers votre instance.

Refaites cette procédure pour chaque bot que vous voulez activer. Cette page est réservée aux administrateurs.

L'installation de l'application dans Teams et les messages envoyés par les bots arrivent avec les prochaines versions du connecteur.

Ce qu'il vous faut

• un compte Microsoft Entra autorisé à créer des inscriptions d'applications ;
• un abonnement Azure et un groupe de ressources ;
• une instance joignable depuis Internet en HTTPS, avec un certificat reconnu publiquement.

Adresse à déclarer pour chaque bot, en remplaçant <instance> par l'adresse de votre instance :

1. Inscrire l'application dans Entra

1. Dans le portail Azure, ouvrez Microsoft Entra ID › Inscriptions d'applications › Nouvelle inscription.
2. Donnez un nom. Vos utilisateurs ne le verront pas dans Teams.
3. Dans Types de comptes pris en charge, choisissez Comptes dans cet annuaire d'organisation uniquement.
4. Laissez l'URI de redirection vide, puis cliquez sur Inscrire.
5. Notez l'ID d'application (client) et l'ID de l'annuaire (locataire).

2. Créer le secret

1. Dans l'application, ouvrez Certificats et secrets › Secrets client › Nouveau secret client.
2. Choisissez une durée et notez la date d'expiration : à cette date, le bot cessera d'écrire.
3. Copiez tout de suite la colonne Valeur, et non « ID de secret » : elle n'est affichée qu'une fois.

3. Créer la ressource Azure Bot

1. Dans le portail Azure, cliquez sur Créer une ressource, cherchez Azure Bot, puis Créer.
2. Donnez un descripteur, choisissez l'abonnement et le groupe de ressources, et la résidence des données Globale.
3. Le niveau tarifaire gratuit F0 suffit.
4. Dans Type d'application, choisissez Locataire unique.
5. Dans Type de création, choisissez Utiliser une inscription d'application existante, puis collez les deux identifiants de l'étape 1.
6. Cliquez sur Vérifier + créer, puis Créer.

4. Déclarer l'adresse de l'instance

Dans la ressource Azure Bot, ouvrez Paramètres › Configuration, renseignez le Point de terminaison de messagerie avec l'adresse du bot, puis cliquez sur Appliquer.

5. Activer le canal Teams

Ouvrez Paramètres › Canaux › Microsoft Teams, acceptez les conditions, choisissez Microsoft Teams Commercial, puis Appliquer.

6. Régler MyZapp

1. Dans Secrets, créez un secret avec la valeur copiée à l'étape 2 et un nom de votre choix, par exemple teams-notifications-secret.
2. Dans Configuration, ajoutez les paramètres suivants, en remplaçant {Bot} par Notifications ou Assistant :

7. Vérifier

Envoyez une requête POST sans authentification à l'adresse du bot :

• 401 : le bot est activé et l'instance est joignable. C'est le résultat attendu.
• 404 : le bot est désactivé ou un paramètre manque.
• Toute autre réponse, ou pas de réponse : vérifiez le réseau, le proxy et le certificat.

Renouveler le secret

1. Dans Entra, créez un nouveau secret sans retirer l'ancien.
2. Dans Secrets, remplacez la valeur du secret. Son nom ne change pas.
3. Attendez environ une heure, puis supprimez l'ancien secret dans Entra.

Comment les comptes sont reconnus

Au premier échange, l'adresse Microsoft 365 de la personne est rapprochée de l'adresse d'un compte MyZapp actif. Si aucun compte ne correspond, ou si plusieurs correspondent, aucune liaison n'est créée. Un compte désactivé perd sa liaison la nuit suivante.