来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant Chat OpenAPI and Webchat Push Updates
(Applicable for Chat Open API Developers)
Hi, we have the following updates for the Chat OpenAPI:
- Support for Sending Voucher Messages
v2.sellerchat.send_message now supports sending voucher messages using voucher_id and voucher_code. The buyer will see the voucher card on the front end.
Related APIs:
v2.sellerchat.send_message
Effective Date on Live: 2024.09.19
- Support Recall Message through OpenAPI
Add a new Open API v2.sellerchat.delete_message to support requests with message_id for message recall based on local regulations. the deleted message will show like this:
Related APIs:
[New]v2.sellerchat.delete_message
Effective Date on Live:
2024.09.13
- Webchat Push support quote_message
If a message is quoted message, you can get quoted message_id in webchat push now
"quoted_msg": {
"message_id": "122333444555" }
Related APIs: webchat_push
Effective Date on Live:
2024.09.19
- Webchat Push push messages sent from seller
Currently, webchat_push only pushes messages sent by the buyer to the seller. It doesn't push seller replies to the buyer, which can result in missing or duplicate replies when sellers respond from multiple devices.
Starting from September 13th, we will whitelist to enable pushing messages sent between sellers. In future message handling, please match the message source using to_id and from_id. The push messages volume may increase 2 times.
Please fill in the form or raise a ticket if you want to be whitelisted to get messages sent by seller
Related APIs: webchat_push
Effective Date on Live:
2024.09.19
- add sub_account_id and sub_account_name
webchat_push and v2.sellerchat.get_message API will be able to get sub_account_id and sub_account_name when seller uses sub_account to reply message. You can use these two fields to evaluate customer service agent performance
"sub_account_id": 0,
"sub_account_name": 0
Related APIs:
webchat_push
v2.sellerchat.get_message
Effective Date on Live:
2024.09.19
（适用于使用Chat OpenAPI的开发者）以下是Chat OpenAPI的更新通知：
1.支持发送优惠券消息
v2.sellerchat.send_message 支持入参 voucher_id 和 voucher_code 发送优惠券消息。买家将在前端看到优惠券卡片。
相关API：
v2.sellerchat.send_message
生效日期：2024年9月19日
2.支持通过OpenAPI撤回消息
新增API v2.sellerchat.delete_message，支持基于当地限制的规则传入 message_id 撤回消息。被删除的消息将显示如下，具体规则见接口：
相关API：
[new] v2.sellerchat.delete_message
生效日期：2024年9月19日
- Webchat Push 支持引用消息
如果消息是引用消息，你现在可以在 webchat_push 中获取引用的 message_id：
"quoted_msg": {
"message_id": "122333444555" }
相关API：webchat_push
生效日期：2024年9月13日
- Webchat Push 推送卖家发送的消息
目前，webchat_push 只推送买家发送给卖家的消息，未推送卖家回复买家的消息，这可能导致卖家在多个设备回复时出现消息丢失或重复回复的问题。从2024年9月13日起，我们将开放白名单推送卖家之间发送的消息。在处理这些消息时，请通过 to_id 和 from_id 匹配消息来源。开放后推送的消息量可能增加至两倍。
如果您希望加入白名单以接收卖家发送的消息，请提交工单或填写表单。
相关API：webchat_push
生效日期：2024年9月13日
- 新增 sub_account_id 和 sub_account_name 字段
webchat_push 和 v2.sellerchat.get_message API 现在能够获取 sub_account_id 和 sub_account_name，当卖家/客服中介使用子账户回复消息时，这两个字段可用于评估客服人员的表现。
"sub_account_id": 0,
"sub_account_name": 0
相关API：
webchat_push
v2.sellerchat.get_message
生效日期：2024年9月13日