Wati API

Wati API：整合 WhatsApp、Instagram 與您的 AI 助理的單一 API。

Q: 如何取得 API 金鑰？

前往 live.wati.io/start/api 註冊，接著在 Wati 中開啟開發人員主控台，並建立僅包含您所需範圍的 API token。該 token 僅會顯示一次，因此請將其儲存在您的伺服器上，切勿儲存在瀏覽器或行動應用程式中。

Q: API 速率限制為何？

在所有方案中，聯絡人和訊息歷史記錄呼叫皆限制為每 10 秒 10 個請求。範本發送在成長版、專業版和商業版中分別限制為每 10 秒 30、60 或 100 個請求。當您達到限制時，將會收到帶有 Retry-After 標頭的 HTTP 429 回應。若需更高的限制，請聯絡 Wati。

從您自己的產品在 WhatsApp 和 Instagram 上向客戶發送訊息，或透過 Wati MCP 伺服器讓 AI 助理代勞。

通道

WhatsApp
Instagram
AI 助理 (MCP)
TikTok 即將推出
Messenger 即將推出

免費開始使用聯絡我們

最後更新於 2026年10月29日

16,000+家來自 190+ 個國家的企業
4.6/5G2 平均評分
官方Meta 業務夥伴與 WhatsApp BSP

單一 API。WhatsApp、Instagram 和您的 AI 助理。

在客戶已經使用的應用程式上接觸他們。將其建構到您的程式碼中，或交給 AI 助理處理。

兩個通道已上線目前支援 WhatsApp 與 Instagram。TikTok 與 Messenger 即將推出。
程式碼或無程式碼從您的產品呼叫 REST API，或透過 MCP 伺服器連接 AI 助理。
您的團隊隨時掌握狀況對話會顯示在 Wati 團隊收件匣中，以便真人隨時介入。

通道

Wati API 涵蓋的內容

兩個訊息通道與一個用於 AI 助理的 MCP 伺服器現已上線。TikTok 與 Messenger 即將推出。

線上
WhatsApp
向一位或一萬名客戶發送已審核的範本、在聊天中回覆、啟動聊天機器人並取得 webhooks。
WhatsApp API
線上
Instagram
使用 REST API 公開或私下回覆留言。透過 MCP 伺服器回答私訊。
Instagram API
線上
AI 助理 (MCP)
使用 OAuth 連接 AI 助理。以日常英文要求發送範本、回覆聊天並更新聯絡人。
MCP 伺服器
即將推出
TikTok
在同一個 Wati API 中的 TikTok 對話。
即將推出
Messenger
在同一個 Wati API 中的 Messenger 對話。AI 助理已經可以透過 MCP 伺服器用文字回覆。

探索

選擇適合您需求的 API

涵蓋範圍

各渠道支援功能

目前透過 Wati API 在各渠道上可執行的操作，已與公開說明文件進行核對。

依渠道區分的 Wati API 功能
功能	WhatsApp	Instagram	Messenger	TikTok
使用已核准的範本對單一或最多 10,000 位使用者發起對話	REST API 與 MCP	–	即將推出AI 代理已可透過 MCP 以文字回覆。	即將推出
在開放的對話中回覆	文字、多媒體與按鈕。REST API 與 MCP	MCP私訊文字回覆
公開或私下回覆留言	–	REST API 與 MCP
取得新訊息與傳送狀態的 Webhook	REST API	–
為聯絡人啟動 Wati 聊天機器人	REST API、專業版與企業版方案	–

REST API：使用 API 金鑰從您的程式碼呼叫。MCP：AI 助理透過 Wati MCP 伺服器為您執行。–：目前 API 尚不支援。完整清單請參見API 參考文件。

開始使用

三個步驟即可上線。

註冊
建立您的帳戶
在 API 註冊頁面上註冊 Wati，然後連結您的 WhatsApp 號碼或 Instagram 帳戶。
取得金鑰
開啟開發者主控台
建立 API 通行權杖，並僅授與您需要的範圍。請將其保存在您的伺服器上。
傳送
傳送您的第一個要求
只要一個呼叫即可傳送已核准的範本。已送達與已讀的更新將透過 webhook 接收。

POST/api/ext/v3/messageTemplates/send

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "order_update",
    "broadcast_name": "my_first_call",
    "recipients": [{ "phone_number": "14155552671",
      "custom_params": [{ "name": "name", "value": "Maya" }] }]
  }'

使用 Meta 已在您的帳戶中核准的範本名稱。更多範例請參閱 WhatsApp API 頁面。

