事件推送

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

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

Events	Endpoint(请求端点)	请求格式
Customers	customers(旧) customers/create customers/update	Customer Properties
Products	products/create products/update	Product Properties
Orders	orders/create orders/update orders/paid orders/fulfilled	Order Properties
Checkouts	checkouts/create checkouts/update	Checkout Properties
Carts	carts/create carts/update	Cart Properties
PageView	page/viewed	Page View Properties
FlowNotify	flow/notify	Flow Notify Properties

事件自动化对应表

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

事件推送公共参数

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

字段	类型	描述	是否必填
custom	obj	自定义数据，key ，value 在模板中使用 {custom.key}	N
currency_symbol	string	币种符号。邮件模板价格币种符号显示。推荐商品价格符号	N
ignore_flow	string	是否忽略自动化 Y 是 N 否默认 N	N
recommend_products	array	推荐商品，邮件模板编辑-产品推荐器，最多支持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"
        }
    ]
}

推荐商品

字段	类型	描述	是否必填
title	string	商品标题	Y
price	string	价格	Y
compareAtPrice	string	原始价格	Y
image	string	图片url	Y
url	string	产品浏览url	Y