摘要
Wati 提供了一组 API，可帮助您以编程方式与 WhatsApp 进行交互。您可以使用这些 API 发送和接收消息、管理联系人、处理媒体以及将 Wati 与现有系统集成。本指南清晰概述了可用的 API 以及每个 API 的功能，以便您快速入门。
说明
可用 API
使用 Wati，您可以访问按功能分组的多个 API。
消息传递 API
使用这些 API 在 WhatsApp 上发送和接收消息。
从 WhatsApp 号码获取消息 - 检索在您的 WhatsApp 号码上收到的消息。
发送会话消息 - 在活跃的 WhatsApp 会话中发送消息。
发送会话文件 - 在活跃会话中发送文件附件。
发送模板消息 - 发送预先批准的 WhatsApp 模板消息。
发送模板消息（批量）- 一次发送多条模板消息。
使用 CSV 发送模板消息 - 上传 CSV 文件以批量发送模板消息。
发送交互式按钮消息 - 发送带有可点击按钮的消息以便快速回复。
发送交互式列表消息 - 发送带有可选择的选项列表的消息。
联系人管理 API
使用这些 API 管理您的联系人数据库。
获取联系人列表 - 检索存储在 Wati 中的所有联系人。
添加联系人 - 创建新联系人。
更新联系人属性 - 修改现有联系人的详细信息。
媒体和身份验证 API
使用这些 API 来管理文件和安全访问。
按文件名获取媒体 - 使用文件名检索媒体文件。
轮换令牌 - 刷新您的身份验证令牌以保持安全的 API 访问。
操作员和分配 API
使用这些 API 管理聊天所有权和路由。
分配操作员 - 将 WhatsApp 对话分配给特定操作员。
在哪里可以找到 API 端点和访问令牌？
要在 Wati 中访问您的 API 详细信息：
1. 登录到您的 Wati 帐户。
2. 在导航菜单中，单击 API，或转到：Connector → API → Create API Token
3. 在 API Tokens 页面上，单击 Generate new token。
4. 输入令牌名称，然后选择所需的范围（权限），例如：
contacts:readcontacts:writemessagetemplate:read
5. （可选）为令牌设置到期日期。为了安全起见，建议每 6 个月轮换一次令牌。
6. 复制并安全地存储生成的令牌。
注意：
新的 创建新令牌 选项移除了用户级别的依赖关系，并将一直有效，直到手动更新或达到其到期日期。
当您使用 创建新令牌 选项时，令牌只会在生成时显示一次，因此请务必复制并安全保存。
其他资源
Wati API 文档 – 所有可用 API 的详细参考
Webhook 文档 – 了解如何设置和处理 Webhook
Postman 集合 – 用于测试 Wati API 的现成可用集合
这些 API 可帮助您自动执行 WhatsApp 通信、简化消息传递工作流程并更有效地管理客户互动。有关实施详细信息和最佳实践，请参阅文档。
常见问题解答 (FAQ)
消息传递 API
1. Wati 消息传递 API 的用途是什么？
Wati 消息传递 API 允许您以编程方式发送和接收 WhatsApp 消息。这些 API 启用诸如检索在您的 WhatsApp 号码上收到的消息、在活跃的 WhatsApp 会话中发送消息或文件、发送预先批准的模板消息、发送批量模板消息以及发送带有按钮或可选择列表的交互式消息之类的操作。
2. 如何使用 Wati API 检索在您的 WhatsApp 号码上收到的消息？
您可以使用 从 WhatsApp 号码获取消息 API 检索在您的 WhatsApp 号码上收到的消息。此 API 返回在 Wati 中连接的 WhatsApp 号码上收到的消息。
3. 可以使用 Wati 消息传递 API 发送哪些类型的消息？
Wati 消息传递 API 允许您发送多种类型的消息，包括活跃 WhatsApp 会话期间的会话消息、活跃会话中的文件附件、预先批准的 WhatsApp 模板消息、批量模板消息、交互式按钮消息和交互式列表消息。
联系人管理 API
4. Wati 联系人管理 API 的用途是什么？
Wati 联系人管理 API 允许您管理存储在 Wati 中的联系人数据库。这些 API 允许您检索联系人列表、创建新联系人以及更新现有联系人的属性。
5. 如何使用 Wati API 检索或更新联系人？
您可以使用 获取联系人列表 API 检索联系人，使用 添加联系人 API 创建新联系人，并使用 更新联系人属性 API 修改联系人详细信息。
媒体、身份验证和对话管理
6. Wati 中的媒体和身份验证 API 的用途是什么？
媒体和身份验证 API 允许您检索存储在 Wati 中的媒体文件并保持安全的 API 访问。例如，按文件名获取媒体 API 检索存储的媒体文件，轮换令牌 API 刷新用于访问 Wati API 的身份验证令牌。
7. 如何使用 Wati API 将 WhatsApp 对话分配给操作员？
您可以使用 分配操作员 API 将 WhatsApp 对话分配给特定操作员。此 API 将对话路由到选定的操作员，以便他们可以管理聊天。
API 访问和设置
8. 在哪里可以在 Wati 中找到 API 端点和访问令牌？
您可以通过登录到您的 Wati 帐户并导航到导航菜单中的 API，或者转到 Connector → API → Create API Token 来找到 API 端点和访问令牌。
9. 如何在 Wati 中生成新的 API 令牌？
要生成新的 API 令牌，请打开 Wati 中的 API Tokens 页面，单击 Generate new token，输入令牌名称，选择所需的范围（例如 contacts:read、contacts:write 或 messagetemplate:read），可选择设置到期日期，然后复制并安全地存储生成的令牌。为了安全起见，建议每六个月轮换一次令牌。