场景应用：包裹更新提醒

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

顾客成功下单后，如果曾经按照 场景应用：推送订单回执 中采用了 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 \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 调用的方式，向顾客发送物流更新提醒。