您的程式碼來回答。
訊息 Webhook 會將每則新訊息傳送到您的伺服器。透過傳送端點回覆,或在 Pro 與 Business 方案上啟動 Wati 聊天機器人。
WhatsApp 自動回覆與聊天機器人 API
當客戶傳送訊息時,Wati 會將訊息 Webhook 傳送至您的伺服器。您的程式碼可傳送回覆,或為該聯絡人啟動其中一個 Wati 聊天機器人。
屬於 WhatsApp 開發者 API 的一部分。
最後更新於
關鍵字規則、您選擇的模型或訂單系統中的查詢。Wati 雙向傳遞訊息。
訊息 Webhook 會將每則新訊息傳送到您的伺服器。透過傳送端點回覆,或在 Pro 與 Business 方案上啟動 Wati 聊天機器人。
挑選核准的範本並傳送給多達 10,000 位收件者。每個人都會獲得專屬的變數,且每筆發送結果皆可透過編號追蹤。
在 24 小時的視窗內,傳送文字、圖片、檔案、回覆按鈕與清單選擇器,並在您處理時顯示正在輸入的提示。
當狀態有任何變更時,您的商店、預約或計費系統會發送經核准的範本。客戶只需點擊按鈕或回覆即可。
Webhooks 會將新訊息、已讀回條、點擊和失敗記錄推送到您的 URL。無需輪詢。
回覆將統一收在 Wati 團隊收件匣中。透過 API 指派客服人員、設定狀態並新增標籤,確保由對的人來處理。
使用自訂屬性建立和更新聯絡人,並在傳送訊息前預覽客群區隔。
列出您貼文上的留言、公開回覆或發送私人回覆。
透過 Wati 內的 Meta 嵌入式註冊連結您的 WhatsApp 號碼。
在 Wati 中建立 API token,並僅授予您需要的權限範圍。請將其保存在您的伺服器上。
透過單一請求發送已核准的範本。然後新增 webhook 以追蹤送達狀態。
以下說明一個請求包含的內容,以及各個部分在訊息中顯示的位置。
客戶的 WhatsApp 號碼,包含國碼。
phone_number14155552671Meta 已在您的帳號中核准的範本名稱。
template_nameorder_update範本中空白處的值,每人一個。
custom_paramsname = Mayaorder_id = 10482您的 API token,隨每個請求一同傳送。請將其保存在您的伺服器上。
Authorization: Bearer <token>200 表示 Wati 已接受該訊息,並附帶 broadcast_id。送達與已讀狀態隨後會透過 webhook 送達。
200broadcast_id訊息文字與 order_update 僅為範例。實際用詞由您核准的範本決定。
您正在回覆的評論。當您列出貼文的評論時即可取得其 ID。
comment_id位於 URL 路徑中您連線至 Wati 的 Instagram 帳號。
channel撰寫該評論的人,取自同一則評論。
userIduserName長度不超過 1,000 個字元的純文字,或帶有按鈕的範本。
type = texttexttype = template200 且 ok 設為 true 表示私訊回覆已成功送出。請使用與其他所有呼叫相同的 Authorization 標頭。
ok: trueresult: successPOST /api/ext/v3/comments/{comment_id}/privateReply。評論和回覆文字僅為範例。 請參閱說明文件中的請求說明
透過 Meta 的嵌入式註冊 (Embedded Signup) 連線。WhatsApp Business 帳號將直接註冊至您的企業。
審核、品質與類別變更將透過 webhook 接收,讓您在發送失敗前就能掌握狀況。
最多重試 144 次,每 10 分鐘一次。若您的端點持續失敗,Wati 將會寄發電子郵件通知您。
若發送速度過快,您將收到帶有 Retry-After 標頭的 429 回應。已被接受的訊息將會在佇列中等候處理。
提供共用的團隊收件匣,供您的程式碼不應獨自處理的對話使用。
v3 支援範圍限定的權杖 (scoped tokens),確保每個整合僅能取得其所需的存取權限。
透過單一呼叫即可排定稍後發送範本。Wati 將會準時發送。
在發送任何訊息之前,先預估廣播的預期成本。
透過已核准的範本立即或排程發起對話。
說明文件 →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 小帳 (DM) 與 Messenger 聊天訊息。
亦提供多個事件的 BSUID 版本。Webhook 說明文件
發送範本的呼叫次數,取決於您的方案(Growth、Pro 或 Business)。
單一範本最多可發送給 10,000 人,每個人皆可擁有各自的變數。
文字、多媒體與按鈕需要開啟中的客服視窗。若超出此視窗,請改發送範本。
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 秒 |
限制如 錯誤與速率限制 (Errors & Rate Limits) 中所公佈,依端點名稱列出。v1 批次呼叫最多可處理 1,000 個聯絡人。核心訊息、範本與聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人與自訂客群需要 Pro 或 Business 方案。一次更新多個聯絡人的屬性則需要 Business 方案。各方案的端點可用性。若需要更高的限制,請與 Wati 聯繫並說明您的使用情境。
是的,透過兩種方式。Wati 會透過 message webhook 將每個收到的訊息發送到您的 URL,而您的程式碼則透過訊息端點回覆。或者,在專業版 (Pro) 和企業版 (Business) 方案中,POST /chatbots/start 可以為聯絡人啟動您在 Wati 中建立的聊天機器人。這裡沒有單一的自動回覆端點:您的程式碼或 Wati 聊天機器人將決定要回覆什麼內容。
使用 GET /chatbots 列出您的聊天機器人,然後帶入聯絡人與 chatbot_id 呼叫 POST /chatbots/start。當流程已經在 Wati 中建立好、且您的程式碼僅需決定何時執行時,即可使用此功能。chatbotTriggered webhook 會通知您聊天機器人何時執行。兩個端點都需要專業版或企業版方案。
可以。您的程式碼會在 webhook 中接收訊息文字,並可將其傳遞給您選擇的任何模型或服務,然後使用文字或互動端點發送答案。自由格式的回覆可在 24 小時視窗內運作,此視窗是由於客戶剛才向您傳送訊息而開啟的。
比過去的需求少。AI 應用程式建構器可以根據簡單的英文指示來編寫 API 呼叫,而本頁面上的範例也展示了每次呼叫。
在開始對話之前,您仍然需要一個連接到 Wati 的 WhatsApp 號碼、一個 API 金鑰,以及經 Meta 批准的範本。如果 AI 工具編寫了程式碼,請確認您的金鑰保留在伺服器上。
在所有方案中,聯絡人和訊息記錄呼叫均限制為每 10 秒 10 次請求。成長版 (Growth) 的範本發送限制為每 10 秒 30 次請求,專業版為 60 次,企業版則為 100 次。當您達到限制時,將會收到帶有 Retry-After 標頭的 HTTP 429 回應。若需要更高的限制,請聯絡 Wati。
在 WhatsApp 上,自由格式的文字、媒體和互動訊息需要開放的 24 小時客服視窗。若在該視窗之外,請使用經 Meta 批准的範本來開始對話。
Business 應用程式適用於手機上的手動聊天,最多支援 5 個連結裝置,且廣播清單上限為 256 個聯絡人。API 則將 WhatsApp 連接到您自己的系統。您可以大批次發送已批准的範本、自動化回覆、接收 webhooks,並在團隊收件匣中共用一個號碼。
核心訊息傳遞、範本和聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人和自訂區隔則需要專業版或企業版。說明文件列出了各方案對應的端點可用性。