POST/api/ext/v3/comments/{comment_id}/privateReply

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand", "userId": "17841400000000000", "userName": "maya",
    "type": "text", "text": "Hi Maya, yes we do."
  }'

從貼文的留言清單中取得留言 ID 和留言者的詳細資料。更多資訊請參閱 Instagram API 頁面。

安全性與限制

預設安全。限制公開。

24 小時視窗

WhatsApp 優先使用範本

自由格式回覆需要開啟 24 小時的客戶服務視窗。在此視窗之外，請從 Meta 已核准的範本開始。

OAuth 用於 MCP

您的 AI 工具中沒有金鑰

AI 用戶端會在瀏覽器中登入 Wati MCP 伺服器。您不需要將 API 金鑰貼到工具中。

已設定範圍的權杖

僅限您授予的存取權

每個 API 通行權杖都包含您選擇的範圍，並且可以設定到期日。它只會顯示一次，因此請將其保存在您的伺服器上。

每 10 秒 30 到 100 次

範本傳送

視您的方案而定。如果請求過快，您將收到帶有 Retry-After 標頭的 HTTP 429。

速率限制與方案可用性詳細資訊

按方案記錄的速率限制
端點	Growth	Pro	Business
`/addContact`, `/getContacts`	10 / 10 s	10 / 10 s	10 / 10 s
`/getMessages`	10 / 10 s	10 / 10 s	10 / 10 s
`/sendTemplateMessage`	30 / 10 s	60 / 10 s	100 / 10 s
`/sendTemplateMessages`	30 / 10 s	60 / 10 s	100 / 10 s

限制如 Errors & Rate Limits 上所公布。核心訊息、範本與聯絡人端點適用於所有方案。團隊指派、對話狀態、聊天機器人和自訂區隔需要 Pro 或 Business 方案。各方案的端點可用性。若需要更高的限制，請與 Wati 討論您的使用情境。

常見問題

常見詢問

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

什麼是 Wati API？

Wati API 讓您的產品能夠透過 Wati 發送與接收客戶訊息。目前支援 WhatsApp 與 Instagram，並提供 MCP 伺服器，讓 AI 助理能夠透過聊天執行相同的工作。您的團隊可以在 Wati 團隊收件匣中追蹤每一個對話。

Wati API 支援哪些管道？

WhatsApp 與 Instagram。在 WhatsApp 上，您可以發送已核准的範本、在聊天中回覆、啟動聊天機器人以及接收 webhooks。在 Instagram 上，REST API 涵蓋了留言功能：列出貼文與留言、公開回覆以及發送私人回覆。Instagram DMs 則透過 Wati MCP 伺服器運作。

TikTok 與 Messenger 即將推出。

是否支援 TikTok 或 Messenger？

目前 API 尚未支援，但兩者皆即將推出。連線至 Wati MCP 伺服器的 AI 代理在登入 Wati 帳戶後，已經可以使用文字回覆 Messenger 聊天。

我需要寫程式嗎？

不需要。只要連接支援遠端 MCP 的 AI 助理，透過 OAuth 登入並以日常語言提問（例如列出您的範本或回覆聊天）。

如果您偏好寫程式，REST API 使用單一基礎 URL 與 bearer token，AI 應用程式建構工具可以為您編寫呼叫程式碼。

說明文件在哪裡？

完整的參考文件公開於 docs.wati.io：包含 API 參考、MCP 伺服器指南、速率限制以及各方案的端點可用性。AI 程式碼編寫工具可以在 docs.wati.io/llms.txt 讀取完整索引。

如何取得 API 金鑰？

前往 live.wati.io/start/api 註冊，接著在 Wati 中開啟開發人員主控台（Developer Console），並建立僅包含您所需範圍的 API token。該 token 僅會顯示一次，因此請將其儲存在您的伺服器上，切勿儲存在瀏覽器或行動應用程式中。

此頁面與 WhatsApp API 頁面有何不同？

此頁面是所有 Wati API 的總覽：包含各管道、各功能運作方式以及如何開始。WhatsApp API 頁面則更深入探討 WhatsApp，包含各個端點群組、多種語言的程式碼範例以及完整限制。

API 速率限制為何？

在所有方案中，聯絡人和訊息歷史記錄呼叫皆限制為每 10 秒 10 個請求。範本發送在成長版（Growth）、專業版（Pro）和商業版（Business）中分別限制為每 10 秒 30、60 或 100 個請求。當您達到限制時，將會收到帶有 Retry-After 標頭的 HTTP 429 回應。若需更高的限制，請聯絡 Wati。