场景应用:包裹更新提醒

特定场景配置指南:包裹状态更新

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

创建 API Key,配置接口

首先,前往“API 对接” -> ”密钥管理“处,新建一个 API Key。
创建 API Key

调用物流更新API

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

数据

{ "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 Exp. Delivery: 03, Jan, 2018", "image_url":"https://unsplash.it/120/120/?random", "detailed_tracking_url":"http://shop.meetbot.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 调用的方式,向顾客发送物流更新提醒。
2023-05-23
0