Aller au contenu

Connecteur Microsoft Teams

Le connecteur Teams relie un bot à Microsoft Teams, via l'API REST du Bot Framework.

Prérequis

  • Un tenant Microsoft 365 dans lequel des applications personnalisées peuvent être chargées dans Teams
  • Un abonnement Azure, pour enregistrer le bot dans Azure Bot Service
  • Une URL HTTPS publique pour le bot

Configuration

  1. Enregistrez un bot dans le Microsoft Bot Framework / Azure Bot Service, pour obtenir un App ID et un mot de passe.
  2. Dans Tock Studio, créez un connecteur Teams dans Settings > Configurations :

    Champ Description
    appId App ID du bot dans le Bot Framework / Azure Bot Service
    password Mot de passe (secret client) du bot
  3. Définissez l'URL du connecteur comme messaging endpoint du bot, par exemple https://<hôte-du-bot>/io/<namespace>/<bot>/teams.

  4. Ajoutez le bot à Teams (voir charger une application dans Teams).

Pour tester un bot qui tourne en local, exposez-le avec un tunnel sécurisé (par exemple ngrok).

Les délais maximaux des appels à Microsoft sont définis par tock_microsoft_request_timeout et tock_teams_request_timeout_ms (voir Configuration).

Cartes

En plus des textes, le connecteur prend en charge les cartes suivantes :

  • carte d'action (boutons) : teamsMessageWithButtonCard(...),
  • carte « hero » (image, texte et boutons) : teamsHeroCard(...),
  • carrousel de cartes : teamsCarousel(...).
Chat with Tock
×