跳到导航

X 公告发出后,怎么从回复里找出需要补答和核查的问题?

要整理一条 X 公告下的待答问题,用 twitter.web.fetch_post_comments 和公告的 tweet_id 取公告下的回复。逐条对照公告原文,把已经答过、需要补充说明、仍待产品核对的问题分别标出。交接时每条带上回复原句、适用地区或版本、来源和下一步。

先把原公告作为判断依据

保留公告链接、帖子 ID,以及你实际读到的公告原文或版本。回复里问“什么时候开始”,可能指正式开放、某个地区上线或候补资格;不对照公告原文就把这些回复归成同一个问题,后续补答就会偏题。

公告正文已经在手里时直接复用。只有需要原文时,才用单独的详情动作补取原帖;详情动作有自己的合同和费用。只读了一段预览,不能说已经读过公告的所有条款。

每条回复,先做哪种判断?

下表是常见回复情况的阅读方法:

回复情况在清单里怎么记下一步
问公告没有交代的适用范围待答问题,保留原句和对应条款请产品负责人确认,再拟补充说明。
问题已经在公告里说明已答但可能不易找到,记录出处评估是否需要改善说明的位置;不重复统计为新功能需求。
声称无法使用,但没有步骤待核问题,不直接判定故障列明缺版本、条件或复现步骤,交支持团队核查。
回复的是另一个人的经历或反讽上下文待核先定位上级讨论;未取得父关系时不凭用户名猜。
重复问同一件事保留每条证据,再归入同一问题主题主题出现次数与独立人数分开,不等于所有读者的比例。

点赞多只说明这条回复值得优先阅读,不证明回复观点正确、公告有错或多数用户同意。原帖展示的总回复数,也推算不出还没读到的回复说了什么。

最后交付一张待答表

每条回复人工记录:公告 ID、回复来源、逐字原句、归纳的问题、对应的公告条款、状态(已答/待答/待核)、缺什么上下文、建议负责角色、下一步。原句与归纳分列;拿不到的回复 ID、父关系或正文留空并写明原因,不要自行补齐。

同事看这张表就能知道:哪些问题可以补充说明,哪些要先核实事实,哪些已经有答案。建议负责角色只是建议的交接对象,不代表已经分派;草拟的答复也不会自动发到 X。要进入团队跟进时,可参考反馈分流原则,但品牌反馈分流指南的脚本只接受该指南指定的搜索导出,不能直接读取结构未知的回复 JSON。

怎样控制范围,什么时候停?

先取一页,相关问题已经够用时,先核查这些问题。要继续取时,只使用响应里实际返回并已确认的游标,公告保持不变;每多一页、每次补详情和每次补上下文都各算一次调用。没有明确游标、页面重复、出现错误或用完批准的预算时就停止,不要为了“抓全”自动重试。

交付说明里写清观察时间、实际读取的页数和没有审阅的部分。待答表只代表实际读到的回复,不覆盖全部讨论,也不是自动持续监控。下面第 1–5 步是输入与读取步骤。

1. 从帖子链接取 ID

https://x.com/<handle>/status/<tweet_id> 里 /status/ 后面的值就是帖子 ID。保留完整原链接作为来源,同时把帖子 ID 作为字符串保存,避免表格或数字类型丢失精度。不要把作者用户名传给 tweet_id。

只需要回复且已知帖子 ID 时,不用先请求帖子详情。要把原帖内容和回复一起分析时,再查看详情能力,并把详情请求计为另一笔调用。

2. 确认是指定帖子的回复能力

curl -sS https://api.beatapi.io/v1/capabilities/inspect \
-H 'Content-Type: application/json' \
-d '{"reference":"data:twitter.web.fetch_post_comments"}'

Inspect 免费。twitter.web.fetch_post_comments 需要 tweet_id,下一页使用字符串 cursor。不要换成 fetch_user_tweet_replies:fetch_user_tweet_replies 需要 screen_name,返回的是账号的回复时间线,不是目标帖子下的回复。

3. 读取第一页

确认实时价格后,发送第一页请求:

curl -sS https://api.beatapi.io/v1/social-data/call \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"action":"twitter.web.fetch_post_comments","params":{"tweet_id":"<tweet_id>"}}' \
-o x-post-replies-1.json

检查 HTTP 状态和执行状态,保留原文件 x-post-replies-1.json。twitter.web.fetch_post_comments 当前是 runnable 能力,还没有发布固定的输出 schema;搜索能力的 data.timeline、data.next_cursor 路径不能直接套用到回复结果上。先在实际 JSON 里找到回复列表和游标的位置。

4. 翻页与停止条件

下一次请求传回真实游标,tweet_id 保持不变。twitter.web.fetch_post_comments 没有公开的排序参数:不要自行添加 sort,也不要承诺结果按最新或点赞排序。需要别的排序时,先单独 Inspect 另一个能力;另一个能力的结果不是 twitter.web.fetch_post_comments 的下一页。

设定页数上限,例如最多两页;游标缺失或重复、接口报错、达到预算时停止。每页单独计费。原帖展示的回复总数可能与当前能取到的记录数不同,不能用两者的差额证明接口丢数据,也不能据此推算隐藏回复的内容。

5. 把问题与原帖放在一起整理

列保存内容
原帖原链接与 tweet_id,原文只在实际已读时引用。
回复来源真实回复 ID、作者及返回链接(如有)。
问题简短原文与归纳后的问题分列。
上下文对应哪个公告条款,是否还需读取上级回复。
下一步补充说明、排查问题或人工核查;不自动发帖。

回复里提出的指控记录为待核实的说法,不能直接当作产品故障事实。没有读到完整讨论串时,在“上下文”列写明缺失,不替作者推断立场。

读取我提供的 X 公告帖回复。先检查帖子回复能力和价格,确认后只取一页。按真实字段保存来源,区分原文与推断,整理需要补答的问题。不读取账号回复时间线,不翻页,也不对外回复。

已知帖子 ID 时,取一页回复只需要一次 twitter.web.fetch_post_comments 调用;每次补详情、每多一页都另算一次执行。来源:免费合同 data:twitter.web.fetch_post_comments。

关键词搜索 · 社媒数据合同 · 结果读取合同