網誌
UnifyPort 團隊嘅文章、教學同公告。
- 教學
透過 API 退出 WhatsApp 群組：安全操作流程
使用 UnifyPort 及正確的帳戶與群組 ID 退出 WhatsApp 群組，分清成員資格、紀錄清理、待發回覆及結果未確認的處理。
閱讀更多 → - 教學
Telegram 格式解析失敗：安全傳送含 HTML 的動態文字
排查 Telegram parse_mode 錯誤，正確轉義客戶姓名及 AI 回覆，並分清 Bot API 與 UnifyPort 的 provider_data 參數。
閱讀更多 → - 教學
LINE 載入動畫不顯示？檢查對話類型與顯示時機
使用 chatId 和 loadingSeconds 顯示 LINE 載入動畫，排查看不到、提早消失及重複更新問題，並分清動畫計時與回覆權杖。
閱讀更多 → - 教學
Telegram Bot API 429：用 retry_after 管理發送佇列
持久保存 Telegram retry_after 截止時間，協調多個 worker 的冷卻狀態，分清限流拒絕與未知發送結果，避免混用 Bot API 和 UnifyPort 契約。
閱讀更多 → - 教學
用 API 更改 WhatsApp 群組管理員：提升與撤銷權限
透過 UnifyPort 管理 WhatsApp 群組管理員，正確選取成員 LID、檢查角色並核對結果，避免將撤銷管理員誤當成移出群組。
閱讀更多 → - 教學
透過 UnifyPort 新增及移除訊息表情回應
用正確的訊息目標及 sender_id，為 WhatsApp、Telegram 新增或移除表情回應，並分清主動操作與 reaction webhook。
閱讀更多 → - 教學
用 API 取得 WhatsApp 群組邀請連結：讀取不等於重設
透過 UnifyPort 讀取 WhatsApp 群組邀請連結，管理分享權限，並在原生重設後更新快取，避免誤用未有文件支持的重設操作。
閱讀更多 → - 教學
WhatsApp 對話跨標籤交接：安全的 API 操作流程
透過 UnifyPort 將 WhatsApp 對話轉到另一工作流程標籤：先加入目標標籤，核實後移除來源標籤，保留其他分類及處理未確定結果。
閱讀更多 → - 教學
WhatsApp 聯絡人備註：設定或清除私人顯示名稱
透過 UnifyPort 設定及清除 WhatsApp 聯絡人備註，分清帳戶層級名稱、CRM 別名、通訊錄姓名同步與聯絡人名片。
閱讀更多 → - 教學
UnifyPort 群組 @ 提及：修正 WhatsApp 與 LINE 的純文字標記
配對頂層 mentions 與訊息標記，排查群組提及原樣顯示、舊欄位失效，以及 WhatsApp 和 LINE 的支援差異。
閱讀更多 → - 教學
UnifyPort 媒體發送：檔案 URL 與送達問題排查
正確建立圖片、影片及檔案發送請求，檢查渠道支援與 URL 存取，區分請求已接受和訊息已送達，避免不安全重試。
閱讀更多 → - 教學
用 contact.updated Webhook 同步 WhatsApp 聯絡人姓名
合併 WhatsApp 通訊錄姓名變更，正確區分欄位缺省與清空，保留本地暱稱，避免混淆聯絡人 ID 與對話 ID。
閱讀更多 → - 教學
用 request_id 與 X-Request-Id 追蹤 UnifyPort API 錯誤
保存客戶端與伺服器請求識別碼，處理 204 空回應及逾時，並分清 API 追蹤、webhook 去重與發送重試。
閱讀更多 → - 教學
按需載入 WhatsApp 較早訊息：歷史請求與非同步回調
用 UnifyPort 實作安全的「載入較早訊息」功能：訂閱歷史事件、合併非同步批次、更新有效錨點，並處理逾時及未能確認完成的狀態。
閱讀更多 → - 教學
Webhook 媒體相簿：整合照片展示而不遺失訊息
按訊息 ID 儲存相簿子項，再按帳戶及對話範圍整合，處理重複投遞、缺少總數及延遲到達的照片，不把等候時間當成完整性保證。
閱讀更多 → - 教學
安全更換 UnifyPort Webhook 簽署密鑰
先部署短期雙密鑰驗證，再更新 signing_secret，最後按驗收條件移除舊密鑰；毋須關閉 HMAC，也不假設伺服器提供寬限期。
閱讀更多 → - 教學
WhatsApp 引用回覆：分清 reply_token 與父訊息 ID
透過 UnifyPort 引用 WhatsApp 訊息，要使用該訊息的 reply_token，而非父訊息 ID。了解 token 缺失、invalid_reply_token 及渠道支援限制。
閱讀更多 → - 教學
處理 LINE 收回訊息事件：防止已刪除內容重回收件箱
利用 message.deleted 清理 LINE 收回訊息在收件箱、搜尋及 AI 上下文的副本，避免延遲訊息或編輯事件還原內容。
閱讀更多 → - 教學
WhatsApp Passkey QR 認證：安全完成 Webhook 接入
UnifyPort WhatsApp QR + Passkey 操作指南：建立 messaging account、啟動 QR 認證、處理 WebAuthn Passkey 狀態，並驗證簽名入站事件。
閱讀更多 → - 教學
Telegram getUpdates 同 setWebhook 衝突：安全切換 Runbook
Telegram bot 喺 getUpdates 同 setWebhook 之間切換後收唔到訊息時，用呢份 runbook 確認接收模式、清理舊接收端、處理 pending updates，並判斷是否改用統一入站 webhook。
閱讀更多 → - 教學
Telegram 媒體附件統一 Webhook：相片、語音、文件、聯絡人同位置
用 UnifyPort 的標準 message.received 事件處理 Telegram 媒體訊息：映射文字、附件、聯絡人同位置，先做 HMAC-SHA256 驗簽，再安全入庫。
閱讀更多 → - 教學
Zalo QR 授權：處理 qrcode_expired 並接收簽名 Webhook
用 QR 授權連接 Zalo messaging account，處理 qrcode_expired，並在分流客服訊息前驗證簽名的 message.received Webhook。
閱讀更多 → - 教學
用 QR 授權將 TikTok 帳戶接入簽名 Webhook
TikTok 入站接入流程：先建立帶簽名的 UnifyPort webhook，再建立 TikTok 帳戶、輪詢 QR 授權狀態，並接收標準化 message.received 事件。
閱讀更多 → - 教學
用 UnifyPort 建立 WhatsApp 群組入群申請審批隊列
把 WhatsApp 群組入群申請變成可驗簽、可審計的流程：用 group.join_request 觸發同步，再用清單及批量審批 API 處理。
閱讀更多 → - 教學
建立 UnifyPort API key 之後：第一個 Webhook 測試清單
新 UnifyPort workspace 的第一輪實作清單：驗證 API key、建立有簽章的 webhook endpoint、保存 message.received 事件，避免第一日常見整合錯誤。
閱讀更多 → - 教學
用 GitHub Copilot 建一個 TikTok DM Webhook 接收器
將 UnifyPort webhook 文件交畀 GitHub Copilot，產生可驗證 HMAC-SHA256、儲存 message.received 事件並送入客服隊列嘅 TikTok 入站接收器。
閱讀更多 → - 教學
UnifyPort 入站整合：先建立 Webhook 的檢查清單
以 signed webhook 開始 UnifyPort 入站整合：建立端點、驗證 message.received、先入庫，再連接 WhatsApp、Telegram、LINE、TikTok、Zalo 或 X 帳戶。
閱讀更多 → - 教學
Telegram 群組加入申請：建立可靠審批隊列
以定期查詢作為 Telegram 群組加入申請的事實來源，用 webhook 事件觸發更新，再批次批准或拒絕申請。
閱讀更多 → - 教學
用 message.updated Webhook 處理 LINE 訊息編輯
LINE 已為適用群組聊天室加入 messageEdited Webhook 事件。本文說明如何在 UnifyPort 以 message.updated 合併編輯內容，避免共享收件箱出現重複訊息。
閱讀更多 → - 教學
如何在 WhatsApp 共用收件箱同步已讀與未讀狀態
利用 UnifyPort 的對話已讀/未讀動作、訊息回條及 conversation.updated 事件，建立可靠的 WhatsApp 共用收件箱狀態同步。
閱讀更多 → - 教學
如何在統一 Webhook 處理訊息表情回應
安全處理 UnifyPort 的 message.reaction 事件：找出原訊息、分辨新增與移除表情、驗證 HMAC-SHA256，並以冪等方式更新回應狀態。
閱讀更多 → - 教學
UnifyPort Webhook 事件篩選：用 subscribed_events 還是萬用字元？
了解建立 UnifyPort Webhook 端點時，如何選擇明確的 subscribed_events 或 ["*"] 萬用字元，並套用適合收件箱、帳戶狀態及完整事件收集器的設定。
閱讀更多 → - 教學
如何零停機輪換 UnifyPort API Key
更換 UnifyPort API Key 時避免認證中斷：先建立第二把 Key，完成部署及測試，再停用舊 Key，並了解何時不應直接使用即時輪換端點。
閱讀更多 → - 教學
WhatsApp 聯絡人 API：新增聯絡人與傳送 vCard 的分別
了解如何分辨將聯絡人加入已連接 WhatsApp 帳戶的通訊錄，以及在對話中傳送 vCard 聯絡人卡片，並使用正確的 UnifyPort 路由、欄位及錯誤處理。
閱讀更多 → - 教學
將 Telegram 個人帳戶連接 Webhook：驗證碼與 QR Code 設定
由 Telegram API ID/API hash、簽署 Webhook 到驗證碼或 QR Code 授權，完整連接現有 Telegram 個人帳戶並接收 message.received 事件。
閱讀更多 → - 教學
訊息帳戶 Runtime 復原：應該 Refresh、Reconnect、Start 還是重新認證？
按 runtime_status 與認證狀態選擇正確的 UnifyPort 復原動作，避免重啟正常連線，或把連線問題誤判成認證失效。
閱讀更多 → - 教學
TikTok Shop Customer Service API Webhook 正式上線檢查清單
設定 TikTok Shop Customer Service API 的 New Message webhook，完成簽署驗證、快速回應、冪等處理、歷史核對及正式環境驗收。
閱讀更多 → - 教學
Telegram API_ID_PUBLISHED_FLOOD 點樣修復：復原檢查表
排查 Telegram API_ID_PUBLISHED_FLOOD，以自家應用程式憑證取代已公開的範例 API ID，分辨授權錯誤並安全恢復登入。
閱讀更多 → - 教學
LINE MINI App 再審發布：掌握 Approved 與 Reflected
了解哪些已認證 LINE MINI App 變更需要再審、Approved 如何轉為 Reflected，以及 30 天自動發布界線。
閱讀更多 → - 教學
LINE MINI App Service Message API 錯誤排查：400、401、403、429 同 500
分開檢查 token 簽發同訊息傳送，處理 LINE MINI App Service Message API 錯誤，保存更新 token，並為每個狀態碼選安全 retry 策略。
閱讀更多 → - 教學
WhatsApp Embedded Signup 完成後點驗收：後端核對清單
WhatsApp Embedded Signup 完成後，逐項核對 WABA、系統用戶權限、號碼狀態、webhook 訂閱及首次真實投遞，才將租戶標示為可用。
閱讀更多 → - 教學
為排隊回覆實作 WhatsApp 24 小時發送護欄
用伺服器端狀態機阻擋過期的 WhatsApp 排隊回覆，安全處理時段重設，並在實際發送前選擇合法路徑。
閱讀更多 → - 教學
Telegram Bot API 10.2 Communities：處理聊天室加入及移除事件
了解 Telegram Communities 在 Bot API 10.2 的事件結構，處理 community_chat_added 及 community_chat_removed，並分開管理社群拓撲與跨平台訊息。
閱讀更多 → - 教學
LINE 已讀 API 遷移指南：2026 年 10 月前轉用 markAsRead
由需要另外申請的 LINE 舊版已讀 API 遷移至 POST /v2/bot/chat/markAsRead，正確使用 webhook 的 markAsReadToken，同時保留 Official Account Chat。
閱讀更多 → - 教學
恢復漏收嘅 LINE MINI App 付款 Webhook：7 日對帳操作手冊
透過 LINE 官方 7 日事件歷史 API、cursor 分頁同 orderId 冪等處理，恢復漏收嘅 MINI App 付款 Webhook，並建立安全嘅對帳流程。
閱讀更多 → - 教學
點樣用通知 token 發送 LINE MINI App 服務訊息
了解點樣透過官方 token 同發送端點，簽發、儲存、更新並使用 LINE MINI App 服務通知 token，以及相關限制同失敗處理方法。
閱讀更多 → - 教學
點樣喺群組聊天室傳送 Telegram 私密短暫機械人訊息
掌握 Bot API 10.2 私密群組回覆規則：可用觸發條件、15 秒時限、管理員權限、傳送限制，以及編輯同刪除方法。
閱讀更多 → - 教學
Webhook HMAC 重播保護：時間戳、重試同冪等性
驗證 RFC 3339 時間戳同 raw-body HMAC-SHA256 簽名，防止 webhook 請求被重播，再以 event ID 去除合法重試造成嘅重複處理。
閱讀更多 → - 教學
WhatsApp Embedded Signup v4 Coexistence 遷移：2026 年 10 月 15 日前檢查清單
Meta 將於 2026 年 10 月 15 日停用 Embedded Signup v2。按設定、webhook、callback 同 rollout 清單，將 WhatsApp Coexistence onboarding 遷移到 v4。
閱讀更多 → - 教學
2026 年 10 月起，點樣追蹤同計算 WhatsApp service message 收費
用 Pricing Analytics 同狀態 webhook 追蹤及計算 WhatsApp service message 收費，預備 2026 年 10 月 1 日新計費方式，分清對話、訊息類別同 AI agent 費用。
閱讀更多 → - 教學
用簽名入站 Webhook 建立 n8n WhatsApp AI Agent
n8n 好適合做 AI workflow，但 WhatsApp 客服自動化第一步係穩定接收入站事件。本文示範如何將 UnifyPort 的 message.received 簽名 webhook 接入 n8n production workflow。
閱讀更多 → - 教學
TikTok 資料可攜唔等於即時私訊：建立客服真正需要嘅入站隊列
TikTok Data Portability API 已更清楚列出私訊匯出資料，但匯出唔係即時客服訊息流。本文說明如何用 UnifyPort webhook 建立帶簽名驗證嘅 TikTok 入站隊列。
閱讀更多 → - 教學
將 Webhook 文件丟畀 Devin Desktop，20 分鐘搞掂 LINE 訊息接收服務
實戰紀錄：將 UnifyPort API 文件餵畀 Devin Desktop（原 Windsurf），用 Python 起一個 LINE 入站訊息處理器——HMAC-SHA256 簽章驗證、結構化日誌、多平台擴展——唔使 LINE 官方帳號。
閱讀更多 → - 教學
我畀 Cursor 睇住 Webhook 文件，半個鐘搭好 Telegram 轉 Slack 嘅訊息中繼
構建日誌：將 UnifyPort 嘅 Webhook 文件餵畀 Cursor，用 Node.js 搭一個 Telegram 轉 Slack 嘅訊息中繼——簽章驗證、Slack Block Kit 格式化、多頻道轉發——唔使註冊 Telegram 機械人。
閱讀更多 → - 教學
我畀 Claude Code 起咗個 X 私訊同提及監聽器——完全冇掂過 X 嘅 API
建構日誌：將 UnifyPort webhook 文件餵畀 Claude Code，用 Node.js 起一個 X 私訊同提及監聽器——簽章驗證、結構化日誌、Discord 告警——唔使畀 X 嘅按次收費 API 費用。
閱讀更多 → - 教學
我將 API 文件丟畀 Claude Code，佢幫我砌咗個 Zalo Webhook 接收器
構建日誌：將 UnifyPort API 參考文件餵畀 Claude Code，用 Python 砌一個 Zalo webhook 接收器——簽章驗證、訊息記錄、轉發到 Slack——唔使一個鐘搞掂。
閱讀更多 → - 教學
我將 Webhook 文件掉俾 AI 編碼助手,佢直接整咗個跑得起嘅自動回覆機械人
一份開發實錄:將 UnifyPort 嘅 webhook 介面文件餵俾 Cursor、Claude Code 呢類 AI 編碼助手,睇住佢喺一個下晝之內整出真係跑得起嘅自動回覆機械人——簽章驗證、入站路由、回覆呼叫,一氣呵成。
閱讀更多 → - 教學
唔靠官方 API，點樣接收 WhatsApp 入站訊息
2026 年 Meta 幾項變動——按條計費、企業驗證門檻、禁咗通用 AI 機械人——將官方 WhatsApp API 嘅門檻抬高咗。如果你想要嘅只係穩陣噉接收入站訊息，仲有另一條路行得通。
閱讀更多 → - 教學
TikTok Shop 12 小時規則：點解你嘅客服系統需要事件驅動架構
TikTok Shop 已將 DM 響應時間納入店鋪健康評分。人工處理喺直播期間必然崩潰。本文介紹事件驅動系統點樣應對流量爆發，以及跨渠道擴展嘅架構思路。
閱讀更多 → - 教學
Telegram Bot-to-Bot API：對 AI Agent 架構意味著咩
Telegram 靜靜地成為首個支援 Bot 之間原生通訊嘅十億用戶平台。呢篇文章解析技術變化、對多智能體系統嘅影響，以及建構前需要考慮嘅問題。
閱讀更多 →