创建对话线程

首先,通过创建线程来启动新的组对话。

创建新会话、会话线程,然后可在组中创建帖子。使用 回复线程回复帖子 进一步发布到该线程。

注意:你还可以 在现有会话中启动新线程

先决条件

要执行此 API,需要以下范围之一:Group.ReadWrite.All

HTTP 请求

POST /groups/{id}/threads

请求标头

标头
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

在请求正文中,提供代表包括 帖子conversationThread 的 JSON 表示形式。

响应

如果成功,此方法在响应正文中返回 201, Created 响应代码和 conversationThread 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/v1.0/groups/{id}/threads
Content-type: application/json

{
  "topic": "New Conversation Thread Topic",
  "posts": [{
    "body": {
      "contentType": "html",
      "content": "this is body content"
    },
    "newParticipants": [{
      "emailAddress": {
        "name": "Alex Darrow",
        "address": "alexd@contoso.com"
      }
    }]
  }]
}
响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 201 OK
Content-type: application/json
Content-length: 419

{
  "toRecipients": [
    {
      "emailAddress": {
        "name": "name-value",
        "address": "address-value"
      }
    }
  ],
  "topic": "topic-value",
  "hasAttachments": true,
  "lastDeliveredDateTime": "datetime-value",
  "uniqueSenders": [
    "uniqueSenders-value"
  ],
  "ccRecipients": [
    {
      "emailAddress": {
        "name": "name-value",
        "address": "address-value"
      }
    }
  ]
}