Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Créez une réponse à un chatMessage dans un canal spécifié.
Remarques :
- Nous vous déconseillons d’utiliser cette API pour la migration des données via le flux de création de message standard. Pour les scénarios de migration de données, utilisez plutôt le flux de messages d’importation .
- L’utilisation de Microsoft Teams en tant que fichier journal constitue une violation des conditions d’utilisation . Envoyez uniquement les messages que les utilisateurs liront.
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
| Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
|---|---|---|
| Déléguée (compte professionnel ou scolaire) | ChannelMessage.Send | Group.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
| Application | Teamwork.Migrate.All | Non disponible. |
Remarque : les autorisations d’application sont uniquement prises en charge pour la migration. À l’avenir, Microsoft pourra exiger que vous ou vos clients payiez des frais supplémentaires en fonction du volume de données importées.
Requête HTTP
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies
En-têtes de demande
| Nom | Type | Description |
|---|---|---|
| Autorisation | string | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON d’un objet de message . Seule la propriété body est obligatoire, les autres propriétés sont facultatives.
Réponse
Si elle réussit, cette méthode retourne 201 Created le code de réponse avec le message qui a été créé.
Exemples
Exemple 1 : Créer une réponse à un chatMessage
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/v1.0/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/messages/1590776551682/replies
Content-type: application/json
{
"body": {
"contentType": "html",
"content": "Hello World"
}
}
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('57fb72d0-d811-46f4-8947-305e6072eaa5')/channels('19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2')/messages('1590776551682')/replies/$entity",
"id": "1591039710682",
"replyToId": "1590776551682",
"etag": "1591039710682",
"messageType": "message",
"createdDateTime": "2019-02-04T19:58:15.511Z",
"lastModifiedDateTime": "2019-05-04T19:58:15.511Z",
"lastEditedDateTime": null,
"deleted": false,
"subject": null,
"summary": null,
"importance": "normal",
"locale": "en-us",
"policyViolation": null,
"from": {
"application": null,
"device": null,
"conversation": null,
"user": {
"id": "8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca",
"displayName": "Joh Doe",
"userIdentityType": "aadUser"
}
},
"body": {
"contentType": "html",
"content": "Hello World"
},
"attachments": [],
"mentions": [],
"reactions": []
}
Exemple 2 : Importer des messages
L’exemple suivant montre comment importer une réponse de message. Pour plus d’informations, consultez Importer des messages dans des conversations et des canaux Microsoft Teams à l’aide de Microsoft Graph.
Remarque : L’étendue
Teamwork.Migrate.Alld’autorisation est requise pour ce scénario.
Importante
La valeur createdDateTime doit être unique jusqu’à la milliseconde dans le canal cible. Si un message avec le même createdDateTime existe, la requête échoue avec 409 Conflict. Ajustez createdDateTime et réessayez. Pour plus d’informations, consultez Importer des messages dans des conversations et des canaux Microsoft Teams à l’aide de Microsoft Graph.
Demande
L’exemple suivant montre comment importer des messages de retour dans le temps à l’aide des createDateTime clés et from dans le corps de la requête.
POST https://graph.microsoft.com/v1.0/teams/57fb72d0-d811-46f4-8947-305e6072eaa5/channels/19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2/messages/1590776551682/replies
{
"createdDateTime":"2019-02-04T19:58:15.511Z",
"from":{
"user":{
"id":"8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca",
"displayName":"Joh Doe"
}
},
"body":{
"contentType":"html",
"content":"Hello World"
}
}
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 200 OK
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#teams('57fb72d0-d811-46f4-8947-305e6072eaa5')/channels('19:4b6bed8d24574f6a9e436813cb2617d8@thread.tacv2')/messages('1590776551682')/replies/$entity",
"id":"1591039710682",
"replyToId":"1590776551682",
"etag":"1591039710682",
"messageType":"message",
"createdDateTime":"2019-02-04T19:58:15.511Z",
"lastModifiedDateTime":null,
"deleted":false,
"subject":null,
"summary":null,
"importance":"normal",
"locale":"en-us",
"policyViolation":null,
"from":{
"application":null,
"device":null,
"conversation":null,
"user":{
"id":"8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca",
"displayName":"Joh Doe",
"userIdentityType":"aadUser"
}
},
"body":{
"contentType":"html",
"content":"Hello World"
},
"attachments":[ ],
"mentions":[ ],
"reactions":[ ]
}