摘要
透過 Wati CRM,您可以存取強大的 API 套件,協助您在 WhatsApp 上與客戶建立連結。無論您是想要發送訊息、管理聯絡人,或是將 Wati 與您自己的系統整合,本指南將引導您了解可用的 API、各方案的使用限制、限制重置的時間,以及如果需要更多配額時該怎麼做。
操作說明
什麼是 Wati API?
Wati API 是讓您透過 Wati 帳戶與 WhatsApp 互動的工具。它們旨在協助您:
檢索和發送訊息
管理客戶聯絡人清單
與您自己的應用程式和系統連接
您可以使用這些 API 來自動化工作流程、與 CRM 或支援工具整合,並改善客戶溝通。
提示:若要測試和探索這些 API,我們建議您查看 Wati API 文件。
各方案的 API 使用限制為何?
每個 Wati 方案都有不同的每月 API 呼叫配額:
Growth 方案:10,000 次 API 呼叫
Pro 方案:200,000 次 API 呼叫
Business 方案:2,000 萬次 API 呼叫
這些限制有助於確保所有使用者都能獲得公平的使用體驗與一致的效能。
API 限制何時重置?
API 使用限制會在每月 1 號重置。
未使用的配額不會結轉至下個月。
注意:如果您未用完配額,剩餘的呼叫次數將於月底失效。
API 存取包含哪些內容?
上述的使用限制僅適用於開發人員 API,例如用於發送訊息、管理聯絡人和檢索對話的 API。
注意:目前支付 API 沒有使用限制。
這意味著您可以自由使用與支付相關的 API,無需擔心每月上限,同時仍需根據您的方案管理開發人員 API 的使用量。
如果我需要更多 API 呼叫次數怎麼辦?
如果您使用的是 Business 方案,您可以透過增加 API 配額附加元件來要求更高的限制。
注意:只有 Business 方案的客戶才有資格要求更高的 API 限制。如果您使用的是 Growth 或 Pro 方案,您需要升級到 Business 方案才能增加 API 限制。
若要要求附加元件或討論您的需求,請聯絡我們的支援團隊。
API 使用限制與 API 速率限制的區別
API 速率限制與API 使用限制分別控制 API 使用方式的不同面向。
API 速率限制用於限制您在特定時間視窗內呼叫 API 端點的頻率。
如果超過 API 速率限制會怎樣?
如果您超過 API 速率限制,Wati 可能會回傳 HTTP 429 (請求過多) 錯誤。這表示您的請求已暫時被拒絕。
當您超過請求速率限制、API 使用配額或特定功能限制時,可能會出現 429 錯誤。
如果回應包含 Retry-After 標頭,請檢查其值以確定在重試請求前應等待多久。
重要事項:
並非所有的 429 回應都會包含
Retry-After標頭。如果缺少該標頭,請針對可重試的速率限制錯誤使用有界退避策略(逐步增加重試嘗試之間的等待時間)。
如果您已耗盡 API 使用配額或遇到方案限制,請在重試前解決該問題。
在不等待的情況下重複發送請求可能會導致進一步的速率限制錯誤。
以下是您可能會遇到的部分速率限制,具體取決於您的使用案例:
端點 | Growth 方案 | Pro 方案 | Business 方案 |
| 10 / 10 秒 | 10 / 10 秒 | 10 / 10 秒 |
| 10 / 10 秒 | 10 / 10 秒 | 10 / 10 秒 |
| 30 / 10 秒 | 60 / 10 秒 | 100 / 10 秒 |
| 30 / 10 秒 | 60 / 10 秒 | 100 / 10 秒 |
注意事項:
您不必在發送第一條訊息前先新增聯絡人。如果聯絡人不存在,當訊息發送時,該聯絡人會自動新增至 Wati。
我們建議使用 webhook 而非
/getMessages端點,以更有效地接收傳入的訊息。
如果您要向多個聯絡人發送相同的範本訊息,建議使用
/sendTemplateMessages端點,而非/sendTemplateMessage。
V1
/sendTemplateMessages端點允許您在單次 API 呼叫中包含最多 1,000 位聯絡人。V3
/api/ext/v3/messageTemplates/send端點允許您在單次 API 呼叫中包含最多 10,000 位聯絡人。
若要了解各方案的端點可用性,請參閱我們的 API 文件。
另一方面,API 使用限制是指根據您的訂閱方案而定的 API 呼叫總次數。使用限制決定了您總共可以使用多少 API,而速率限制則決定了您可以發送請求的速度。
簡單來說:
速率限制控制 API 請求的速度(每秒或每個時間視窗內的請求數)。
使用限制控制在您的方案下允許的 API 使用總量。
常見問題 (FAQs)
Wati API 概覽
1. Wati API 的用途是什麼?
Wati API 允許您透過 Wati 帳戶與 WhatsApp 互動。這些 API 可用於檢索和發送訊息、管理客戶聯絡人清單,並將 Wati 與您自己的應用程式或系統連接。
2. 哪些任務可以使用 Wati API 自動化?
Wati API 可用於自動化工作流程、將 Wati 與 CRM 或支援工具整合、發送和檢索訊息,以及管理客戶聯絡人。
API 使用限制
3. 每個 Wati 方案的每月 API 使用限制是多少?
每月 API 使用限制取決於您的 Wati 方案:
Growth 方案:每月 10,000 次 API 呼叫
Pro 方案:每月 200,000 次 API 呼叫
Business 方案:每月 2,000 萬次 API 呼叫
4. Wati API 使用限制何時重置?
API 使用限制於每月 1 號重置。任何未使用的 API 呼叫次數將於月底失效,且不會結轉至下個月。
5. 哪些 API 包含在 Wati API 使用限制中?
使用限制僅適用於開發人員 API,例如用於發送訊息、管理聯絡人和檢索對話的 API。
6. Wati 中的支付 API 有使用限制嗎?
沒有。目前支付相關 API 沒有使用限制,因此支付 API 可在無每月使用上限的情況下使用。
提高 API 限制
7. 我該如何在 Wati 中要求更多的 API 呼叫次數?
Business 方案的客戶可以透過新增 API 配額附加元件來要求更高的 API 限制。Growth 或 Pro 方案的客戶必須升級到 Business 方案,才能要求提高 API 限制。
API 速率限制
8. API 速率限制與 API 使用限制有什麼區別?
API 速率限制控制您在特定時間視窗內呼叫 API 端點的頻率,而 API 使用限制則控制您訂閱方案下允許的 API 呼叫總數。速率限制管理請求速度,而使用限制則管理 API 的使用總量。
9. 如果超過 API 速率限制會發生什麼事?
如果您超過 API 速率限制,Wati 可能會回傳 HTTP 429 (請求過多) 錯誤。回應可能包含一個 Retry-After 標頭,指示您在重試前應等待多久。如果沒有此標頭,請針對可重試的速率限制錯誤使用有界退避策略。如果是因為使用配額耗盡或方案限制引起的錯誤,請在重試前解決該問題。
Did this answer your question?