创建线程

在指定会话中创建新线程。

按指定方式创建线程和帖子。使用 回复线程 进一步发布到该线程。或者,如果你获得帖子 ID,还可以在该线程中 回复 帖子。

注意:还可以 通过首先创建一个线程启动一个新的对话

先决条件

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

HTTP 请求

POST /groups/{id}/conversations/{id}/threads

请求标头

名称 类型 说明
Authorization string Bearer {token}。必需。

请求正文

在请求正文中,提供 ConversationThread 对象的 JSON 表示形式。

响应

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

示例

请求

下面是一个请求示例。

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

{
  "topic": "topic-value",
  "posts": [{
      "body": {
        "contentType": "html",
        "content": "this is body content"
      }
  }]
}

在请求正文中,提供 ConversationThread 对象的 JSON 表示形式。

响应

如果成功,此方法在响应正文中返回 201, Created 响应代码和新线程的 id。下面是一个响应示例。

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

{
  "id": "thread-id-value"
}