电商机器人的API管理接口，为商家提供了一个有效互动的方式，提高网站的购物体验。 正确集成API管理后，商家将可以以如下方式向主页粉丝主动推送消息:
- 顾客成功下单后，通过 PSID 向其推送一条订单确认回执
- 订单发货/签收时，通过 PSID 向顾客发送物流状态更新提示
订单回执
接口
{
"request":{
"method":"send_template",
"id":"test_1523959671_Od7vuGcb",
"page_id":"1487925408000967",
"template_name":"Order Receipt Push"
},
"recipient":{
"id":"<psid>"
},
"params":{
"receipt":{
"recipient_name":"John Doe",
"order_number":"U5555",
"currency":"USD",
"payment_method":"Visa 2345",
"order_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/classic_white_shirt.jpg",
"timestamp":1523619550,
"address":{
"street_1":"UNICEF 125 Maiden Lane",
"street_2":"11th Floor",
"city":"New York",
"postal_code":"10038",
"state":"NY",
"country":"US"
},
"summary":{
"subtotal":138.4,
"shipping_cost":0,
"total_tax":0,
"total_cost":138.4
},
"adjustments":[
],
"elements":[
{
"title":"Classic White Shirts",
"subtitle":"100% Soft and Luxurious Cotton",
"quantity":2,
"price":11.99,
"currency":"USD",
"image_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/classic_white_shirt.jpg"
},
{
"title":"Floral Belted Romper",
"subtitle":"Casual romper featuring striped pattern",
"quantity":2,
"price":13.89,
"currency":"USD",
"image_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/floral_belted_romper.jpg"
},
{
"title":"One Shoulder Bikini Set",
"subtitle":"Low Waisted",
"quantity":2,
"price":14.66,
"currency":"USD",
"image_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/one_shoulder_bikini_set.jpg"
},
{
"title":"Smocked Mini Dress",
"subtitle":"Elastic waistband",
"quantity":2,
"price":15.77,
"currency":"USD",
"image_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/smocked_mini_dress.jpg"
},
{
"title":"Twist Tied Top",
"subtitle":"Easily look good to pair it with anything",
"quantity":2,
"price":12.89,
"currency":"USD",
"image_url":"https://storage.googleapis.com/assets.meetbot.biz/meetbot/templates/twisted_tied_top.jpg"
}
]
}
}
}接口说明
当商户需要向用户推送订单回执时，由商户填充params.receipt数据，Meetbot验证数据格式正确后向用户发送消息
返回值
成功
{
"request_id":"test_1523960126_YKanxh4G",
"recipient_id":"1602407863220595"
}失败
{
"error":{
"code":10010,
"error_subcode":0,
"type":"",
"message":"Recipient not found",
"request_id":"test_1r6523960126_YKanxh4G"
}
}物流更新
接口
{
"request":{
"method":"send_template",
"id":"test_1523960374_wERGZIon",
"page_id":"176029956384795",
"template_name":"Shipping Status Update Push"
},
"recipient":{
"id":"<psid>"
},
"params":{
"package_number":"zvfVUREPVPUQ1oMl",
"package_status_description":"Status: enroute by UPS Exp. Delivery: 03, Jan, 2018",
"image_url":"https://unsplash.it/120/120/?random",
"detailed_tracking_url":"http://shop.meetbot.biz",
"fb_first_name":"Peter",
"package_status":"shipped"
}
}接口说明
当商户需要向用户推送物流更新时，由商户填充params数据，其中
package_number物流单号，package_status物流状态，package_status_description物流状态详情， image_url截图网址， detailed_tracking_url物理详情链接，fb_first_name用户名，Meetbot验证数据格式后向用户发送消息返回值
成功
{
"request_id":"test_1523960966_EnPC3z5h",
"recipient_id":"1602407863220595"
}失败
{
"error":{
"code":10010,
"error_subcode":0,
"type":"",
"message":"Recipient not found",
"request_id":"test_1523960966_EnPC3z5h"
}
}
