WTO WA API 面向开发者，专注快速响应、稳定连接与减少掉线。
从开发者最关心的三个问题开始
对于 SaaS、CRM 和自动化工具，你需要的是能持续运行、也能观察运行状态的消息流程。这比只完成一次发送测试更有价值。
协议接入：从连接账号到调用接口
本文介绍的 WTO WA API 连接方式使用 WhatsApp 的关联设备会话。你可以通过二维码或手机号码配对码登录，再通过实例调用相关接口。它与 WhatsApp Business Cloud API 的接入流程不同，选型时应先确认你的业务需要哪种连接方式。 你的应用可以负责自己的用户界面、业务规则和客户数据，把 WhatsApp 操作交给 API。你不需要为了调用 HTTP 接口更换后端语言；可以使用现有技术栈发起请求、处理响应和接收事件。 从创建实例和二维码／配对码登录开始，先连接一个用于测试的账号。响应速度：让消息请求跟上业务动作
客户提交咨询、订单状态变化、客服点击回复，都会触发一次消息操作。接口响应时间会影响你的应用何时更新界面、记录结果或安排下一步处理。 WTO WA API 将低延迟响应作为产品重点。接入时，你可以在实际使用的网络和并发条件下记录请求耗时，判断它是否满足你的业务节奏。 评估速度时，请区分两个环节：接口返回结果与消息到达收件人。一次快速的 HTTP 响应不能代替送达确认；收件人的网络和账号状态也会影响最终体验。对超时请求，先核对处理结果，再决定是否重试，避免重复发送。连接稳定性：减少掉线带来的业务中断
减少掉线的实际价值，是让你少处理“刚才还能发，现在为什么不行”的问题，也让客户少经历重复登录和流程中断。 WTO WA API 将稳定连接作为产品重点，同时提供可以接入应用的状态信息。你可以查询当前连接状态，也可以通过 Webhook 订阅CONNECTION_UPDATE，及时更新自己的连接指示、提醒或发送逻辑。
连接文档使用以下状态：
open：连接已建立，可以继续发送流程。connecting：正在建立连接，等待后再检查。close：连接已断开，需要检查并处理连接问题。
instance.state 为 open。具体操作见连接状态查询。
稳定性仍会受到网络、账号状态和平台变化影响。你可以用自己的运行记录观察断开次数、持续时间和恢复过程，评估实际体验。
REST API 与 Webhook：把 WhatsApp 放进你的产品
集成流程示意：连接账号，调用 API，在自己的应用中接收 Webhook 事件。
- SaaS 通知： 在用户需要的业务节点触发通知，并在自己的产品中展示处理结果。
- CRM 集成： 将消息流程与联系人、负责人和跟进动作关联。
- 客服与 AI 应用： 把接收到的消息事件交给自己的服务处理，再调用发送接口回复。
从一个完整流程开始接入
- 创建实例。 使用与你的实例匹配的 API 凭证，并将凭证保留在后端。
- 连接账号。 选择扫码或配对码登录，按连接指南完成关联设备操作。
- 确认状态。 查询连接状态，等待
open后再发送。 - 发送测试消息。 按接口文档向你自己的测试号码发送一条消息，同时核对接口结果与实际接收情况。
- 接收事件。 配置 Webhook，将需要的消息事件和连接变化接入你的应用。
my-instance 替换为实例名称，将 YOUR_API_KEY 替换为有权限访问该实例的凭证：
开始接入 WTO WA API
通过二维码或配对码连接你的第一个 WhatsApp 实例，为自己的 SaaS、CRM 或自动化应用建立消息通道。