摘要
通过 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 中。
我们建议使用网络钩子 (webhooks) 而不是
/getMessages端点来更高效地接收传入消息。
如果您要向多个联系人发送相同的模板消息,建议使用
/sendTemplateMessages端点,而不是/sendTemplateMessage。
V1
/sendTemplateMessages端点允许您在单个 API 调用中包含最多 1000 个联系人。V3
/api/ext/v3/messageTemplates/send端点允许您在单个 API 调用中包含最多 10,000 个联系人。
要了解有关各套餐端点可用性的更多信息,请参阅我们的 API 文档。
另一方面,API 使用限额是指根据您的订阅套餐计算的 API 调用总数。使用限额决定了您总体使用 API 的程度,而速率限制决定了您发送请求的速度。
简而言之:
速率限制控制 API 请求的速度(每秒或每个时间窗口的请求数)。
使用限额控制您套餐允许的 API 使用总量。
常见问题解答 (FAQ)
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?