如何通过Bluesky API向陌生用户发起私信并获取convoID？

一、通过Bluesky应用发起陌生对话 #

• 打开Bluesky应用，搜索目标用户的完整handle（格式为用户名.bsky.social）
• 进入用户主页后，点击右上角的对话气泡图标，直接发送消息即可发起对话，无需对方预先关注或互动

二、获取convoID用于Chat API #

发起对话后，可通过两种方式获取convoID：

1. 从应用本地数据/抓包提取 #

• 桌面端浏览器：打开开发者工具（F12），进入Application标签页，在Local Storage的bsky.social存储项中，搜索含conversation的键值对，其中的cid字段就是convoID
• 移动端：用抓包工具捕获Bluesky的API请求，发送第一条消息的响应数据里会包含cid（即convoID）

2. 通过API接口获取 #

调用com.atproto.chat.listConvos接口拉取对话列表，从中筛选目标用户的对话条目，提取cid字段。示例代码：

import requests

# 替换为你的访问令牌和目标用户handle
ACCESS_TOKEN = "你的Bluesky访问令牌"
TARGET_HANDLE = "目标用户.bsky.social"

headers = {
    "Authorization": f"Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json"
}

response = requests.get("https://bsky.social/xrpc/com.atproto.chat.listConvos", headers=headers)
convos = response.json()

# 筛选目标用户的对话
for convo in convos["convos"]:
    participants = [p["handle"] for p in convo["participants"]]
    if TARGET_HANDLE in participants:
        convo_id = convo["cid"]
        print(f"目标对话convoID: {convo_id}")
        break

关键说明 #

• 首次发送消息给陌生用户后，convoID立即生成，无需对方回复
• 确保你的访问令牌拥有chat权限，令牌可在Bluesky应用的「设置-高级-创建访问令牌」中生成

内容的提问来源于stack exchange，提问作者Ramesh K R