跳转到主要内容
Direct Messages 让你在 X 上进行私密对话。Direct Messages 是 X 上最受欢迎的功能之一，拥有广泛的使用场景，既可用于朋友间的群聊，也可用于为全球品牌提供客服支持。v2 版 Direct Messages 端点将分阶段推出，首批包括用于创建 Direct Messages 和列出 Direct Message 会话事件的基础端点。X API v2 首次支持群组会话。 Manage Direct Messages 的初始发布包含三个用于创建 Direct Messages 的 POST 方法：
  • POST /2/dm_conversations/with/:participant_id/messages - 创建一对一 Direct Message。此方法要么创建一个新的 1-1 会话，要么检索当前会话并向其中添加该 Direct Message。:participant_id 路径参数为接收消息账户的用户 ID。
  • POST /2/dm_conversations - 创建一个新的群组会话并向其中添加一条 Direct Message。此请求需要提供会话参与者列表。请注意，你可以使用相同的参与者列表创建多个会话；这类请求将始终返回一个新的会话 ID。
  • POST /2/dm_conversations/:dm_conversation_id/messages - 创建一条 Direct Message 并将其添加到现有会话中。:dm_conversation_id 路径参数为要添加消息的会话 ID。
请注意，Direct Message 事件 ID 在 v1.1 与 v2（以及 X App）之间通用，因此可将 v1.1 的隐藏/删除 Direct Messages 方法与这一新的 v2 端点配合使用。另请注意，Enterprise 和 Premium Account Activity API 支持 v2 的一对一消息，但尚不支持群组会话。 POST 方法的用户速率限制为每 15 分钟 200 次请求；另有每用户每 24 小时 1000 次请求的限制；此外，每 24 小时还有限制为 15000 次的请求额度。请注意，这些速率限制在这些 POST 端点之间共享。 由于你是代表用户通过 manage Posts 端点发出请求，你必须使用 OAuth 1.0a User Context 或 OAuth 2.0 Authorization Code with PKCE 进行认证，并使用与已授权你的应用的用户关联的用户 Access Token。要使用 OAuth 1.0a 生成该用户 Access Token，你可以使用 3-legged OAuth flow。要使用 OAuth 2.0 生成用户 Access Token，你可以使用 Authorization Code with PKCE grant flow)。
账户设置要访问这些端点，你需要：在我们的入门指南中了解更多有关获取 X API v2 端点访问权限的信息。