事件推送

您可以通过 Events来推送有关商店中特定事件的通知给Mamba。

例如,当客户创建订单时您需要将订单数据同步到Mamba以此保持Mamba的数据与您店铺的数据一致

EventsEndpoint(请求端点)请求格式
Customerscustomers(旧)
customers/create
customers/update
Customer Properties
Productsproducts/create
products/update
Product Properties
Ordersorders/create
orders/update
orders/paid
orders/fulfilled
Order Properties
Checkoutscheckouts/create
checkouts/update
Checkout Properties
Cartscarts/create
carts/update
Cart Properties
PageViewpage/viewedPage View Properties
FlowNotifyflow/notifyFlow Notify Properties

事件自动化对应表

Endpoint(请求端点)自动化触发器
customers/create顾客创建
carts/create废弃购物车
checkouts/create废弃订单
orders/paid订单支付
orders/fulfilled订单发货
orders/refunded订单退货
orders/update订单状态变更
page/viewed页面浏览
flow/notify消息通知

事件推送公共参数

所有请求Endpoint端点都支持以下参数。

字段类型描述是否必填
customobj自定义数据,key ,value 在 模板中使用 {custom.key}N
currency_symbolstring币种符号。邮件模板价格币种符号显示。推荐商品价格符号N
ignore_flowstring是否忽略自动化 Y 是 N 否 默认 NN
recommend_productsarray推荐商品,邮件模板编辑-产品推荐器,最多支持16个商品。多了会被裁掉N

例如调用 customers/create 顾客创建, json结构与业务基本参数同一级别

{
    "id": "2",
    "email": "[email protected]",
    "first_name": "testing",
    "last_name": "2",
    "created_at": "1686973206",
    "email_marketing_consent": {
        "state": "subscribed",
        "updatedAt": 1717577626
    },
    "sms_marketing_consent": {},
    "default_address": {},
    "recommend_products": [
        {
            "id": "a5822b4a-4728-4d06-bc5e-d1dd14d6f3cd",
            "title": "Factory wholesale birthday candle personalized creative digital cake candle birthday party baking decoration digital candle",
            "price": "34.2",
            "compareAtPrice": "37.2",
            "image": "https://cdn.shoplazza.com/a5bc58fbf5f967cd2d25495dc515207d.jpeg",
            "url": "https://yazhen-release.myshoplaza.com/products/factory-wholesale-birthday-candle-personalized-creative-digital-cake-candle-birthday-party-baking-decoration-digital-candle"
        },
        {
            "id": "a5822b4a-4728-4d06-bc5e-d1dsad14d6f3cd",
            "title": "Factory wholesale",
            "price": "34.2",
            "compareAtPrice": "54.2",
            "image": "https://cdn.shoplazza.com/545406fd6889482f795e7e14f6526bb0.jpeg",
            "url": "https://yazhen-release.myshoplaza.com/products/factory-wholesale-birthday-candle-personalized-creative-digital-cake-candle-birthday-party-baking-decoration-digital-candle"
        }
    ]
}

推荐商品

字段类型描述是否必填
titlestring商品标题Y
pricestring价格Y
compareAtPricestring原始价格Y
imagestring图片urlY
urlstring产品浏览urlY