已关联的 WhatsApp 号码,是一个普通的 WhatsApp 账号 — 在手机上,有自己的聊天和群 — 同时又以 WhatsApp Web 关联浏览器的方式关联到了 MakeHybrid。账号依然在手机上。这条关联让 API 能读取该号码的聊天,并以这个号码在其中发言。
怎么关联
向 API 请求一个关联链接,在电脑上打开它,然后用手机扫描它显示的二维码:WhatsApp,设置,已关联设备,关联设备。链接有效期一小时,打开期间二维码会保持最新。扫描完成后,连接信息会报告号码及其名称。
curl -X POST https://makehybrid.com/whatsapp/v1/connection/link \ -H "X-API-KEY: $MAKEHYBRID_KEY"
它能做什么,不能做什么
- 向某个人按手机号发送文本,或向某个聊天或群按聊天 ID 发送文本。
- 读取聊天列表,附带每个聊天的最后一条消息和未读数,并读取聊天里的消息。
- 以签名的 webhook 事件,收到每一条收到或发出的消息。
- 不传文件:图片或文档只会标记为媒体,文件本身仍留在手机上。
消息每隔 10 到 20 秒发出一条,这是真人打字的节奏。WhatsApp 会限制像机器一样发送的号码,而这个节奏正是已关联号码能一直保持关联的原因。
常见问题
手机关机了会怎样?
需要用到该号码的调用会返回 409 not_online,直到手机上再次打开 WhatsApp。手机大约两周不上线,WhatsApp 就会取消该设备的关联;用同样的方法重新关联即可。
它和项目房间的 WhatsApp 渠道是同一个号码吗?
是的。在任何一处关联,两处都能用;在一处取消关联,两处都会取消。