THREADS API / SETUP GUIDE

先取得授權，
再把文章真正發出去。

一鍵連接會帶你到 Threads 授權。若暫時無法完成，可先用自己管理的 App 取得使用者 Token，再回本站驗證帳號。

整理日期：2026/10/02 · 依 Meta 官方範例與官方 Postman 文件。後台名稱可能調整，請以你帳號實際顯示為準。

先走 A 路線：用你自己的測試帳號取得 Token，貼到工作台驗證。App Secret 不必貼進網頁。這一版只做單則文字立即發布，沒有自動排程，也不會讓帳號免於停權。

先分清楚這四個東西

名稱	用途	要放哪裡
Threads User ID	API 回傳的帳號識別碼，不是 @名稱，也不是 App ID	貼入 Token 驗證後，本工具自動顯示；不需另外申請
Threads App ID	辨認你建立的應用程式	OAuth 後端設定
Threads App Secret	後端換取授權 Token	後端秘密環境變數，不能放在前端或 Git
Threads User Access Token	代表某個 Threads 帳號允許 App 操作	本工具的密碼式輸入欄；不要截圖或傳到聊天

注意要拿 Threads 專用的 ID／Secret；Meta 官方範例提醒，它們可能不同於一般 App 的 ID／Secret。App Token 也不能代替使用者 Token 發文。

A．先連自己的帳號測試

1．開啟你自己的 Meta 應用程式

打開 Meta 開發者後台，登入你管理 App 的帳號。
若尚未註冊開發者，依畫面完成註冊、驗證與條款確認。
已有可正常使用的 Threads App，就沿用該 App；沒有才建立 App，選擇 Threads API 相關使用案例（例如 Access the Threads API）。若畫面不同，搜尋 Threads 使用案例，不要誤選只支援 Facebook 發文的產品。

我已建立含 Threads 使用案例的 App

2．確認最小發文權限

這版使用 threads_basic 讀取帳號身分，以及 threads_content_publish 發布內容。不需要為了單純發文一次申請所有權限。

我已確認這兩項權限

3．把自己的 Threads 帳號加入測試

開啟 App 的角色／測試者設定，找到 Threads 測試者邀請。依後台提示加入你要發布的 Threads 帳號，並到該帳號的設定 → 帳號 → 網站權限／邀請等入口接受邀請。選單名稱依目前介面為準；送出邀請不等於已接受。必須接受「目前這個 App」的邀請；另一個 App 已授權，不代表這個 App 也可用。

我的 Threads 帳號已接受測試邀請

4．產生使用者 Access Token

到 App 的 Threads 使用案例／API 設定，尋找使用者 Token 產生工具（User Token Generator／Generate Access Token）。選擇已接受邀請的 Threads 帳號，確認發文權限並依提示授權。若後台沒有這個入口，改走下方 B 路線 OAuth，不要拿 Facebook Page Token 代替。

可用 Meta Token 檢查工具核對 Token 所屬 App、權限與到期狀態。連接成功只代表讀取帳號成功；發文權限仍以 Meta 發布請求的結果為準。

我已取得正確的 Threads 使用者 Token

5．回到工作台連接

開啟連接與發布，把 Token 貼進 Access Token 欄位。
按「驗證並連接帳號」，核對顯示的 @帳號名稱 是否正確。下方會顯示已驗證的 Threads User ID，可按「複製 User ID」。只有 User ID 而沒有有效 Token，不能發文。
Token 不會放入 localStorage 或備份；本站後端會驗證並以加密、HttpOnly Cookie 保留此裝置的連接，最長 8 小時。Token 若先到期或被撤銷，仍需重新連接。

工作台顯示正確的 @帳號

6．發布你同意公開的第一篇文章

填入 1–500 字正文 → 預覽帳號和內容 → 勾選確認 → 按「確認發布到 Threads」。系統先建立容器，再向 Meta 發布；只有收到貼文 ID，才顯示成功與可取得的貼文連結。

若顯示處理中、逾時或不確定，按「檢查上一筆發布」，並到 Threads 個人頁核對；不要一直按建立新貼文。這裡不會替你自動發布測試文字。

