> 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/order-receipt.md).
# 场景应用：推送订单回执
在顾客成功付款后，向他的 Messenger 推送订单回执。后续，你还可以向他推送发货提醒、物流更新。提升服务质量的同时，增加一个获取粉丝的渠道。你甚至可以在未来向顾客推送活动信息，提升重复购买。
要发送订单回执，你需要完成两步配置：
* 在网页上放置 Checkbox 插件 / Send to Messenger 插件，引导用户勾选 / 点击。以便征得用户的允许，同意接收此类消息。
* 在程序中配置订单数据。以发送正确的订单信息。
为了方便推广与对比效果，我们为你提供了一系列推广工具。在本场景中，我们推荐使用 2 种入口方式，你可以任选一或多种：
1. 购买完成页放置“发送消息插件”，点击按钮后立即发送订单回执。
2. 商品页/结账页放置“复选框插件”，延迟（在用户购买完成后）发送订单回执。
下面，为你详细介绍 2 种入口分别的效果及配置方法。
## 在结账页使用“发送消息插件”发送订单回执
优势：在付款完成后一键获取回执，对用户来说是很自然的操作。用这种方式，一次性地将订单回执发送给用户。注意，如果你希望未来继续向用户发送物流更新提醒，何种方式不适用，需要使用复选框插件，参考后文。
### 效果图
### 准备入口
从左侧来源管理中创建发送消息插件的推广入口
创建完成后，填写上你网站的域名，保存。
入口准备好了，下面我们在网站上部署代码。如果你在Bothub 新版SDK上线（2019年5月16日）之前，已经在网站上做好了集成，请按照[旧版代码部署方法](https://docs.bothub.ai/advanced-tool/ec-bot/order-receipt-old-version-sdk)操作修改。旧版SDK将于2019年11月30日停止支持，请尽快更新至新版SDK。
### 部署代码
1\. 拷贝插件页面的HTML代码，粘贴到网页上合适的位置：
2\. 在商品页添加初始化代码。拷贝插件中的初始化代码，粘贴至店铺页``标签内。
3\. 在渲染页面时，在**上方初始化代码后**添加实际要发送的商品信息。
```javascript
```
4\. 将代码中的“订单回执数据”，在渲染页面时替换为实际要发送的订单数据：
```javascript
{
"recipient_name":"Stephane Crozatier", // 收件人全名
"order_number":"12345678902", // 订单号
"currency":"USD", // 订单货币
"payment_method":"Visa 2345", // 支付方式，可以为任意字符串，例如"Paypal", "Paid"
"order_url":"http://petersapparel.parseapp.com/order?order_id=123456", // 订单链接
"timestamp":"1428444852", // 下单时间
"address":{ // 订单地址信息
"street_1":"1 Hacker Way",
"street_2":"",
"city":"Menlo Park",
"postal_code":"94025",
"state":"CA",
"country":"US"
},
"summary":{ // 订单金额总计
"subtotal":75.00,
"shipping_cost":4.95,
"total_tax":6.19,
"total_cost":56.14
}, // 下单时使用的优惠。若没有，adjustments可以传空数组
"adjustments":[
{
"name":"New Customer Discount",
"amount":20
},
{
"name":"$10 Off Coupon",
"amount":10
}
],
"elements":[ // 物品详细信息
{
"title":"Classic White T-Shirt",
"subtitle":"100% Soft and Luxurious Cotton",
"quantity":2,
"price":50,
"currency":"USD",
"image_url":"https://fakeimg.pl/200x200/"
},
{
"title":"Classic Gray T-Shirt",
"subtitle":"100% Soft and Luxurious Cotton",
"quantity":1,
"price":25,
"currency":"USD",
"image_url":"https://fakeimg.pl/200x200/"
}
]
}
```
5\. 测试一下。模拟下单后点击发送消息按钮，在Messenger内收到消息。
## 在商品详情页/付款页设置发送订单回执
如果你已经配置了购物车召回，那么直接使用商品页上的“复选框插件”，即可实现订单回执的推送。
### 效果图
此外，在付款页添加“复选框插件”，请用户订阅订单更新消息——是目前已知的，用户勾选率最高的场景。
### 效果图
下面介绍配置方法。
### 准备入口
从左侧来源管理中创建复选框插件的推广入口：
创建完成后，填写上你网站的域名，保存。如果你在Bothub 新版SDK上线（2019年5月16日）之前，已经在网站上做好了集成，请按照[旧版代码部署方法](https://docs.bothub.ai/advanced-tool/ec-bot/order-receipt-old-version-sdk)操作修改。旧版SDK将于2019年11月30日停止支持，请尽快更新至新版SDK。
创建自定义事件。至受众人群-事件中添加自定义事件。在这个场景中，用户点击某个按钮时需要触发此事件，并将用户在你网站上的custom\_user\_id传给bothub。
这里我们命名事件为"subscribe\_to\_order\_updates"，你也可以使用其他名称。记住这个名称，事件触发代码中需要用到。
下面我们在网站上部署代码。
### 部署代码
在页面上，我们需要放置`checkbox`插件，在用户加入购物车/订阅的同时，将用户在您网站上的账号传给 Bothub，以便给用户发送订单回执和物流更新提醒。
1. 将用户在您网站上的账号发送给 Bothub，这段代码放在``标签中
```markup
```
2\. 用户点击加车或订阅按钮时，向 Bothub 发送`subscribe_to_order_updates`事件。实际情况中，按钮可能有其他元素，不需要改动，添加如下`onclick`代码即可。
```markup
```
如此，在用户勾选并加车/点击订阅后，Bothub 会将用户在你网站上的账号与Facebook提供的ref进行绑定，使得在此后的一段时间内，你可以通过API，指定向该用户发送消息。
### 使用API发送订单回执
在你得知用户成功下单后，你可以指定向该custom\_user\_id的用户发送消息。发送方法参见[发送消息API](https://docs.bothub.ai/advanced-tool/api/messenger-api)。你可以在API管理中，选择有效的API KEY，获取正确的消息格式（JSON与CURL）来进行编辑和测试。
