摘要
如果您在 Wati 中使用多個 WhatsApp 號碼,您可以設定 Webhook,透過單一的 Webhook 設定來接收來自一個或多個號碼的事件。
您也可以在支援的情況下,使用 Webhook 負載(payload)中的 channelPhoneNumber 和 channelId 欄位來識別觸發事件的 WhatsApp 號碼。
本指南說明如何為多個 WhatsApp 號碼設定 Webhook、如何使用 API 為個別號碼設定 Webhook,以及如何識別與每個 Webhook 事件相關聯的號碼。
操作說明
為多個 WhatsApp 號碼設定 Webhook
請按照下列步驟為多個 WhatsApp 號碼設定 Webhook:
登入您的 Wati 帳戶,前往連接器 (Connectors) > Webhook。
點擊新增 Webhook (Add Webhook)。

選取您要接收 Webhook 事件的一個或多個 WhatsApp 號碼。
選取您要追蹤的事件,例如訊息已接收 (Message Received) 和對話已分配 (Chat Assigned)。

點擊儲存 (Save) 以啟用所選號碼的 Webhook 設定。
使用 API 為個別 WhatsApp 號碼設定 Webhook
您也可以使用 Wati API 為個別 WhatsApp 號碼設定 Webhook。
請使用以下 API 端點:
POST /{tenantId}/api/v2/webhookEndpoints在您的 API 請求中加入
phoneNumber參數,以指定您要設定 Webhook 的 WhatsApp 號碼。
請將 {tenantId} 替換為您的 Wati 租戶 ID (tenant ID)。
識別觸發 Webhook 事件的 WhatsApp 號碼
當您收到 Webhook 事件時,可以使用負載中的下列欄位來識別與其相關聯的 WhatsApp 號碼:
channelPhoneNumber: 包含與事件相關聯的 WhatsApp 電話號碼(在支援的情況下)。channelId: 識別與事件相關聯的 WhatsApp 頻道。此欄位對於預設的 WhatsApp 號碼會回傳null。
何時會提供 channelPhoneNumber?
並非所有 Webhook 事件都會包含 channelPhoneNumber 欄位。其可用性取決於事件類型以及 Webhook 的設定方式。
訊息與範本事件: 這些事件的負載中會提供此欄位。
WABA 層級事件: 此欄位不可用。
範本失敗事件 (Template Failed): 僅當 Webhook 是針對特定 WhatsApp 號碼設定時,才會包含此欄位。如果 Webhook 是在 WhatsApp Business Account (WABA) 層級設定的,則負載中不會包含此欄位。
限制
付款已捕獲 (Payment Captured) 事件不支援多個 WhatsApp 號碼。它僅適用於預設的 WhatsApp 號碼。
常見問題 (FAQs)
Webhook 設定
1. 我可以在 Wati 中為多個 WhatsApp 號碼設定 Webhook 嗎?
可以。您可以從 Wati 帳戶的 Webhook 設定中為一個或多個 WhatsApp 號碼設定 Webhook。請選取您要追蹤的 WhatsApp 號碼及事件類型。
2. 我可以使用 Wati API 為個別 WhatsApp 號碼設定 Webhook 嗎?
可以。請使用以下 API 端點為個別 WhatsApp 號碼設定 Webhook:
POST /{tenantId}/api/v2/webhookEndpoints
加入 phoneNumber 參數以指定您要設定 Webhook 的 WhatsApp 號碼。
Webhook 負載欄位
3. 我該如何識別哪個 WhatsApp 號碼觸發了 Webhook 事件?
在支援的情況下,使用 Webhook 負載中的 channelPhoneNumber 和 channelId 欄位。
channelPhoneNumber:識別與事件相關聯的 WhatsApp 電話號碼。channelId:識別 WhatsApp 頻道。此欄位對於預設的 WhatsApp 號碼會回傳null。
4. channelPhoneNumber 欄位適用於所有 Webhook 事件嗎?
不是。channelPhoneNumber 欄位適用於訊息和範本事件,但不包含在 WABA 層級事件中。
對於範本失敗 (Template Failed) 事件,僅在為特定 WhatsApp 號碼設定 Webhook 時才會包含此欄位。當 Webhook 在 WABA 層級設定時,則不包含此欄位。
支援的 Webhook 事件
5. 「付款已捕獲」事件是否支援多個 WhatsApp 號碼?
不支援。付款已捕獲 (Payment Captured) 事件僅適用於預設的 WhatsApp 號碼,不支援多個 WhatsApp 號碼。
Did this answer your question?