Bothub.AI 用户手册简体中文版
Primary version
Primary version
  • 概览
  • 介绍
    • 什么是 Messenger Bot 🤔
  • 快速入门
    • 5分钟创建一个机器人
  • BotHub 基础知识
    • Messenger 机器人的基本功能
    • 多用户管理功能
    • 数据分析
      • 内容分析
      • 流量来源
    • 内容管理
      • 内容结构介绍
      • 文本、图片和视频卡片
      • 菜单卡片及各类按钮
      • 橱窗卡片以及快捷回复
      • 列表卡片
      • 系统设置介绍
      • 标签化内容
      • 广告消息
    • 受众人群
      • 查看历史消息
      • 推送事件
    • 消息群发
      • 广播消息
      • 订阅消息
      • 多时区支持
      • 问卷调研
    • Handover Protocol
    • 人工智能
      • 对话管理
      • 识别优先级
  • BotHub高级工具
    • 高级插件
      • Messenger 网页插件
      • RSS Feed插件
      • 用户输入插件
      • Google搜索插件
      • 订阅管理插件
      • 订阅插件“加入受众”和“移出受众”
      • 商品选取插件
      • 商品搜索插件
      • 购物车展示插件
      • Json Api组件
      • 条件跳转插件
      • 属性设置插件
      • 随机回复插件
      • Typing插件
      • 计数器
      • 语境跳转插件
    • 数据集成
      • 知识库-自动获取Gitbook的文档数据
    • API介绍
      • 开始使用API
      • 关联账号
      • Messenger内的登录按钮
      • 交易信息通知
      • 发送消息API
      • 发送模板消息
      • 生成优惠券的接口的写法
      • 发送知识库条目
      • 参数设置API
      • 呼叫人工
      • whatsapp消息入口
      • 发送whatsapp消息
      • 发送liveChat请求
    • 推广
      • 推广工具
      • 广告管理
      • 再营销SDK的集成
      • 评论回复功能
      • 砍价免费拿
      • Messenger 广告
    • 电商机器人
      • 电商机器人功能介绍
      • 配置你的电商机器人
      • 顾客查询
      • 商家推送
      • 场景应用:顾客查询订单 & 包裹
      • 场景应用:推送订单回执
      • 场景应用:推送订单回执(旧版SDK)
      • 场景应用:包裹更新提醒
      • 场景应用:购物车召回配置
      • 场景应用:购物车召回配置(旧版SDK)
    • 商品管理
      • 商品Feed-Facebook商品数据集成
      • 自定义商品-手动创建活动商品
  • WhatsApp相关说明
    • whatsapp消息入口
    • 发送Whatsapp消息
    • 发送liveChat请求
  • FAQ常见问题
    • Bot 配置常见问题
    • Bot 操作流程问题
      • 如何授权新的FB Page 至Bot平台
      • 首次登录 messenger.bothub.ai 邮箱验证流程
      • 设置仅工作时间段人工客服有效
    • Facebook平台政策问题
      • FB 平台政策
      • Messenger page禁封影响&解封流程
      • 24小时窗口期与24+1 政策解读
Powered by GitBook
On this page
  • 订单回执
  • 接口
  • 接口说明
  • 返回值
  • 物流更新
  • 接口说明
  • 返回值
  1. BotHub高级工具
  2. 电商机器人

商家推送

可提供商户推送订单回执&物流状态更新,是客户自助解决问题的高效方案。

电商机器人的API管理接口,为商家提供了一个有效互动的方式,提高网站的购物体验。 正确集成API管理后,商家将可以以如下方式向主页粉丝主动推送消息:

  • 顾客成功下单后,通过 PSID 向其推送一条订单确认回执

  • 订单发货/签收时,通过 PSID 向顾客发送物流状态更新提示

订单回执

接口

{
  "request": {
    "method": "send_template",
    "id": "test_1523959671_Od7vuGcb",
    "page_id": "1487925408000967",
    "template_name": "Order Receipt Push"
  },
  "recipient": {
    "id": "<psid>"
  },
  "params": {
    "receipt": {
      "recipient_name": "John Doe",
      "order_number": "U5555",
      "currency": "USD",
      "payment_method": "Visa 2345",
      "order_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/classic_white_shirt.jpg",
      "timestamp": 1523619550,
      "address": {
        "street_1": "UNICEF 125 Maiden Lane",
        "street_2": "11th Floor",
        "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": [],
      "elements": [
        {
          "title": "Classic White Shirts",
          "subtitle": "100% Soft and Luxurious Cotton",
          "quantity": 2,
          "price": 11.99,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/classic_white_shirt.jpg"
        },
        {
          "title": "Floral Belted Romper",
          "subtitle": "Casual romper featuring striped pattern",
          "quantity": 2,
          "price": 13.89,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/floral_belted_romper.jpg"
        },
        {
          "title": "One Shoulder Bikini Set",
          "subtitle": "Low Waisted",
          "quantity": 2,
          "price": 14.66,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/one_shoulder_bikini_set.jpg"
        },
        {
          "title": "Smocked Mini Dress",
          "subtitle": "Elastic waistband",
          "quantity": 2,
          "price": 15.77,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/smocked_mini_dress.jpg"
        },
        {
          "title": "Twist Tied Top",
          "subtitle": "Easily look good to pair it with anything",
          "quantity": 2,
          "price": 12.89,
          "currency": "USD",
          "image_url": "https://storage.googleapis.com/assets.bothub.ai/bothub/templates/twisted_tied_top.jpg"
        }
      ]
    }
  }
}

接口说明

当商户需要向用户推送订单回执时,由商户填充params.receipt数据,Bothub验证数据格式正确后向用户发送消息

返回值

成功

{
  "request_id": "test_1523960126_YKanxh4G",
  "recipient_id": "1602407863220595"
}

失败

{
  "error": {
    "code": 10010,
    "error_subcode": 0,
    "type": "",
    "message": "Recipient not found",
    "request_id": "test_1r6523960126_YKanxh4G"
  }
}

物流更新

接口

{
  "request": {
    "method": "send_template",
    "id": "test_1523960374_wERGZIon",
    "page_id": "176029956384795",
    "template_name": "Shipping Status Update Push"
  },
  "recipient": {
    "id": "<psid>"
  },
  "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"
  }
}

接口说明

当商户需要向用户推送物流更新时,由商户填充params数据,其中package_number物流单号,package_status物流状态,package_status_description物流状态详情, image_url截图网址, detailed_tracking_url物理详情链接,fb_first_name用户名,Bothub验证数据格式后向用户发送消息

返回值

成功

{
  "request_id": "test_1523960966_EnPC3z5h",
  "recipient_id": "1602407863220595"
}

失败

{
  "error": {
    "code": 10010,
    "error_subcode": 0,
    "type": "",
    "message": "Recipient not found",
    "request_id": "test_1523960966_EnPC3z5h"
  }
}
Previous顾客查询Next场景应用:顾客查询订单 & 包裹

Last updated 6 years ago