← 所有文章
更新日志

UnifyPort Exporter 正式上线：一键连接 X 和 TikTok 账号的浏览器插件 — UnifyPort

上线了什么

UnifyPort Exporter（v1.0.0）现已在 Chrome 应用商店上线。这是一款仅 37 KB 的浏览器插件，只做一件事：当你在浏览器里登录 X（推特）或 TikTok 时，它会捕获该账号的会话上下文，并以 JSON 文件的形式保存在你本机——不上传，不经过任何第三方。

这个 JSON 文件正是 UnifyPort auth_mode=session（会话导入）连接流程中缺失的那一块。在这之前，要为 X 或 TikTok 拿到一份有效的会话导出文件，往往需要借助其他工具或手动操作。有了 UnifyPort Exporter，整个过程变成了：登录、点击图标、点击导出，完成。

对于在东南亚做跨境业务的团队来说，这意味着把 X 或 TikTok 接入团队现有的统一 webhook，不再需要额外排队等技术同事手动准备会话文件。

X（推特）：完整的会话导入流程

自 v1 API 上线以来，X 就支持 auth_mode=session——你提供一个已授权的会话，UnifyPort 完成导入。流程如下：

1. 创建账号记录

POST /v1/accounts
Content-Type: application/json

{
  "provider": "twitter",
  "auth_mode": "session"
}

2. 用 UnifyPort Exporter 导出会话

在浏览器中打开 X，确保已登录想要接入的账号，点击 UnifyPort Exporter 图标，选择 Export X session。插件会生成一个 JSON 文件，包含该账号的 cookie 和页面用户/会话上下文。

3. 导入会话

POST /v1/accounts/{account_id}/auth/session/import
Content-Type: application/json

{
  "params": {
    "session_url": "<导出的会话 JSON 引用地址>",
    "pin": "0000"
  }
}

params.pin 仅在账号开启了双重验证时才需要，默认值为 0000。如果这一步还需要按地理位置路由连接，也可以传入 params.proxy_config。

4. 启动运行时

导入响应确认会话有效后，照常启动运行时：

POST /v1/accounts/{account_id}/runtime/start

之后，X 的消息会以统一的 message.received 事件形式推送到你的 webhook，schema 和其他渠道完全一致。

TikTok：同样是一键导出

TikTok 没有官方的私信 API——需要接收 TikTok 消息的团队此前已经在使用 UnifyPort 基于会话的连接方式（详见我们之前的文章《TikTok 没有私信 API，团队如何接收 TikTok 消息》）。UnifyPort Exporter 在 X 之外新增了 TikTok session export 选项，用法完全一样：登录、点击导出，得到一份可以直接用于账号接入流程的 JSON 文件。

无论是 X 还是 TikTok，插件都要求你已经在浏览器中登录目标账号——它本身不处理登录，只是把已经存在的会话捕获下来。

隐私与适用范围

来自插件商店页面的几点说明：

  • 仅本地处理。 导出文件直接写入你的电脑，插件本身不会主动上传到任何地方。
  • 目前支持两个平台。 v1.0.0 支持 X 和 TikTok。如果你的团队接入的是 WhatsApp、Telegram、LINE 或 Zalo，这些渠道已经有各自的验证码/二维码/会话流程（/v1/accounts/{id}/auth/session/*），不需要这个插件。
  • 不出售数据。 开发者（unifyport.ai）声明插件不会收集、出售或将用户数据转移给核心功能之外的第三方。

如何开始

  1. 在 Chrome 应用商店安装 UnifyPort Exporter。
  2. 在同一个浏览器中登录 X 或 TikTok。
  3. 点击插件图标，导出想要接入账号的会话。
  4. 通过 POST /v1/accounts 创建账号，传入 provider: "twitter"（或对应的 TikTok provider）和 auth_mode: "session"。
  5. 通过 /auth/session/import 导入会话，再启动运行时。

如果你的团队已经在用 UnifyPort 接收 WhatsApp 或 Telegram 消息，只是因为会话导出这一步麻烦而一直没接入 X 或 TikTok，现在这个理由不存在了——在你已经在用的统一 webhook 之上，多接一个渠道只是多点两下鼠标的事。