============================================================
 Threads Token 自動續期 · n8n 工作流範本 使用說明
 免費分享 by Q kangber｜https://aiqkangber.com
============================================================

【這個範本在做什麼】
Threads 的「長期 access token」大約 60 天會到期，一過期，
你所有靠 token 抓 Threads 數據（報表、發文）的自動化就全部
失效。這條工作流每月 1 號 09:00 自動幫 token 續期（refresh），
把新的 token 寫回你的 Google Sheet，並記下到期日，讓你永遠
不用記得手動換。

------------------------------------------------------------
【重要前提：先把短期 token 換成長期 token（只做一次）】
------------------------------------------------------------
refresh 只能延長「已經是長期」的 token。所以第一次你要先
自己把短期 token 換成長期：

在瀏覽器網址列打這串（換成你自己的值），按 Enter：

  https://graph.threads.net/access_token
    ?grant_type=th_exchange_token
    &client_secret=你的_App_密鑰
    &access_token=你的_短期_token

回傳的 access_token 就是長期 token（約 60 天）。
把它填進下面的 Google Sheet。之後這條工作流會自動延長，
你不用再手動換。

------------------------------------------------------------
【一、準備 Google Sheet】
------------------------------------------------------------
新增一個分頁叫「設定」，第一列(表頭)填四欄：

  A1: key        B1: value       C1: 到期日     D1: 更新時間

第二列填你的 token：

  A2: threads_access_token   B2: (貼上你的長期 token)

C2、D2 留空，工作流跑完會自動填上。

------------------------------------------------------------
【二、匯入 n8n 並設定】
------------------------------------------------------------
1. n8n 右上角 → Import from File → 選 threads-token-auto-refresh.json
2. 「讀取 Token」「寫回新 Token」兩個 Google Sheets 節點：
   - 接上你自己的 Google Sheets 憑證(OAuth 或服務帳號)
   - documentId 填你的試算表 ID
     (網址 /spreadsheets/d/【這串】/edit 中間那串)
   - sheetName 選「設定」
3. 「Refresh Threads Token」節點不需要憑證(是 Threads 公開端點)，
   它會自動讀 Sheet 的 value 欄當作要續期的 token。
4. (選配)「LINE 通知」節點：填你的 LINE token 與 user id，
   不想要通知就直接刪掉這個節點。

------------------------------------------------------------
【三、為什麼有一個「確認 Refresh 成功」節點(防呆重點)】
------------------------------------------------------------
萬一某次 refresh 失敗(token 已過期、網路錯誤)，Threads 回的
不是新 token 而是錯誤訊息。這個 filter 會擋下失敗的情況，
「只有真的拿到新 token 才寫回 Sheet」——避免把你原本好好的
token 洗成空白(那會比沒更新更慘，token 直接不見)。

------------------------------------------------------------
【四、測試】
------------------------------------------------------------
手動執行一次(Execute Workflow)，到 Google Sheet 看：
  - value 欄是不是換成新的 token
  - 到期日 / 更新時間 有沒有自動填上
都有 → 把工作流右上角開成 Active 就完成了，之後每月自動跑。

------------------------------------------------------------
【安全】
------------------------------------------------------------
你的 token 只會存在「你自己的 Google Sheet」與「你自己的 n8n」，
這個範本不含任何人的真實金鑰，也不會把資料送到任何第三方。

============================================================
 有用的話，歡迎到 https://aiqkangber.com 看更多 n8n 教學。
============================================================
