跳转到主要内容

了解 Wati API 及其使用限制

摘要

通过 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 套餐:2000 万次 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(请求过多)错误。

以下是您可能会遇到的部分速率限制(取决于您的使用场景):

端点

Growth 套餐

Pro 套餐

Business 套餐

/addContact, /getContacts

10 / 10 秒

10 / 10 秒

10 / 10 秒

/getMessages

10 / 10 秒

10 / 10 秒

10 / 10 秒

/sendTemplateMessage

30 / 10 秒

60 / 10 秒

100 / 10 秒

/sendTemplateMessages

30 / 10 秒

60 / 10 秒

100 / 10 秒

注意:

  • 您无需在发送第一条消息之前添加联系人。如果联系人不存在,当消息发送时,该新联系人会自动添加到 Wati 中。

  • 我们建议使用 webhook 而不是 /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 套餐:每月 2000 万次 API 调用

4. Wati API 使用限额何时重置?

API 使用限额在每月 1 号重置。任何未使用的 API 调用都将在月底失效,不会结转到下个月。

5. Wati API 使用限额中包含哪些 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(请求过多)错误。

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 次请求

这是否解答了您的问题?