← 所有文章
更新日誌

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（推特）：完整嘅工作階段匯入流程

由 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，呢啲渠道已經有各自嘅驗證碼/QR code/工作階段流程（/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 之上，多接一個渠道淨係多撳兩下滑鼠嘅事。