← 所有文章
對比選型

WhatsApp 靜音還是封鎖?共享收件箱應如何選擇

只想減少 WhatsApp 通知干擾,應選對話靜音;希望阻止某個人向帳戶傳送訊息,才考慮封鎖聯絡人。兩者都不能代替系統內部的「暫停自動回覆」或「工單已解決」。共享收件箱應將這些決定分開,避免為了減少打擾而切斷客戶聯繫,或誤以為靜音後 AI 就不會繼續回覆。

三種控制,三種目的

WhatsApp 通知指南將靜音歸類為聊天通知設定。封鎖指南說明,被封鎖的聯絡人無法再致電或傳送訊息給你;解除封鎖後,也不會收到對方在封鎖期間傳送的訊息。因此,封鎖並非可以稍後取回內容的訊息緩衝區。

目的適合的控制不能據此推斷
減少聊天通知干擾對話靜音工單已解決,或 webhook 收件已關閉
阻止特定聯絡人聯繫經授權確認後封鎖聯絡人舊內容已刪除,或解除後會補回訊息
暫停 AI 自動回覆應用程式自行管理的暫停狀態平台靜音或封鎖會取消本地佇列工作
保留待跟進事項本地工單狀態,必要時加上未讀標記未讀即代表靜音

後兩項是應用程式設計建議,不是額外的 WhatsApp API 功能。已讀相關差異可參閱WhatsApp 已讀與未讀同步指南。通知偏好、已讀回條及團隊工作分配各有用途。

UnifyPort 實際提供甚麼操作

UnifyPort 的非官方接口將對話操作與聯絡人操作分開。以下是 UnifyPort 的 API 契約,不是 Meta Cloud API 路由。

操作輸入與文件邊界參考
靜音conversation_id,加秒數 duration 或未來的 RFC3339 時間 mute_until;兩者不能同時傳入靜音對話
取消靜音conversation_id取消對話靜音
封鎖或解除封鎖contact_id,須為 digits@lid 格式的 WhatsApp 標準 LID封鎖聯絡人及解除封鎖
查看封鎖名單回傳 data.blocklist 與清單指紋 data.dhash取得封鎖名單

靜音參數 duration: 0 代表永久靜音,不是關閉靜音。要恢復通知,應呼叫取消靜音操作。

顯示按鈕前,先查閱平台操作支援矩陣。現行文件將封鎖、解除封鎖及封鎖名單查詢對應到 WhatsApp;靜音支援 WhatsApp,LINE 為部分支援,取消靜音也對應到 LINE。統一路由不代表每個平台行為相同;不支援的組合會回傳 501 unsupported_by_provider。

不要自行拼造封鎖識別碼

WhatsApp 封鎖及解除封鎖操作不接受電話號碼或 @s.whatsapp.net JID 作為標準 LID 的替代品。應循文件記載的聯絡人流程取得實際識別碼,不可在電話號碼後加上 @lid 就認定是同一個人。

聯絡人回應可能包含不同的 id、provider_user_id 及 conversation_id,儲存時須保留各自含義。聯絡人 API 與 vCard 指南亦解釋了更新通訊錄與傳送聯絡人資料為何是不同操作。本文並非要求你為了封鎖某人,先將對方加入聯絡人。

先設計收件箱決策,再呼叫接口

假設客服佇列持續收到重複訊息:如果內容仍需審閱,靜音可以處理通知干擾,本地暫停狀態可以阻止不適當的 AI 回覆。如果有權限的同事決定封鎖聯絡人,應將它視為另一項明確變更。

建議採用以下流程:

  1. 清楚命名。 分開顯示「靜音通知」「封鎖聯絡人」及「暫停自動回覆」,並限定所選訊息帳戶與目標。
  2. 確認身份。 封鎖須使用與該帳戶相關、已核實的標準 LID。身份不明時交由人工審閱,不要猜測。
  3. 本地記錄意圖。 保存操作者、原因、目標及所要求的操作。這些是應用程式審計記錄,不是額外加入 API 請求的欄位。
  4. 檢查結果。 文件中的變更回應包含 data.ok。不能只因按鈕被按下就顯示成功;保留已遮蔽敏感資料的錯誤及 request_id 供排查。
  5. 核對不確定結果。 封鎖或解除封鎖請求逾時後,先查閱名單,再考慮下一次變更。按一致規則比較識別碼;dhash 可指出清單有變,但不能交代誰修改、為何修改。
  6. 另外處理排隊中的自動化。 決策前建立的工作可能仍在資料庫內。傳送前讓背景工作檢查本地暫停政策,不能把平台設定當作自己的佇列取消機制。

靜音變更方面,事件參考記載了 conversation.updated,以及 muted、mute_until 等設定。收到事件時可作為狀態觀察,但不要承諾每次操作都會有確認事件。公開目錄沒有記載聯絡人封鎖事件,應使用文件中的封鎖名單查詢,不要自行假設事件存在。

驗收檢查與限制

使用自己控制的帳戶測試:介面應區分變更失敗與已生效;取消靜音不能呼叫解除封鎖;解除封鎖不能自動放行舊回覆工作。亦應測試識別碼被拒絕、請求逾時後結果不明等情況。這些是建議測試,並非已完成的測試結果。

不要以靜音控制 webhook 流量。靜音端點改變對話狀態,文件沒有說它會關閉事件投遞。同樣,本文不承諾封鎖會刪除已儲存內容、管理共同群組,或取消 CRM 工作,這些均須另外定義。

如果原生應用程式的人手操作已足夠,直接使用原生控制即可。如果需要官方商業整合,應獨立評估其契約,不要將這些 UnifyPort 路由當成 WhatsApp 官方端點。

常見問題

靜音聊天會停止自動回覆嗎?

不能如此假設。應由回覆工作檢查明確的本地暫停狀態;文件沒有將靜音定義為取消工作操作。

可以用電話號碼 JID 封鎖聯絡人嗎?

UnifyPort 的 WhatsApp 封鎖操作不接受。必須使用標準 digits@lid,而非電話號碼或 @s.whatsapp.net 值。

解除封鎖後會補收期間的訊息嗎?

不會。WhatsApp 官方說明指出不會補收,所以不要將封鎖當作可復原的訊息緩衝區。

dhash 改變能證明我的操作成功嗎?

不能單獨證明。它是整份名單的指紋,應檢查目標聯絡人是否存在,並另外保存操作結果。

下一步與參考資料

先閱讀封鎖聯絡人參考,確認識別碼對應後,再於共享收件箱啟用控制。

核對日期:2026-09-25。

UnifyPort API

令訊息接入變成一條穩定嘅產品管線。

先用統一嘅 API 跑通發送,再用標準事件將所有入站訊息接返去業務系統。