チャットでメッセージを送信する

名前空間: microsoft.graph

指定したチャット で新しい chatMessage送信します。 この API では、新しいチャットを作成できません。チャット メッセージを作成する 前に 、リスト チャット メソッドを使用して既存のチャットの ID を取得する必要があります。

: この API をデータ移行に使用することをお勧めしません。 一般的な移行に必要なスループットはありません。

: ログ ファイルとして使用 する使用条件Microsoft Teams違反です。 ユーザーが読むメッセージのみを送信します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校アカウント) ChatMessage.Send, Chat.ReadWrite
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション サポートされていません。

HTTP 要求

POST /chats/{chat-id}/messages

要求ヘッダー

名前 説明
Authorization ベアラー {code}。 必須です。

要求本文

要求本文で、chatMessage オブジェクトの JSON 表記 を指定 します。

応答

成功した場合、このメソッドは応答コードと、応答本文の新しい 201 Created chatMessage オブジェクトを返します。

例のより包括的な一覧については 、「Create chatMessage in a channel or chat」を参照してください

要求

要求の例を次に示します。

POST https://graph.microsoft.com/v1.0/chats/19:2da4c29f6d7041eca70b638b43d45437@thread.v2/messages
Content-type: application/json

{
  "body": {
     "content": "Hello world"
  }
}

応答

応答の例を次に示します。

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A2da4c29f6d7041eca70b638b43d45437%40thread.v2')/messages/$entity",
    "id": "1616991463150",
    "replyToId": null,
    "etag": "1616991463150",
    "messageType": "message",
    "createdDateTime": "2021-03-29T04:17:43.15Z",
    "lastModifiedDateTime": "2021-03-29T04:17:43.15Z",
    "lastEditedDateTime": null,
    "deletedDateTime": null,
    "subject": null,
    "summary": null,
    "chatId": "19:2da4c29f6d7041eca70b638b43d45437@thread.v2",
    "importance": "normal",
    "locale": "en-us",
    "webUrl": null,
    "channelIdentity": null,
    "policyViolation": null,
    "from": {
        "application": null,
        "device": null,
        "conversation": null,
        "user": {
            "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2",
            "displayName": "Robin Kline",
            "userIdentityType": "aadUser"
        }
    },
    "body": {
        "contentType": "text",
        "content": "Hello World"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
}