設定

表格同步

把組織的審稿表格（飛書多維表格、Lark Base、Notion、Airtable、Google 試算表、釘釘多維表）接上 tennnzo。tennnzo 是唯一的資料來源，表格是它的一扇窗。這頁說明組織管理者怎麼自己設定、每一欄誰是主人、在表格改東西會發生什麼、同步紀錄怎麼看。

有些團隊習慣在表格裡看稿、改狀態。表格同步把 tennnzo 和那張表格接起來：tennnzo 是唯一的資料來源，表格是 tennnzo 的一扇窗。組織管理者在「組織設定 › 表格同步」自己完成設定，不用找平台。

支援的平台#

平台	憑證	配圖	備註
飛書多維表格	自建應用的 App ID 與 App Secret，或 tennnzo 的共用應用	直接上傳到附件欄	事件訂閱接上後表格一改就同步
Lark Base	同飛書	直接上傳	海外版飛書
Notion	Integration token	以 tennnzo 的圖片連結顯示	單選選項要先在 Notion 建好，同步不會自己新增
Airtable	Personal access token	給網址，Airtable 自己抓	沒有逐列修改時間，同步靠比對格子
Google 試算表	服務帳戶（Service account）JSON，試算表分享給它	文字格放連結，一行一張	欄位是純文字；多一欄隱藏的 `tennnzo_row` 當列鍵
釘釘多維表	企業內部應用的 AppKey、AppSecret 與操作者 unionId	連結寫在文字或連結欄	寫完等 8 秒再回讀；每輪讀兩次防短讀

設定步驟（組織管理者）#

選平台：六張卡選一張，填名稱。
憑證：依平台填。送出後立刻加密保存，之後不會再顯示，要換就重填；接著按「測試連線」。飛書／Lark 若平台有開「共用應用」，可以改選它：把 base 分享給那個應用（可編輯）就好，不用自己建應用。
表格，兩條路：

tennnzo 幫你建表：貼 base（或頁面、試算表）的網址，tennnzo 建一張標準欄位的表並自動填好對照。
接既有表：貼表格網址，tennnzo 讀欄位、按名稱猜對照，你逐欄確認；缺必要欄位、型別不對、狀態欄缺任何一個選項時會擋下來，寫清楚缺什麼。表格要有一欄文字的「tennnzo ID」。

帳號與切換日：選要同步的帳號（預設全部）、切換日（預定日期在這天（含）以後的稿才同步）、方向。雙向要等試寫通過才能選。
試寫：選一支帳號，只寫入表格一次。回讀相符、沒有問題才算通過，結果顯示在卡上。
啟用：試寫通過後按「啟用同步」。之後每 20 秒一輪。

標準欄位：帳號編號、帳號、預定日期、主題、貼文內容、配圖、狀態、審核意見、客戶修改意見、貼文連結、實際發布時間、主機（組織的 Agent）、接續回覆、審稿動作、同步衝突、tennnzo ID。

同步什麼、往哪個方向#

內容	tennnzo → 表格	表格 → tennnzo
帳號編號、帳號名稱、tennnzo ID	寫入	不讀（tennnzo ID 是對應的鑰匙）
預定日期	寫入	改了日期會寫回（保留原本的時間，只換日期）
主題、內文、接續回覆	寫入	改了會寫回，成為新的版本
配圖	tennnzo 的稿有圖才寫入；稿上沒有圖時不動表格原本的附件	不讀：圖請附在 tennnzo 的稿上
狀態	寫入	不讀：改了會被改回
審稿動作	執行後清空	讀：換算成審稿按鈕，以表格最後修改人名義登記
審核意見、客戶修改意見	寫入最新一則退回意見	跟「退回要改」一起＝退回意見；只填意見、不選動作＝要修改
同步衝突	兩邊同時改時寫入未採用的內容	不讀
貼文連結、實際發布時間	tennnzo 有值才寫入	不讀

