> For the complete documentation index, see [llms.txt](https://bothub.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bothub.gitbook.io/project/advanced-tool/ec-bot/package-update.md).

# 场景应用：包裹更新提醒

顾客成功下单后，如果曾经按照 [场景应用：推送订单回执](https://docs.bothub.ai/advanced-tool/ec-bot/order-receipt) 中采用了 Checkbox 插件的方式关联了 custom user id，那么你就可以调用电商机器人提供的 API 向用户推送发货提醒和物流更新提醒，增加与每位顾客互动的机会，提升了用户体验。

![发送包裹更新提示](/files/-LFS5yRkb5WX2zHxHY62)

下面，我将为你说明配置方法：

## 创建 API Key，配置接口

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

![创建 API Key](/files/-LFS6DcXiR1oVmqFlOEZ)

## 调用物流更新API

至“API 对接” -> “API 管理” -> “物流更新”，选择刚刚创建的 Key，切换“用户”选项为“用户ID”，在右侧空格中填写用户在您网站上的ID。只要此用户在您的网站上在Checkbox插件上打过勾以确认收取订单回执和发货提醒，那么您就可以获取下方的 CURL命令并执行以发送物流更新了。

实际使用中，您应该在订单实际发货的时候，通过您的后台，以与此CURL命令相同的格式调用我们的API，即可发送物流更新提醒。数据应替换成您订单物流状态实际的数据。数据格式可以参照下列页面中的”JSON“部分。

![执行 CURL](/files/-LFtn1Ksh26qRFcZLUqI)

接下来，详细介绍一下要发送的数据。

### **数据**

```
{
  "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 调用的方式，向顾客发送物流更新提醒。