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。

• WhatsApp：聊天通知靜音與取消靜音
• WhatsApp：封鎖與檢舉聯絡人
• UnifyPort：平台操作支援
• UnifyPort：封鎖名單回應