我已在 Threads 核對第一篇貼文

B．改用「前往 Threads 授權」

這是之後讓使用者按按鈕連接帳號的路線。先由你建立 App，再讓使用者授權；不需要每位客戶都提供 App Secret。

在 Threads App 設定加入精確的 HTTPS OAuth 回呼網址，協定、網域與路徑都要相同。
把 Threads App ID、Threads App Secret 設到本網站後端環境變數；App Secret 設為秘密值。
重新部署後，工作台的一鍵授權按鈕才會啟用。
使用者前往 Threads 同意授權，回到本站後核對帳號。本版 OAuth session 最長 1 小時，尚未自動換取／更新長效 Token。

本站回呼網址

後端環境變數	說明
`THREADS_APP_ID`	Threads App ID
`THREADS_APP_SECRET`	Threads App Secret，必須設為 secret
`APP_ORIGIN`	網站正式 origin，不含結尾斜線
`SESSION_SECRET`	由部署者生成的隨機秘密值，用來加密連接；不是 Meta Token

本站已公開上線，但網站公開不代表 Meta 已開放所有帳號授權。可用帳號範圍仍取決於 App 模式、權限與審查狀態。

要販售給其他人前，還缺什麼？

先驗證你自己的測試帳號能完整發文，再依 Meta App 後台要求辦理 App Review／所需存取權限，準備可用的產品流程、隱私政策、資料刪除說明與示範錄影；是否需要企業驗證，依 App 與權限的實際要求確認。不要把測試者能用，當成所有客戶都能用。

產品端還需要多使用者隔離、持久化 Token 管理與更新、雲端排程、重試與重複發布防護、服務監控。這一版不是已完成審查的多租戶 SaaS。

遇到問題，先看這裡

尚未接受測試邀請（1349245）

到目前 App 的 Threads 測試者設定核對帳號，再使用同一個 Threads 帳號接受邀請。確認邀請顯示已接受後，回本站重新連接。手動 Token 也不能繞過所屬 App 的權限限制。

Chrome 顯示 ERR_BLOCKED_BY_CLIENT

這是瀏覽器端阻擋，還不能判定 Meta 是否允許授權。請在可正常開啟 Threads 的瀏覽器登入，從本站重新點連接；不要重複建立 App。若遇到安全警告，先確認網址與原因。

User ID 到底在哪？

它不是需要另外申請的帳號。完成授權後，API 能回傳使用者識別碼。本站會在驗證 Token 時讀取帳號資料並顯示 ID；請勿用 Instagram ID、App ID 或 @名稱替代。

Token 驗證失敗／已失效

核對是否是 Threads 使用者 Token、是否到期、測試邀請是否接受。到 Meta 官方 Token 檢查工具核對，再重新產生或授權。不要把 Token 發給陌生人排錯。

能顯示帳號，卻不能發文

讀取帳號和發布是不同權限。檢查 threads_content_publish、App 模式與帳號限制；畫面會顯示 Meta 錯誤代碼，不能用「連接成功」推論有發文權限。

OAuth 回呼網址錯誤

使用本頁複製的正式 HTTPS 網址。Meta 官方範例提醒不要用 localhost 回呼，且必須與 App 設定完全一致。不要把網站首頁當成 callback。

顯示 PUBLISHED，但沒拿到連結

代表容器狀態顯示已發布，請到 Threads 個人頁核對；工具不會再次發同一容器。只有在取得實際貼文 ID 時才記錄為完整成功。

排了時間，為什麼沒發？

目前「本機計畫」只是規劃紀錄，沒有雲端排程。真正立即發布請用「連接與發布」。瀏覽器關閉後，本機不會執行工作。

官方參考資料

Meta 官方 Threads API 範例：Threads 專用 App ID／Secret、HTTPS 回呼。
Meta 官方 Postman 文件：授權、Token、建立容器與發布 API。
Meta Threads Get Started：完整設定要求（本次自動查閱遭限流，操作時以登入後的官方頁面為準）。

本頁是本站整理的操作指南，不是 Meta 核准證明。勾選進度只存在這個瀏覽器，不會傳送到 Meta。