Communication
Microsoft Teams dans votre produit et vos agents IA, via une API
Le toolkit Microsoft Teams couvre les équipes, les canaux (lister, créer), les messages de canal et leurs réponses (lire, publier, répondre) et les chats (lister chats, membres et messages, envoyer un message), au nom de l'utilisateur connecté. Le client connecte un compte professionnel ou scolaire par OAuth sur votre propre app, et Connect renouvelle les tokens et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/microsoft_teams_create_channel/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"team_id": "<team_id>",
"displayName": "<displayName>"
}
}Fonctionnement
Du client connecté au premier appel à Microsoft Teams.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Microsoft Teams. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Microsoft Teams.
Alerter un canal depuis votre produit
Listez les équipes et canaux de l'utilisateur, choisissez-en un et publiez un message avec Send channel message quand quelque chose demande l'attention de l'équipe.
Répondre dans un fil
Lisez les messages racine d'un canal et leurs réponses, puis répondez dans le même fil avec Reply to channel message, depuis un bot ou un agent IA.
Assistant de chat pour une personne
Listez les chats de l'utilisateur, lisez les messages récents avec List chat messages et envoyez un message dans un chat existant une fois le texte validé par l'utilisateur.
Tools
12 tools Microsoft Teams
- Lister les équipesGETListe les équipes dont l'utilisateur est membre direct, avec id, displayName, description et isArchived. Utilisez l'id comme team_id dans les autres outils.
- Lister les canauxGETListe les canaux d'une équipe que l'utilisateur peut voir, avec id, displayName, description, membershipType et webUrl. Les canaux privés et partagés n'apparaissent qu'à leurs membres. Utilisez l'id comme channel_id dans les outils de messages.
- Créer un canalPOSTCrée un canal standard, ouvert à tous les membres de l'équipe, et le renvoie avec son id. Les canaux privés et partagés exigent une liste de membres et ne sont pas pris en charge ici.
- Lister les messages d'un canalGETListe les messages racine d'un canal, sans leurs réponses, 20 par page et triés par l'activité la plus récente de chaque fil. Seule la première page est renvoyée : le @odata.nextLink de la réponse ne peut pas être suivi ici. Lisez un fil avec List channel message replies.
- Lire un message de canalGETRenvoie un message racine d'un canal, avec son corps, l'expéditeur dans from, createdDateTime et webUrl. Ses réponses ne sont pas incluses.
- Lister les réponses à un message de canalGETListe les réponses à un message racine d'un canal. Le message racine n'est pas inclus : lisez-le avec Get channel message. Seule la première page est renvoyée.
- Envoyer un message dans un canalPOSTPublie un nouveau message dans un canal au nom de l'utilisateur et le renvoie avec son id. Les conditions de Microsoft interdisent d'utiliser Teams comme journal : n'envoyez que des messages que des personnes liront.
- Répondre à un message de canalPOSTPublie une réponse dans le fil d'un message racine d'un canal, au nom de l'utilisateur, et la renvoie avec son id. N'envoyez que des messages que des personnes liront.
- Lister les chatsGETListe les chats individuels, de groupe et de réunion de l'utilisateur, avec id, topic, chatType et webUrl. Les chats individuels n'ont pas de topic : utilisez List chat members pour voir qui s'y trouve. Seule la première page est renvoyée.
- Lister les membres d'un chatGETListe les personnes d'un chat, avec displayName, email et userId.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/microsoft_teams, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit Microsoft Teams
Dois-je intégrer l'API Microsoft Teams moi-même ?
Non. Connect fournit 12 tools Microsoft Teams décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Microsoft Teams ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
