消息反应:发送和接收表情符号
反应会将单个表情符号附加到现有消息。发送反应时,需要引用消息 id 和表情符号;移除反应时,则发送相同的反应,但将 emoji 字符串设为空,而不是调用删除操作。
发送反应
类型为 reaction 的消息,其中包含被反应消息的 id 和单个表情符号。向同一条消息发送第二个反应会替换第一个,而不是在其基础上添加,因为每位发送者每条消息只能保留 1 个反应。
消息 id 必须是您的号码可以看到的消息:该客户发来的消息,或您发送给该客户的消息。
移除反应
这部分最容易让人意外。没有删除调用。您需要发送相同的反应消息,将 emoji 字段设为空字符串,这样就会清除反应。
如果处理程序预期接收移除事件,就会一直等待。实际送达的是 emoji 为空的 reaction,结构与新反应相同,因此必须通过检查该字段,将其识别为移除操作。
接收反应
传入的反应会通过 messages Webhook 送达,作为类型为 reaction 的消息,其中标明所附加消息的 id 和表情符号。
- 订阅 messages 字段,没有单独的 reactions 字段。
- emoji 为空表示客户移除了自己的反应。
- 引用的消息 id 是您之前发送或接收的消息。
- 反应不会重新开启 24 小时服务窗口。
服务窗口仍然适用
反应属于消息,因此发送反应需要 24 小时客户服务窗口处于开启状态。对客户 3 天前的消息添加反应时,会返回错误 131047,就像发送普通文字消息一样。
收到客户的反应会重新开启服务窗口,因为任何传入消息都会这样做。这一点对自动化很有用:客户对您上一条消息点个赞,就是一个有效信号,表示您现在可以自由回复。
常见错误
- 寻找删除端点。移除反应使用相同的调用,只需将 emoji 设为空。
- 将空 emoji 视为格式错误。空 emoji 就是表达移除反应的方式。
- 在服务窗口之外发送反应。它会像其他消息一样失败。
EasyCoexistence 会通过与其他消息相同的 Webhook,将反应事件发送到您的端点,因此移除的反应会连同空 emoji 完整送达您的系统。
常见问题
如何移除反应?
发送相同的反应消息,并将 emoji 字符串设为空。没有删除调用。
反应收费吗?
不收费。反应不会开启计费对话。
我可以对任何消息添加反应吗?
只能对您的号码发送或接收的消息添加反应,而且必须在 24 小时服务窗口内。
客户的反应会重新开启服务窗口吗?
会。客户发来的任何消息都会重新开启窗口,包括反应。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间