每当有观众下单购买商品，您需调用 SendProductOrderMessage 接口，发送下单购买消息。观众可在聊天区域查看下单购买消息，点击消息中的立即购买，即可跳转至指定商品的详情页，从而提高商品成单率。

注意事项

• 请求频率：单用户请求频率限制为 100 次/秒。
• 前提条件
  • 调用 ModifyActivityMenus 接口，启用商品卡片和聊天互动菜单。
  • 调用 UpdateActivityProduct 接口，完成以下配置：
    • 将 EnableStatus 的参数值设置为 1，上架商品卡片
    • 将 IsOrderMsgEnable 的参数值设置为 1，开启商品卡片的下单消息
  • 调用 UpdateActivityCommentConfig 接口，将 IsViewOrderEnable 的参数值设置为 1，开启下单购买消息。
• 使用限制：目前仅支持在移动端发送商品下单购买消息。
• 前提条件：确保您拥有火山引擎主账号或具备直播间的菜单管理 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。

请求说明

• 请求方式：POST
• 请求地址：https://livesaas.volcengineapi.com/?Action=SendProductOrderMessage&Version=2023-08-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

Body

返回参数

请求示例

POST https://livesaas.volcengineapi.com/?Action=SendProductOrderMessage&Version=2023-08-01
{
    "ActivityId": 177****9762,
    "ProductId": 8****6,
    "UserName": "小王",
    "Amount": 1
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "SendProductOrderMessage",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "Status": true
    }
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码和错误码文档。