摘要
透過 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 端點的頻率。
如果您在短時間內傳送過多請求，系統將暫時封鎖額外的請求，並回傳 HTTP 429 (Too Many Requests) 錯誤。
以下是您可能會遇到的部分速率限制，具體取決於您的使用案例：
端點 | 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。
我們建議使用 webhooks 取代
/getMessages端點，以便更有效地接收傳入訊息。
如果您要將相同的範本訊息傳送給多個聯絡人，建議使用
/sendTemplateMessages端點，而非/sendTemplateMessage。
/sendTemplateMessages端點允許您在單次 API 呼叫中包含多達 1000 個聯絡人。
另一方面，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 請求，系統會暫時封鎖額外請求，並回傳 HTTP 429 (Too Many Requests) 錯誤。
10. Wati 中 API 速率限制的範例有哪些？
API 速率限制範例包括：
/addContact和/getContacts：所有方案皆為每 10 秒 10 次請求/getMessages：所有方案皆為每 10 秒 10 次請求/sendTemplateMessage：Growth 方案每 10 秒 30 次請求，Pro 方案每 10 秒 60 次請求，Business 方案每 10 秒 100 次請求/sendTemplateMessages：Growth 方案每 10 秒 30 次請求，Pro 方案每 10 秒 60 次請求，Business 方案每 10 秒 100 次請求