🚀 Get TikTok DMs and Ads in Wati Team Inbox and convert social engagement into revenue See TikTok on Wati🚀 TikTok DMs + Ads now in Team Inbox →

WhatsApp 自動回覆與聊天機器人 API

WhatsApp 聊天機器人 API:透過您的程式碼執行自動回覆。

當客戶傳送訊息時,Wati 會將訊息 Webhook 傳送至您的伺服器。您的程式碼可傳送回覆,或為該聯絡人啟動其中一個 Wati 聊天機器人。

最後更新於

  • 16,000+家來自 190+ 個國家的企業
  • 4.6/5G2 上的平均評分
  • 官方Meta 商業夥伴與 WhatsApp BSP
G2 聊天機器人領導者G2 中型市場聊天機器人領導者G2 聊天機器人動能領導者G2 最易實施 WhatsApp 行銷獎ISO 27001GDPR

一個 Webhook。您的程式碼來回覆。

關鍵字規則、您選擇的模型或訂單系統中的查詢。Wati 雙向傳遞訊息。

  • 以範本開始已核准的範本可為單一或 10,000 名客戶開啟對話。
  • 在聊天中持續客戶回覆後可傳送文字、多媒體與按鈕。
  • 由您的團隊結束Webhook 會通知您的程式碼。團隊收件匣則通知您的工作人員。
產品特色

發送。回覆。傾聽。交辦。

自動回覆與聊天機器人

您的程式碼來回答。

訊息 Webhook 會將每則新訊息傳送到您的伺服器。透過傳送端點回覆,或在 Pro 與 Business 方案上啟動 Wati 聊天機器人。

廣播訊息

個人化訊息,大規模發送。

挑選核准的範本並傳送給多達 10,000 位收件者。每個人都會獲得專屬的變數,且每筆發送結果皆可透過編號追蹤。

即時通訊

回覆不限於文字。

在 24 小時的視窗內,傳送文字、圖片、檔案、回覆按鈕與清單選擇器,並在您處理時顯示正在輸入的提示。

訂單更新與通知

在對的時間,發送對的更新。

當狀態有任何變更時,您的商店、預約或計費系統會發送經核准的範本。客戶只需點擊按鈕或回覆即可。

Webhooks

每一則回覆,即時送達。

Webhooks 會將新訊息、已讀回條、點擊和失敗記錄推送到您的 URL。無需輪詢。

團隊收件匣

程式碼啟動,真人完成。

回覆將統一收在 Wati 團隊收件匣中。透過 API 指派客服人員、設定狀態並新增標籤,確保由對的人來處理。

聯絡人與客群區隔

您的 CRM,在 Wati 中完美鏡像。

使用自訂屬性建立和更新聯絡人,並在傳送訊息前預覽客群區隔。

InstagramInstagram 留言與私訊

建立 Instagram 自動化功能。

列出您貼文上的留言、公開回覆或發送私人回覆。

開始使用

三個步驟即可上線。

  1. 連線

    連線您的號碼

    透過 Wati 內的 Meta 嵌入式註冊連結您的 WhatsApp 號碼。

  2. 驗證

    取得 token

    在 Wati 中建立 API token,並僅授予您需要的權限範圍。請將其保存在您的伺服器上。

  3. 傳送

    發送您的第一個呼叫

    透過單一請求發送已核准的範本。然後新增 webhook 以追蹤送達狀態。

您的第一個請求解析

以下說明一個請求包含的內容,以及各個部分在訊息中顯示的位置。

  1. 對象

    客戶的 WhatsApp 號碼,包含國碼。

    phone_number14155552671
  2. 訊息內容

    Meta 已在您的帳號中核准的範本名稱。

    template_nameorder_update
  3. 填入內容

    範本中空白處的值,每人一個。

    custom_paramsname = Mayaorder_id = 10482
  4. 您的金鑰

    您的 API token,隨每個請求一同傳送。請將其保存在您的伺服器上。

    Authorization: Bearer <token>
  5. 您獲得的返回結果

    200 表示 Wati 已接受該訊息,並附帶 broadcast_id。送達與已讀狀態隨後會透過 webhook 送達。

    200broadcast_id

