← 所有文章
更新日誌

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 之上,多接一個渠道只是多點兩下滑鼠的事。