帳號編號帶世代：帳號編號欄寫成 TW-T014-1，帳號欄寫成 TW-T014-1 顯示名稱 @帳號名稱。新增列時可寫 TW-T014、TW-T014-1 或舊編號。
接續回覆放在同一格，每則之間一行只有 ———；回覆本身可以換行。
寫完一定回讀檢查；對不上的列記成問題、稍後重寫，不會重複新增。同步自己寫的格子不會被當成表格的修改讀回來。

每一欄只有一個主人#

「狀態」欄是 tennnzo 的：在表格直接改狀態不會生效，下一輪改回，同步紀錄記「狀態由 tennnzo 管理，請用審稿動作」。
「審稿動作」欄是人的：選「退給客戶」（待Agency審 → 待客戶審）、「核可」（待Agency審 → 待客戶審或可排程；待客戶審 → 可排程，以客戶名義）、「退回要改」（退給寫手；待客戶審時是客戶退回，意見取「客戶修改意見」，其他取「審核意見」）、「作廢」（可排程、已排程、發布失敗 → 已取消）。同步以表格的最後修改人名義在 tennnzo 按同一個按鈕，然後把這格清空；不合流程的動作不會執行，格子一樣清空，原因在同步紀錄。
「同步衝突」欄是同步的留言板。
寫手 Agent 只對 tennnzo 說話，不寫表格；表格只有同步會寫。審稿紀錄會寫是誰在表格做的，標示「表格同步代為登記」。

在表格改內容#

草稿或待內部審的稿：直接成為新版本。
已經過內部審的稿（待客戶審、可排程、已排程）：照樣寫回，但稿會退回「待內部審」重新審稿。已排程的稿改了，寫手 Agent 的工作清單會標「已排程、先到發布工具撤下」。
已發布、發布失敗、已取消的稿不能改，表格會改回原樣。

兩邊同時改：只有「上一次寫進表格之後，tennnzo 這邊有人（Agency、寫手 Agent、客戶）改過這篇」而表格也改了，才算同時修改；同步自己寫回的不算。真的同時修改時以 tennnzo 為準：表格的修改寫進那一列的「同步衝突」欄並存成那篇稿的備註，其他格改回 tennnzo 的版本；同一輪選的審稿動作照樣執行。

在表格新增或刪除列#

新增一列、填了帳號編號、預定日期和內文（沒有 tennnzo ID）：建成一篇「待內部審」的稿，tennnzo ID 寫回那一列。狀態是「缺文」或沒有內文的列不會建稿。
刪掉一列不會刪掉 tennnzo 的稿，下一輪會重建。要取消一篇稿，用「審稿動作」的「作廢」或在 tennnzo 處理。

重要在表格裡只改格子的內容：不要改欄位的型別、不要改或刪狀態、審稿動作等單選欄的選項、不要刪欄位、不要改或清空「tennnzo ID」這一欄（欄位改名沒關係）。同步永遠不動欄位設定，只寫值；Google 試算表只會多一欄隱藏的 tennnzo_row。

卡片、紀錄、暫停#

每張表一張卡：「設定」（平台、表格連結、憑證狀態、切換日、方向、帳號、試寫結果）與「同步紀錄」（最後寫入與讀取時間、最近幾輪寫了幾列、回讀相符或不符、讀了幾列、採用與退回幾筆、最近的問題）分開。表格的權限被收回或對照的欄位不見時，同步自動停止並寫明原因；修好後恢復。組織管理者可以暫停、恢復、停用；停用後可以修改帳號、切換日、方向，再試寫、再啟用；沒啟用的同步可以刪除（表格與 tennnzo 的稿都不會動）。同步停止或某一輪有問題時可以收通知（見組織設定 › 通知）。

用你的個人金鑰也看得到：list_table_syncs、table_sync_runs、pause_table_sync。寫手 Agent 用 table_sync_info 知道組織有沒有開、切換日是哪天。