訊息文字與 order_update 僅為範例。實際用詞由您核准的範本決定。

隨用即複製的程式碼隱藏程式碼
WEBHOOK收到訊息事件,輸出 POST /api/ext/v3/conversations/messages/text
# 1. Wati 會將每則新訊息 POST 至您的 webhook 網址(事件:message)。
# 2. 您的程式碼會取得解答並傳回:
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "14155552671",
    "text": "是的,我們營業時間為上午 9 點至晚上 9 點。"
  }'
IN Wati 發送到您 URL 的內容文件範例欄位,已修剪
{  "eventType": "message",  "id": "69282478274a880fe782b2d9",  "conversationId": "68c8d56157578adb12ada249",  "waId": "14155552671",  "senderName": "Maya",  "type": "text",  "text": "Are you open tomorrow?",  "owner": false,  "timestamp": "1764238453"}
內建功能

Wati 為您處理好一切,免去您的繁瑣手續。

號碼上線

透過 Meta 的嵌入式註冊 (Embedded Signup) 連線。WhatsApp Business 帳號將直接註冊至您的企業。

範本狀態

審核、品質與類別變更將透過 webhook 接收,讓您在發送失敗前就能掌握狀況。

Webhook 重試

最多重試 144 次,每 10 分鐘一次。若您的端點持續失敗,Wati 將會寄發電子郵件通知您。

速率限制與排隊

若發送速度過快,您將收到帶有 Retry-After 標頭的 429 回應。已被接受的訊息將會在佇列中等候處理。

真人轉接

提供共用的團隊收件匣,供您的程式碼不應獨自處理的對話使用。

範圍限定的 API 權杖

v3 支援範圍限定的權杖 (scoped tokens),確保每個整合僅能取得其所需的存取權限。

排程發送

透過單一呼叫即可排定稍後發送範本。Wati 將會準時發送。

事先預估成本

在發送任何訊息之前,先預估廣播的預期成本。

技術核心

依功能分類的端點。

範本 (Templates)

透過已核准的範本立即或排程發起對話。

說明文件 →
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

廣播 (Broadcasts)

讀取行銷活動結果與各接收者的狀態,並事先預估成本。

說明文件 →
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

訊息傳遞 (Messaging)

在 24 小時視窗內使用文字、多媒體或按鈕回覆。

說明文件 →
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

聊天機器人 Pro+

列出您的 Wati 聊天機器人,並為聯絡人啟動機器人。

說明文件 →
GET/chatbotsPOST/chatbots/start

Webhooks

管理訂閱並列出您可以接收的事件類型。

說明文件 →
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

聯絡人與客群

從您的 CRM 同步聯絡人與屬性,然後針對特定客群進行鎖定。

說明文件 →
POST/contactsPUT/contactsPOST/segments/evaluate

團隊收件匣

指派客服人員、變更狀態、新增或移除標籤。

說明文件 →
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

列出貼文與留言、公開或私密回覆、檢查權限。

說明文件 →
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 聊天訊息。

查看全部 19 種 WhatsApp webhook 事件類型

訊息 (Messages)

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

送達狀態 (Delivery status)

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

範本與帳號 (Templates and account)

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

互動與通話 (Engagement and calls)

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

亦提供多個事件的 BSUID 版本。Webhook 說明文件

限制與方案

明確的限制。公開透明。

30 到 100 每 10 秒

範本發送

發送範本的呼叫次數,取決於您的方案(Growth、Pro 或 Business)。

10,000 位接收者

每次 v3 發送呼叫

單一範本最多可發送給 10,000 人,每個人皆可擁有各自的變數。

24 小時 視窗

自由格式回覆

文字、多媒體與按鈕需要開啟中的客服視窗。若超出此視窗,請改發送範本。

429 Retry-After

當發送速度過快時

Wati 會告知您需要等待的時間。被接受的訊息將會在佇列中進行處理。

