Envoyer un message dans un chat avec l'API Microsoft Teams
Envoie un message dans un chat existant au nom de l'utilisateur et le renvoie avec son id. Il n'est pas possible de démarrer un nouveau chat ici : le chat doit venir de List chats. N'envoyez que des messages que des personnes liront.
- Identifiant
- microsoft_teams_send_chat_message
L'appel
POST https://connect.reportei.com/api/tools/microsoft_teams_send_chat_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"chat_id": "<chat_id>",
"body": {}
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| chat_id | string | Oui | Chat id from List chats. |
| body | object | Oui | Content of the message. contentType is text, the default, or html for formatted content. |
| importance | string | Non | Importance of the message. The default is normal.Valeurs : normal, high, urgent |
Connexions possibles
Votre client connecte son compte Microsoft Teams une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
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.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/microsoft_teams_send_chat_message. Il devient la définition de tool de votre agent sans conversion.
Autres 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.
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.
