场景应用:包裹更新提醒
特定场景配置指南:包裹状态更新
顾客成功下单后,如果曾经按照 场景应用:推送订单回执 中采用了 Checkbox 插件的方式关联了 custom user id,那么你就可以调用电商机器人提供的 API 向用户推送发货提醒和物流更新提醒,增加与每位顾客互动的机会,提升了用户体验。

下面,我将为你说明配置方法:
创建 API Key,配置接口
首先,前往“API 对接” -> ”密钥管理“处,新建一个 API Key。

调用物流更新API
至“API 对接” -> “API 管理” -> “物流更新”,选择刚刚创建的 Key,切换“用户”选项为“用户ID”,在右侧空格中填写用户在您网站上的ID。只要此用户在您的网站上在Checkbox插件上打过勾以确认收取订单回执和发货提醒,那么您就可以获取下方的 CURL命令并执行以发送物流更新了。
实际使用中,您应该在订单实际发货的时候,通过您的后台,以与此CURL命令相同的格式调用我们的API,即可发送物流更新提醒。数据应替换成您订单物流状态实际的数据。数据格式可以参照下列页面中的”JSON“部分。

接下来,详细介绍一下要发送的数据。
数据
{
"request": {
"method": "send_template",
"id": "test_1523960374_wERGZIon",
"page_id": "176029956384795",
"template_name": "Shipping Status Update Push"
},
"recipient": {
"
username": "custom user id"
},
"params": {
"package_number": "zvfVUREPVPUQ1oMl",
"package_status_description": "Status: enroute by UPS \n Exp. Delivery: 03, Jan, 2018",
"image_url": "https://unsplash.it/120/120/?random",
"detailed_tracking_url": "http://shop.bothub.ai",
"fb_first_name": "Peter",
"package_status": "shipped"
}
}
数据说明
以下数据将用于,生成对应的包裹更新详情。其中,
package_number 为运单号
package_status 为包裹状态
package_status_description 为包裹状态详情
image_url 为包裹图片
detailed_tracking_url 为包裹详情查询链接
fb_first_name 为用户名
我们将验证以上数据格式,并在验证通过后向顾客发送消息
返回值
成功
{
"request_id": "test_1523960966_EnPC3z5h",
"recipient_id": "1602407863220595"
}
失败
{
"error": {
"code": 10010,
"error_subcode": 0,
"type": "",
"message": "Recipient not found",
"request_id": "test_1523960966_EnPC3z5h"
}
}
现在,你可以随时通过 API 调用的方式,向顾客发送物流更新提醒。
Last updated