詳細的速率限制與方案可用性
依方案劃分的文件化速率限制
端點GrowthProBusiness
/addContact, /getContacts10 / 10 秒10 / 10 秒10 / 10 秒
/getMessages10 / 10 秒10 / 10 秒10 / 10 秒
/sendTemplateMessage30 / 10 秒60 / 10 秒100 / 10 秒
/sendTemplateMessages30 / 10 秒60 / 10 秒100 / 10 秒

限制如 錯誤與速率限制 (Errors & Rate Limits) 中所公佈,依端點名稱列出。v1 批次呼叫最多可處理 1,000 個聯絡人。核心訊息、範本與聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人與自訂客群需要 Pro 或 Business 方案。一次更新多個聯絡人的屬性則需要 Business 方案。各方案的端點可用性。若需要更高的限制,請與 Wati 聯繫並說明您的使用情境。

常見問題

常見詢問

完整的 API 參考文件為公開內容。閱讀說明文件

Wati 是否提供 WhatsApp chatbot API?

是的,透過兩種方式。Wati 會透過 message webhook 將每個收到的訊息發送到您的 URL,而您的程式碼則透過訊息端點回覆。或者,在專業版 (Pro) 和企業版 (Business) 方案中,POST /chatbots/start 可以為聯絡人啟動您在 Wati 中建立的聊天機器人。這裡沒有單一的自動回覆端點:您的程式碼或 Wati 聊天機器人將決定要回覆什麼內容。

如何透過 API 啟動 Wati 聊天機器人?

使用 GET /chatbots 列出您的聊天機器人,然後帶入聯絡人與 chatbot_id 呼叫 POST /chatbots/start。當流程已經在 Wati 中建立好、且您的程式碼僅需決定何時執行時,即可使用此功能。chatbotTriggered webhook 會通知您聊天機器人何時執行。兩個端點都需要專業版或企業版方案。

我可以使用 AI 模型來撰寫回覆嗎?

可以。您的程式碼會在 webhook 中接收訊息文字,並可將其傳遞給您選擇的任何模型或服務,然後使用文字或互動端點發送答案。自由格式的回覆可在 24 小時視窗內運作,此視窗是由於客戶剛才向您傳送訊息而開啟的。

我需要懂寫程式嗎?

比過去的需求少。AI 應用程式建構器可以根據簡單的英文指示來編寫 API 呼叫,而本頁面上的範例也展示了每次呼叫。

在開始對話之前,您仍然需要一個連接到 Wati 的 WhatsApp 號碼、一個 API 金鑰,以及經 Meta 批准的範本。如果 AI 工具編寫了程式碼,請確認您的金鑰保留在伺服器上。

API 的速率限制是什麼?

在所有方案中,聯絡人和訊息記錄呼叫均限制為每 10 秒 10 次請求。成長版 (Growth) 的範本發送限制為每 10 秒 30 次請求,專業版為 60 次,企業版則為 100 次。當您達到限制時,將會收到帶有 Retry-After 標頭的 HTTP 429 回應。若需要更高的限制,請聯絡 Wati。

我可以隨時向客戶傳送訊息嗎?

在 WhatsApp 上,自由格式的文字、媒體和互動訊息需要開放的 24 小時客服視窗。若在該視窗之外,請使用經 Meta 批准的範本來開始對話。

WhatsApp Business 應用程式與 API 有什麼區別?

Business 應用程式適用於手機上的手動聊天,最多支援 5 個連結裝置,且廣播清單上限為 256 個聯絡人。API 則將 WhatsApp 連接到您自己的系統。您可以大批次發送已批准的範本、自動化回覆、接收 webhooks,並在團隊收件匣中共用一個號碼。

哪些端點適用於我的方案?

核心訊息傳遞、範本和聯絡人端點適用於所有方案。團隊指派、聊天狀態、聊天機器人和自訂區隔則需要專業版或企業版。說明文件列出了各方案對應的端點可用性。

您的第一則訊息距離您只有一次請求之遙。

免費開始使用,在 Wati 中連結您的 WhatsApp 號碼並進行您的第一次呼叫。