使用场景

账户绑定

Check Box插件的账号绑定方法与Customer Chat的使用方法一致。

订阅订单回执

在顾客成功付款后，向他的 Messenger 推送订单回执。后续，你还可以向他推送发货提醒、物流更新。提升服务质量的同时，增加一个获取粉丝的渠道。你甚至可以在未来向顾客推送活动信息，提升重复购买。
要发送订单回执，你需要完成两步配置：

在网页上放置 Checkbox 插件，引导用户勾选。以便征得用户的允许，同意接收此类消息。
在程序中配置订单数据。以发送正确的订单信息。

本场景中，提供的配置方法是：商品页/结账页放置“复选框插件”，延迟（在用户购买完成后）发送订单回执。

在商品详情页/付款页设置发送订单回执

如果你已经配置了购物车召回，那么直接使用商品页上的“复选框插件”，即可实现订单回执的推送。

此外，在付款页添加“复选框插件”，请用户订阅订单更新消息——是目前已知的，用户勾选率最高的场景。

下面介绍配置方法。

准备入口

首先需要Bothub后台创建一个Checkbox插件，并保证在您的站点是可以部署成功的，具体流程参照前一章节；
其次要求您首先需要将用户在您站点的id传递给Bothub，完成账号绑定工作，这样您即可通过APi的形式向该用户发送messenger消息，您可以使用本引导的绑定方法或者使用API的形式；查看如何通过API绑定账号
创建自定义事件。至受众人群-事件中添加自定义事件；（在这个场景中，用户点击某个按钮时需要触发此事件，并将用户在你网站上的custom_user_id传给bothub）
这里我们命名事件为"subscribe_to_order_updates"，你也可以使用其他名称。记住这个名称，事件触发代码中需要用到。
在页面上，我们需要放置checkbox插件，在用户加入购物车/订阅的同时，需要您将用户在您网站上的账号传给 Bothub，以便给用户发送订单回执和物流更新提醒；
用户点击加车或订阅按钮时，向 Bothub 发送subscribe_to_order_updates事件。实际情况中，按钮可能有其他元素，不需要改动，添加如下onclick代码即可，查看Event模块。

<button [按钮中可能有的其他内容] onclick="window.BH.Event.logEvent('subscribe_to_order_updates')">
</button>

如此，在用户勾选并加车/点击订阅后，Bothub 会将用户在你网站上的账号与Facebook提供的ref进行绑定，使得在此后的一段时间内，你可以通过API，指定向该用户发送消息。

使用API发送订单回执

在你得知用户成功下单后，你可以指定向该custom_user_id的用户发送消息。发送方法参见发送消息API。你可以在API管理中，选择有效的API KEY，获取正确的消息格式（JSON与CURL）来进行编辑和测试。

此API支持使用异步模式，在调用的时候，将发送任务置入消息队列后立即返回，再由队列处理模块依次发送，以获得更大的吞吐量。

