群發訊息
個人化訊息，大規模發送。
選擇核准的範本並傳送給最多 10,000 位收件者。每個人都會獲得專屬變數，且每個結果都會依號碼回傳。
WhatsApp 廣播 API每次 API 呼叫即可向最多 10,000 位客戶發送單一範本。
一個請求即可向最多 10,000 人發送已核准的範本，每個人皆有其專屬詳細資訊。進行排程、預先估算成本，然後讀取每位收件者的結果。
偏好無程式碼？從 Wati 發送 WhatsApp 廣播。
- 16,000+來自 190+ 個國家的企業
- 4.6/5G2 上的平均評分
- 官方Meta 商業夥伴與 WhatsApp BSP
單一請求。最多 10,000 位客戶。
每個人都能取得專屬姓名、訂單或日期。每個結果皆按編號回傳。
- 從範本開始已核准的範本可開啟對話，適用於單一客戶或每次呼叫最多 10,000 位客戶。
- 在對話或通話中繼續客戶回覆後可使用文字、媒體和按鈕，或在同一個執行緒中進行語音通話。
- 以您的團隊結尾Webhook 會通知您的程式碼。團隊收件匣會通知您的團隊成員。
產品
發送。回覆。收到回音。轉交處理。
訊息傳遞
回覆不只是文字。
在 24 小時視窗內，發送文字、圖片、檔案、回覆按鈕和清單選擇器，並在您工作時計有輸入指示器。
訂單更新與警示
適時提供正確的更新。
當有變更時，您的商店、預約或帳單系統會傳送核准的範本。客戶只需點擊按鈕或回覆即可。
自動回覆與聊天機器人
由您的程式碼來回答。
訊息 Webhook 會將每個新訊息帶到您的伺服器。使用發送端點回覆，或在 Pro 和 Business 方案上啟動 Wati 聊天機器人。
Webhooks
每次回覆，都在送達的瞬間。
Webhooks 會將新訊息、已讀回條、點擊和失敗推送到您的 URL。無需輪詢。
團隊收件匣
程式碼開始，由真人完成。
回覆會落入 Wati 團隊收件匣中。透過 API 指派操作人員、設定狀態並新增標籤，確保由對的人來接手。
聯絡人與區隔
您的 CRM，在 Wati 中鏡像呈現。
使用自訂屬性建立和更新聯絡人，然後在傳送訊息前預覽區隔。
InstagramInstagram 留言
也建立 Instagram 自動化。
列出貼文上的留言、公開回覆或傳送私密回覆。Instagram DMs 同樣適用：透過 REST 或透過 Wati MCP 伺服器回覆進行中的對話。
開始使用
三個步驟即可上線。
- 連線
連線您的號碼
透過 Wati 內的 Meta 嵌入式註冊來連結您的 WhatsApp 號碼。
- 驗證
取得 token
在 Wati 中建立 API token，並僅授予您需要的權限範圍。請將其保存在您的伺服器上。
- 傳送
發出您的第一個呼叫
透過一個請求傳送已核准的範本。然後新增 webhook 以追蹤傳送狀態。
您的第一個請求解析
以下說明一個請求包含哪些內容，以及各個部分在訊息中顯示的位置。
內建功能
Wati 已為您處理好這些大小事。
號碼註冊上線
透過 Meta 的嵌入式註冊 (Embedded Signup) 進行連線。WhatsApp Business 帳戶將會註冊至您的企業。
範本狀態
核准、品質與類別變更將會以 Webhook 形式傳送，讓您在發送失敗前就能掌握狀況。
Webhook 重試機制
最多可重試 144 次，每 10 分鐘一次。如果您的端點持續失敗，Wati 將會寄發電子郵件通知您。
速率限制與佇列
若發送速度過快，將會收到帶有 Retry-After 標頭的 429 回應。已接受的訊息將會放入佇列中等候。
真人客服接手
提供共用的團隊收件匣，處理不應由您的程式碼獨自回答的對話。
具備範圍限制的 API 權杖
v3 支援具備範圍限制的權杖，確保每個整合都只能取得其所需的存取權限。
排程發送
只需透過一次呼叫，即可排程稍後發送範本。Wati 將會準時發送。
事先預估成本
在發送任何內容之前，先預估群發訊息的成本。
核心功能
依功能分類的端點。
群發呼叫包含的內容
| 欄位 | 必填 | 備註 |
|---|---|---|
template_name | 是 | 帳戶中已審核通過的範本。使用 GET /messageTemplates 列出它們。 |
broadcast_name | 是 | 您為此發送自訂的標籤 |
recipients | 是 | 1 到 10,000 人，每人皆須包含 phone_number |
custom_params | 依收件者而定 | 範本變數的名稱與數值配對 |
local_message_id | 否 | 您自己的 ID，會顯示在每個收件者的結果中 |
channel | 否 | 發送的號碼（透過名稱或號碼）。若省略則使用預設頻道。 |
來自 v3 發送端點結構。回應包含 success、broadcast_id 以及每個收件者的 errors。
範本
立即或排程使用已審核的範本開始對話。
說明文件 →GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule群發
讀取行銷活動結果與各收件者狀態，並預先估算費用。
說明文件 →GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost訊息傳遞
在 24 小時視窗內回覆文字、多媒體或按鈕。
說明文件 →POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator團隊收件匣
指派客服人員、變更狀態、新增或移除標籤。
說明文件 →PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags列出貼文與留言、公開或私密回覆、檢查權限。
說明文件 →GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions路徑相對於 https://live-mt-server.wati.io/api/ext/v3。建立 webhook 會使用舊版路徑 POST /{tenantId}/api/v2/webhookEndpoints。
對於 AI 代理，Wati MCP 伺服器涵蓋相同的 WhatsApp 動作，並能以文字回覆 Instagram DMs 與 Messenger 聊天訊息。
查看全部 19 種 WhatsApp webhook 事件類型
訊息
- message
- newContactMessageReceived
- sessionMessageSent_v2
- templateMessageSent_v2
送達狀態
- sentMessageDELIVERED_v2
- sentMessageREAD_v2
- sentMessageREPLIED_v2
- templateMessageFailed
範本與帳戶
- templateReviewed
- templateQualityUpdated
- templateCategoryUpdated
- wabaStatusReviewUpdate
- PhoneNumberQualityUpdatedEvent
- accountUpdated
- accountDeleted
- phoneNumberDeleted
互動與通話
- chatbotTriggered
- ctaUrlClicked
- call.status
僅限 WhatsApp 事件：目前尚無 Instagram webhook 事件。多個事件也提供 BSUID 版本。Webhook 說明文件
限制與方案
清晰的限制。公開透明。
30 至 100 每 10 秒
範本發送
呼叫以發送範本，取決於您的方案（Growth、Pro 或 Business）。
10,000 收件者
每次 v3 發送呼叫
一個範本，最多 10,000 人，每人擁有各自的變數。
24 小時 視窗
自由格式回覆
文字、多媒體與按鈕需要開放的客服視窗。若在此視窗外，請改發送範本。
429 Retry-After
當您的請求速度過快時
Wati 會告知您需要等待的時間。被接受的訊息將會在佇列中處理。
詳細的速率限制與方案可用性
| 端點 | Growth | Pro | Business |
|---|---|---|---|
/addContact, /getContacts | 10 / 10 秒 | 10 / 10 秒 | 10 / 10 秒 |
/getMessages | 10 / 10 秒 | 10 / 10 秒 | 10 / 10 秒 |
/sendTemplateMessage | 30 / 10 秒 | 60 / 10 秒 | 100 / 10 秒 |
/sendTemplateMessages | 30 / 10 秒 | 60 / 10 秒 | 100 / 10 秒 |
限制如 錯誤與速率限制 所示，依端點名稱列出。v1 批次呼叫最多可處理 1,000 個聯絡人。核心訊息、範本與聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人與自訂區隔需要 Pro 或 Business 方案。一次更新大量聯絡人的屬性需要 Business 方案。依方案的端點可用性。若需要更高的限制，請與 Wati 洽詢您的使用情境。
透過一次 Broadcast API 呼叫，我可以聯繫多少人？
每次 v3 傳送呼叫最多可發送給 10,000 位收件者。您會發送一個經過審核的範本，且每個收件者都可以有各自的變數，例如姓名或訂單編號。根據您的方案，範本發送限制為每 10 秒 30、60 或 100 次呼叫。您號碼的 Meta 訊息限制與範本品質依然適用，因此在大規模發送前，請先進行新號碼的暖機作業。
我可以預約廣播並在事先檢查費用嗎？
可以。POST /messageTemplates/schedule 會在您選擇的時間發送，而 POST /broadcasts/estimate-cost 會在發送前估算費用。
我要如何查看誰已接收並讀取了廣播？
呼叫 GET /broadcasts 來取得您的行銷活動，並呼叫 GET /broadcasts/{broadcast_id}/recipients 來取得個別收件者的狀態。若要取得即時更新，請訂閱 Webhooks，例如 sentMessageDELIVERED_v2、sentMessageREAD_v2 與 templateMessageFailed。
我要如何將結果與我自己的記錄進行比對？
為每個收件者提供一個 local_message_id，例如您的訂單編號。Wati 會在傳送呼叫的個別收件者結果中傳回它，並附帶該號碼發生的任何錯誤。
我可以選擇由哪一個 WhatsApp 號碼來發送廣播嗎？
可以。帶入包含發送號碼名稱或號碼的 channel。若不填寫，則會從您的預設頻道發送。
我需要具備寫程式的能力嗎？
比過去的需求低。AI 應用程式建構工具可以透過日常英文指令來撰寫 API 呼叫，而本頁面上的範例也展示了每次呼叫的方式。
在開始對話之前，您仍需要一個已連接至 Wati 的 WhatsApp 號碼、一個 API 權杖（Token），以及一個經過 Meta 審核通過的範本。如果 AI 工具寫了程式碼，請確認您的權杖有留在伺服器端。
API 的速率限制是什麼？
在所有方案中，聯絡人與訊息記錄呼叫均限制為每 10 秒 10 個請求。範本發送在 Growth、Pro 與 Business 方案中分別限制為每 10 秒 30、60 或 100 個請求。當您達到限制時，將會收到帶有 Retry-After 標頭的 HTTP 429。若需更高的限制，請聯絡 Wati。
我可以隨時向客戶傳送訊息嗎？
在 WhatsApp 上，自由格式的文字、多媒體與互動式訊息需要開啟 24 小時的客服視窗。在此視窗之外，請透過 Meta 審核通過的範本來開始對話。
WhatsApp Business 應用程式與 API 有什麼區別？
Business 應用程式適用於手機上的手動聊天，最多支援 5 個連結裝置，且廣播列表上限為 256 位聯絡人。API 則可將 WhatsApp 連接到您自己的系統。您可以大量發送經過審核的範本、自動回覆、接收 Webhooks，並在團隊收件匣中共用一個號碼。