Open API Send Message Limitation

Dear Developer ，

Please note that the send message OpenAPI limitation

To reduce unnecessary messages and enhance the buyer experience, Shopee will implement a validation mechanism on July 4, 2025 to block some messages via OpenAPI.( both v2.sellerchat.send_message and v2.sellerchat.send_autoreply_message)

Error 1: reach_5_message_limit

Error Message: You can send up to 5 messages before the buyer responds.

Returned when the seller tries to send more than 5 messages without receiving any reply, under any of the following:

- Buyer messaged the seller within the last 1–7 days

- Buyer has never messaged or last messaged more than 7 days ago, and:

- The buyer has placed an order within 30 days, or

- There is an ongoing RR

Error 2: user_is_forbidden

Error Message: You can only message the buyer if they start a conversation with you within 30 days, place an order within 30 days, or have an unresolved return or refund.

Returned when:

- Buyer has never sent a message or last message > 7 days, and

- Buyer did not place an order in the last 30 days, and

- Buyer has no ongoing RR case

Impacted OpenAPI:

v2.sellerchat.send_message

v2.sellerchat.send_autoreply_message

尊敬的开发者，

请留意OpenAPI发送消息限制的变更

为减少不必要的消息干扰、提升买家体验，Shopee 将于 2025 年 7 月 4 日 起对 OpenAPI 消息发送接口 启用限制校验机制（适用于 v2.sellerchat.send_message 和 v2.sellerchat.send_autoreply_message）。

错误码 1：reach_5_message_limit

错误提示：

You can send up to 5 messages before the buyer responds.

当卖家在 未收到买家任何回复 的前提下尝试发送超过 5 条消息时，会触发此错误。适用以下任一场景：

- 买家在过去 1–7 天内发送过消息，或

- 买家 从未发过消息 或最后一条消息时间 早于 7 天前，且：

- 买家在近 30 天内下过订单，或

- 买家当前存在 进行中的退货/退款（RR）

错误码 2：user_is_forbidden

错误提示： You can only message the buyer if they start a conversation with you within 30 days, place an order within 30 days, or have an unresolved return or refund

当满足以下所有条件时，系统将阻止消息发送并返回该错误码：

- 买家 从未发送过消息 或最后一条消息时间 超过 7 天

- 买家在近 30 天内没有下单

- 买家 无正在进行中的退货/退款（RR）