// 在request中添加sync字段，置为false，即可使用异步模式
{
  "request": {
    "method": "send_template",
    "id": "test_1590561276_YBAvaXFO",
    "page_id": 103216484358125,
    "sync" : false,
    "template_name": "Order Receipt Push"
  },
  "recipient": {
    "id": ""
  },
  "params": {
    "receipt": {
      "recipient_name": "John Doe", // 收货人姓名，必填
      "order_number": "U5555", // 订单号，必填
      "currency": "USD", // 订单货币，必填
      "payment_method": "Visa 2345", // 支付方式，必填，内容中不能超过5个数字(避免暴露过多支付信息)
      "order_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/classic_white_shirt.jpg", //订单Url，订单详情卡片会将此链接以按钮形式展示，供用户点击跳转，必填
      "timestamp": 1523619550, // 订单发生的时间戳，必填
      "status": "unpaid" // 订单状态，必填
      "address": {
        "street_1": "UNICEF 125 Maiden Lane", // 订单地址1，必填
        "street_2": "11th Floor", // 订单地址2，选填
        "city": "New York", // 订单地址城市，必填
        "postal_code": "10038", // 订单地址邮编，必填
        "state": "NY", // 订单地址州，必填
        "country": "US" // 订单地址国家，必填
      },
      "summary": {
        "subtotal": 138.4, // 订单金额，只能是数字，最多两位小数，不带货币符号，选填
        "shipping_cost": 0, // 运费，只能是数字，最多两位小数，不带货币符号，选填
        "total_tax": 0, // 税费，只能是数字，最多两位小数，不带货币符号，选填
        "total_cost": 138.4 // 实付金额，，只能是数字，最多两位小数，不带货币符号，必填
      },
      "adjustments": [ // 订单价格调整（比如优惠)，没有的话，整个adjustments就设为空数组
        {
          "name": "New Customer Discount", // 优惠名称， 必填
          "amount": 20 //  订单优惠金额，如果有adjustments则为必填
        }
      ],
      "elements": [ // 订单货品
        {
          "title": "Buttoned Cami Mini Dress", // 订单货品名称，必填
          "subtitle": "Brief Style, A-Line silhouette mini dress.", // 订单货品副标题，必填
          "quantity": 1, // 订单货品数量，必填
          "price": 24.99, // 订单货品价格，必填，不带货币
          "currency": "USD", // 订单货品货币，必填
          "image_url": "https://storage.googleapis.com/storage.bhusercontent.com/temp/Buttoned%20Cami%20Mini%20Dress2.png" // 订单货品1图片地址，必填，必须以https://或者http://开头，不能以//开头
        },
        {
          "title": "Long Sleeve Wrap Mini Satin Dress",
          "subtitle": "Long-sleeved wrap dress.",
          "quantity": 1,
          "price": 23.85,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/storage.bhusercontent.com/temp/%20Long%20Sleeve%20Wrap%20Mini%20Satin%20Dress2.png"
        },
        {
          "title": "Frayed Destroyed Skinny Jeans",
          "subtitle": "Light wash design and heavy fading, frayed, broken holes at the knees.",
          "quantity": 1,
          "price": 22.46,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/storage.bhusercontent.com/temp/Frayed%20Destroyed%20Skinny%20Jeans.png"
        },
        {
          "title": "Tiny Floral Smocked Tube Top",
          "subtitle": "Smocked, frill-trimmed tube top accented with a super cute tiny floral print.",
          "quantity": 1,
          "price": 12.49,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/storage.bhusercontent.com/temp/Tiny%20Floral%20Smocked%20Tube%20Top2.png"
        },
        {
          "title": "Back Lace-up Bandeau Romper",
          "subtitle": "Lacing-up is back in a big way!",
          "quantity": 1,
          "price": 14.99,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/storage.bhusercontent.com/temp/ZAFUL%20Back%20Lace-up%20Bandeau%20Romper%207.png"
        }
      ]
    }
  }
}

订阅物流更新

顾客成功下单后，如果曾经按照场景应用：推送订单回执中采用了 Checkbox 插件的方式关联了custom user id（完成了账号绑定），那么你就可以调用电商机器人提供的 API 向用户推送发货提醒和物流更新提醒，增加与每位顾客互动的机会，提升了用户体验。

首先，前往“API 对接” -> ”密钥管理“处，新建一个 API Key；
至“API 对接” -> “API 管理” -> “物流更新”，选择刚刚创建的 Key，切换“用户”选项为“用户ID”，在右侧空格中填写用户在您网站上的ID。只要确保您已经将该用户在您网站的ID与Bothub完成账号绑定，那么您就可以获取下方的 CURL命令并执行以发送物流更新了。

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

数据格式

{
  "request": {
    "method": "send_template",
    "id": "test_1523960374_wERGZIon",
    "page_id": "176029956384795",
    "template_name": "Shipping Status Update Push"
  },
  "recipient": {
    "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", // 收件人First name
    "package_status": "shipped" // 包裹状态， 可任意填写，没有标准取值
  }
}

返回值

成功

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

购物车召回

定位“放弃购物车”的顾客，请他们回到网站下单，为网站增加额外收益。
举个例子：顾客A访问了你的店铺，向购物车添加了商品后，没有立即完成付款。这时候，通过Messenger向他说“购物车商品打折啦，回来完成付款吧！”

设置步骤

数据集成 - 商品 Feed ，导入商品 Feed。
内容管理 - 自定义内容，创建1条召回消息（购物车展示卡片在高级插件里）你可以自定义编辑这部分内容。
受众人群 - 受众定义，创建受众。选择事件added_to_cart，选择发生。添加事件purchase，选择“不发生”。该受众为添加购物车但未付款的用户。顾客勾选checkbox并向购物车内添加商品时，将自动加入受众。
受众人群 - 触发规则，添加触发规则。
选择触发事件added_to_cart；受众选择“Users who abandoned cart”；设置消息延迟时间（建议1小时内）；发送内容选择之前创建的内容块。

推广工具 - 来源管理，添加复选框/优惠券插件。你可以设置插件的隐藏时间——用户在勾选后的一段时间内，用同个浏览器访问店铺，都不会再看到插件。
建议使用优惠券插件，可以主动引导顾客勾选，成为主页粉丝；查看如何创建
Checkbox 无法单独使用，需要在后续的操作中主动触发Event事件，才能保证流程的完整。查看如何触发Event

复选框插件使用场景