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
  • 发送请求,开启或关闭liveChat
  • 发送请求
  • 请求样例
  • 请求返回值
  • 错误码列表
  1. BotHub高级工具
  2. API介绍

发送liveChat请求

发送liveChat请求,开启或关闭liveChat

Previous发送whatsapp消息Next推广

Last updated 5 years ago

发送请求,开启或关闭liveChat

用户可以在whatsapp上进行智能对话或进行人工对话。当需要人工对话时,Botchat发起开启livechat(状态)请求;若太久未有人工接通,则botchat可发送关闭liveChat(状态)请求;而如果等待到真正接起人工时,livechat向botchat发送start_licechat信号,通知其已接通人工,不用再理会用户的操作;当人工对话结束时livechat向botchat发起关闭liveChat(状态)请求,继续进行智能对话。

发送请求

请求属性

属性名

说明

地址

请求方式

POST

Header

APIKEY

您的API KEY.

Header

Content-Type

application/json

Form Data

id

由WhatsApp分配的消息ID

Form Data

user_id

用户的手机号

Form Data

source

信号来源(botchat/livechat)

Form Data

signal

信号(start_livechat或stop_livechat)

Form Data

meta

先决条件信息 json (当signal为start_livechat时为必须)

请求样例

{
    "id" : "<unique request identifier>",
    "user_id" : "<phone number of the user>",
    "source" : "<botchat / livechat>",
    "signal" : "<start_livechat / stop_livechat>",
    "meta" : {
        "selected_email" : "<email of the user>"
    }
}

请求返回值

  • 成功返回值样例

{
    "result": true,
    "data": {}
}
  • 失败返回值样例

{
    "error": {
        "code": 10011,
        "error_subcode": 0,
        "type": "",
        "message": "Request already processed",
        "request_id": 35122312158
    }
}

错误码列表

返回值

内容

10000

内部错误

10001

未指定API KEY

10002

无效的API KEY

10003

未指定Request id

10004

未指定调用API的种类

10005

无效的API种类

10005

无效的API种类

10006

Bot不存在或者已经被删除

10011

Request id与之前的重复

10100

参数无效

18000

内部错误

19000

回调超时

41006

未指定id

41026

未指定user_id

41027

未指定signal

41033

未指定meta

41034

meta类型错误,应为json

41035

未指定source

41036

source值错误,应为botchat/livechat

90001

livechat subscriber error

90002

network error

90003

livechat请求不在人工作息时间内

您可以用任意一个已经启用的API Key() 向Moli发起关闭liveChat请求、向Bot发起开启livechat请求。这个请求的说明如下:

怎样申请APIKey
https://api.bothub.ai/channels/{bot_phone}/switch_livechat
chat status