场景应用:包裹更新提醒

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

顾客成功下单后,如果曾经按照 场景应用:推送订单回执 中采用了 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