摘要
透過 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 次請求
Related articles
- Wati API 概覽總覽 Wati 提供應用程式介面 (API),讓您可以將 Wati 與現有系統連接、自動化訊息傳送、管理聯絡人、執行行銷活動,並以程式化方式存取其他 Wati 功能。 本指南概述了可用的 Wati API,包括其端點、支援的 API 版本,以及其他開發者資源的連結。 重要提示: 建議所有新的整合使用 v3。舊版的 v1…
- Wati 的 API 支援多個 WhatsApp 號碼摘要 如果您正在使用 Wati 的「多個 WhatsApp 號碼」功能,本指南將說明如何跨不同的已連線號碼使用 Wati API。 說明 如果您的 Wati 帳戶連線了多個 WhatsApp 號碼,您可以使用這些號碼透過 API 發送和接收訊息。 為確保 API 請求使用正確的 WhatsApp 號碼,您可能需要在請求…
- 如何使用 Wati API 通過 WhatsApp 發送一次性密碼 (OTP)摘要 本指南解释了如何使用 Wati 的 API 通过 WhatsApp 发送一次性密碼 (OTP)。您将学习如何创建身份驗證模板、獲得批准以及使用 /sendTemplateMessage API 触發 OTP 消息。 注意: 廣播 現已改名為 活動 – 功能相同,名称更新! 可用性 - 身份驗證模板對 Wati 的…
- 如何修復檔案附件名稱顯示為 null 或 untitled摘要 當您使用 Wati API 在有效的 WhatsApp 會話中發送檔案時,如果您未在請求中包含 caption 參數,附件名稱可能會顯示為 null 或 untitled。 要解決此問題,請將 caption 參數作為查詢參數包含在內,並將其設定為您想要顯示的檔案名稱。本文介紹如何使用舊版 v1 API 應用此修…
- 如何在 Wati 中创建新的 API 令牌摘要 API令牌允許外部系統(如客戶關係管理(CRM)平台或自定應用程序)安全地連接Wati並訪問其API。本指南解釋了如何在Wati中生成API令牌,選擇正確的權限,並安全地存儲令牌以備後用。 說明 請按照以下步驟在您的Wati賬戶中生成新的API令牌。 步驟1:登錄您的Wati賬戶 - 登錄到您的Wati賬戶。 步…
Did this answer your question?