Teams Bots

Où

Barre latérale du dashboard → Settings → Connectors → Teams Bots.

Ce que ça fait

Un bot Teams est un bot Azure qui vous appartient et qui représente un employé. Votre équipe lui écrit dans Teams, et l'employé y répond.

Un bot par employé. Ajoutez un second bot pour un second employé. C'est le connecteur le plus long à configurer : il met en jeu deux ressources Azure et une application installée dans Teams. Prévoyez une bonne demi-heure au calme pour le premier.

Ce n'est pas Teams Impersonation. Un bot parle en son nom propre ; l'impersonation envoie au nom d'un véritable utilisateur Teams connecté.

La ligne indique combien de bots sont connectés (0 connected tant que vous n'en ajoutez pas).

Ce dont vous aurez besoin

Le produit le résume sous forme de Quick Reference, et cela mérite d'être lu avant de commencer :

Les champs du formulaire sont Bot Name, Tenant ID, Microsoft App ID et Microsoft App Password, tous les quatre obligatoires, puis Add Bot.

Il vous faut aussi un abonnement Azure, l'étape 3 créant une ressource sur le palier tarifaire Free, et, pour l'étape 9, un administrateur Teams.

Créer le bot, étape par étape

1. Créer une App Registration Azure AD

1. Rendez-vous sur le portail Azure → App Registrations.
2. Cliquez sur New registration.
3. Saisissez un nom, par exemple Brooke - Customer Support Bot.
4. Sous Supported account types, sélectionnez Accounts in this organizational directory only (Single tenant).
5. Laissez la Redirect URI vide.
6. Cliquez sur Register.
7. Copiez l'Application (client) ID et le Directory (tenant) ID.

2. Créer un client secret

1. Dans l'app registration, allez dans Certificates & secrets.
2. Cliquez sur New client secret.
3. Ajoutez une description, par exemple Bot Secret.
4. Réglez l'expiration sur 24 mois (recommandé).
5. Cliquez sur Add.

3. Créer la ressource Azure Bot

1. Dans le portail Azure, choisissez Create Azure Bot.
2. Renseignez le Bot handle, un identifiant unique.
3. Sélectionnez votre Subscription et votre Resource group.
4. Pour le Pricing tier, sélectionnez Free.
5. Sous Microsoft App ID, sélectionnez Use existing app registration.
6. Saisissez l'App ID de l'étape 1.
7. Sélectionnez Single Tenant comme type d'application.
8. Cliquez sur Review + create, puis sur Create.

4. Configurer le point d'entrée de messagerie

1. Dans la nouvelle ressource Bot, allez dans Settings → Configuration.
2. Renseignez le Messaging endpoint avec :

https://VOTRE-INSTANCE/api/teams-bot-events

3. Cliquez sur Apply.

5. Activer le canal Microsoft Teams

1. Dans votre bot Azure, allez dans Channels.
2. Cliquez sur l'icône Microsoft Teams.
3. Acceptez les conditions d'utilisation.
4. Sous Messaging, sélectionnez les types de messages appropriés.
5. Cliquez sur Apply.

6. Ajouter des permissions d'API (facultatif)

Nécessaire uniquement pour la messagerie proactive, quand l'employé doit pouvoir écrire le premier plutôt que seulement répondre.

1. De retour dans Azure AD → App registrations, sélectionnez votre application.
2. Allez dans API permissions → Add a permission → Microsoft Graph.
3. Ajoutez ces Application permissions :

User.Read.All
TeamsActivity.Send

4. Cliquez sur Grant admin consent.

7. Ajouter le bot dans Geta.Team

1. Dans Settings → Connectors → Teams Bots, cliquez sur + Add Bot.
2. Saisissez le Bot Name, en général le nom de l'employé.
3. Collez le Tenant ID (Directory ID, étape 1).
4. Collez le Microsoft App ID (Application ID, étape 1).
5. Collez le Microsoft App Password (la Value du client secret, étape 2).
6. Cliquez sur Add Bot.
7. Attribuez le bot à un employé.

8. Installer le bot dans Microsoft Teams

1. Cliquez sur le bouton de téléchargement à côté de votre bot dans la liste : vous obtenez le manifeste .zip.
2. Dans Teams, allez dans Applications → Gérer vos applications.
3. Cliquez sur Charger une application → Charger une application personnalisée.
4. Sélectionnez le .zip téléchargé.
5. Cliquez sur Ajouter.
6. Démarrez une conversation avec le bot : elle est désormais prise en charge par votre employé IA.

9. Déployer à toute l'organisation (administrateurs)

Pour rendre le bot disponible à tous sans que chacun l'installe :

1. Allez dans le Centre d'administration Teams → Gérer les applications.
2. Cliquez sur Charger une nouvelle application et sélectionnez le même manifeste .zip.
3. Allez dans Applications Teams → Stratégies de configuration.
4. Modifiez la stratégie Global (valeur par défaut à l'échelle de l'organisation).
5. Sous Applications installées, cliquez sur Ajouter des applications, trouvez votre bot, ajoutez-le.
6. Cliquez sur Enregistrer.

Les changements de stratégie peuvent mettre jusqu'à 24 heures à atteindre tous les utilisateurs.

Dépannage

« Invalid Microsoft App ID or App Password »

• Utilisez le Directory (tenant) ID, pas l'Object ID.
• La Value du client secret n'est pas le Secret ID : utilisez la Value.
• Vérifiez que le secret n'a pas expiré.
• Confirmez que vous avez bien sélectionné Single tenant à la création de l'app registration.

« Charger une application personnalisée » n'est pas disponible dans Teams

Allez dans le Centre d'administration Teams → Applications Teams → Stratégies d'autorisation et activez le chargement d'applications personnalisées pour votre organisation.

« manifestVersion property is missing »

N'utilisez pas le manifeste du portail Azure, il est incomplet. Téléchargez le manifeste avec le bouton situé à côté de votre bot dans Geta.Team.

Le bot ne répond pas aux messages

• Vérifiez le point d'entrée de messagerie dans Azure Bot → Settings → Configuration.
• Vérifiez que le canal Microsoft Teams est activé et en bonne santé, coche verte.
• Vérifiez qu'un employé est bien attribué au bot.

Ce qui coince

Le client secret a une date d'expiration, 24 mois au maximum si vous suivez l'étape 2. À son échéance, le bot cesse de répondre sans aucun avertissement côté plateforme. Notez la date le jour où vous le créez : c'est ce qui tue les bots Teams longtemps après une installation réussie.