X 渠道指南

连接 X、创建内容和线程、设置回复与 Community,并查看数据分析。

文档负责人:
BlendDuck Documentation
最近复核:

BlendDuck 通过 OAuth 2.0 连接 X。授权包含发布、媒体上传、账号身份和刷新能力,不需要把 X 密码或 Token 粘贴到控制台。

连接 X

  1. 在另一个浏览器标签中登录正确的 X 账号。
  2. 打开控制台 → 渠道
  3. 选择 X → Connect
  4. 查看并批准请求的权限。
  5. 回到 BlendDuck,核对 Handle、显示名称和头像。
  6. 加入活动前先发布一条简短测试内容。

当 X 撤销授权、账号所有者调整安全策略,或 BlendDuck 请求新增权限时,请重新连接。不要把 Bearer Token 粘贴到草稿或支持评论中。

创建内容或线程

元素BlendDuck 当前支持
文字最多 280 字符,使用 X/Twitter 专用计数;网址和 Unicode 的计算可能不同于普通字符串长度。
图片最多四张。
视频一个,最长 140 秒。
混合媒体同一条内容不能同时包含图片和视频。
线程支持;每一段会作为上一段的回复发布。

请逐段审核线程。如果后续段落失败而前面已经发布,不要重发整个线程;先在历史记录中确认哪些 X Post ID 已经存在。

设置回复与 Community

在草稿的 X 渠道设置中,Who can reply 可以选择所有人、你关注的账号、被提及账号、订阅者或已认证账号。X 对不同账号开放的选项可能变化,应以发布时编辑器可用值为准。

发布到 X Community 时,粘贴如下格式的完整网址:

https://x.com/i/communities/1493446837214187523

BlendDuck 会提取数字 Community ID。主页、内容网址、短网址或缺少 ID 的 Community 网址会在发布前被拒绝。

数据分析

X Analytics 包括内容和粉丝历史。BlendDuck 会定期同步平台数据,因此内容可能先上线,指标稍后才出现。BlendDuck 当前没有 X 的 Social Inbox 适配器;除非已连接渠道明确显示该能力,请在 X 原生应用中处理回复和私信。

故障排查

现象解决方法
字符数比预期高以编辑器的 X 专用计数为准,缩短网址或 Unicode 密集文本,不要依赖通用计数器。
媒体上传失败确认来源可访问,只使用图片或一个视频,不混合媒体;视频最长 140 秒。
Community 被拒绝粘贴完整的 https://x.com/i/communities/<数字 ID> 网址。
线程只发布了一部分在 History 中确认成功段落及平台 ID,再决定继续还是原生删除。
回复限制失败选择当前账号和内容上下文允许的回复受众。
授权过期重新连接同一个 X 账号,并在重试前检查排期内容。

通用上传检查请查看媒体准备,防重复和平台错误处理请查看故障排查