跳到主要内容

客户分群创建

Webhookcustomers/segment_create

C 端客户分群创建时触发。

需要 customer 访问权限。最低支持版本:202007

请求头

    X-Shoplazza-Topicstring

    触发本次推送的事件,例如 orders/create

    示例: orders/create
    X-Shoplazza-Hmac-Sha256string

    请求体的 HMAC-SHA256 签名(base64 编码),使用应用的 Client Secret 生成,用于验证请求来自 Shoplazza

    X-Shoplazza-Shop-Domainstring

    产生该事件的店铺域名

    示例: example.myshoplaza.com
    X-Shoplazza-Api-Versionstring

    序列化 payload 使用的 API 版本

    示例: 2025-06
    X-Shoplazza-Deduplication-IDstring

    本次推送的去重 ID,同一事件重发时保持不变,用于幂等去重

请求体

  • customer_segment object
    idstring

    客户分组 ID

    namestring

    分组名称

    filterstring

    细分条件设置(内嵌 JSON 字符串)

    statestring

    分组状态(normal=有效,invalid=无效)

    source_namestring

    数据来源(admin=后台,api=API 接口)

    app_namestring

    创建该分组的插件名称

    created_atstring

    分组创建时间

    updated_atstring

    分组更新时间