微伴助手OpenAPI
  1. 自定义侧边栏身份校验
微伴助手OpenAPI
  • OpenAPI基本介绍
  • 错误码参考表
  • 访问频率和并发限制
  • 消息订阅
    • 订阅消息加解密指南
    • 回调应用配置指南
    • 工单变更消息
      • 工单变更消息回调
      • 创建工单回调
      • 流转工单回调
      • 关闭工单回调
      • 重新打开工单回调
      • 评论工单回调
  • 获取访问凭据
    • 获取访问凭据
      POST
  • 员工管理
    • 获取员工列表
      GET
    • 获取员工详情
      GET
    • 发送员工通知
      POST
  • 自定义订单管理
    • 订单信息删除
      GET
    • 获取订单信息列表
      GET
    • 批量同步店铺信息
      POST
    • 批量同步商品信息
      POST
    • 批量同步订单信息v2
      POST
    • 批量删除商品信息
      POST
    • 删除店铺信息
      GET
    • 批量删除订单信息
      POST
    • 获取店铺信息详情
      POST
    • 获取店铺信息列表
      GET
    • 获取商品信息详情
      POST
    • 获取商品信息列表
      GET
  • 客户管理
    • 获取客户列表
      GET
    • 根据更新时间获取客户列表
      GET
    • 获取客户详情
      GET
    • 获取流失提醒客户列表
      GET
    • 导入客户信息
      POST
    • 添加客户评分
      POST
    • 添加自定义字段
      POST
    • 批量预设客户属性
      POST
    • 批量修改自定义字段的值
      POST
    • 创建批量加好友任务(批量创建添加客户任务)
      POST
    • 批量unionid&openid换external_user_id
      POST
    • external_user_id换unionid
      POST
    • unionid&openid换客户id
      POST
    • 获取客户自定义字段值列表
      GET
    • 批量获取客户详情
      POST
    • 获取批量加好友待添加列表
      GET
  • 客户积分管理
    • 批量增减客户积分
    • 批量获取客户积分
    • 获取单个客户积分明细记录
    • 获取全部客户积分明细记录
  • 客户标签管理
    • 获取标签列表
    • 批量更新客户企业标签
    • 给客户添加企业标签
    • 删除客户的企业标签
    • 给客户添加微伴个人标签
    • 删除客户的微伴个人标签
    • 获取预打标签信息
    • 批量预打企业标签
    • 根据手机号删除预打标签任务
    • 根据unionid删除预打标签任务
    • 获取指定用户预打标签任务详情
    • 获取预打标签任务列表
    • 添加预打标签任务
  • 客户画像管理
    • 获取客户事件列表
    • 创建自定义客户事件
    • 获取自定义客户事件类型列表
    • 获取自定义客户事件类型详情
    • 添加自定义客户事件类型
    • 删除自定义客户事件类型
    • 更新自定义客户事件类型
    • 获取客户阶段状态
  • 标签库管理
    • 获取标签列表V2
    • 获取指定标签信息
    • 新增企业标签组
    • 新增企业标签
    • 删除企业标签
    • 更新企业标签
    • 同步企业微信标签
  • 群聊管理
    • 获取群聊列表
    • 获取群聊成员列表
    • 获取客户所在群聊
    • 查看客户是否在群聊中
    • 获取群聊详情
  • 工单管理
    • 工单模块OpenAPI开发必读
    • 获取工单列表
    • 获取工单详情
    • 获取工单流内处理人
    • 获取工单模板列表
    • 获取工单模板详情
    • 新建工单
    • 修改工单
    • 流转工单
    • 评论工单
    • 关闭工单
  • 销售过程管理
    • 获取商机列表
    • 获取商机详情
    • 修改商机阶段
    • 获取线索公海列表
    • 批量导入线索
    • 修改线索
    • 获取线索列表
    • 员工单条/批量领取线索
    • 获取线索客户列表
  • 聊天记录管理
    • 获取会话消息
    • 获取会话消息2(按照消息时间逆序)
    • 获取员工会话
  • 拉新排行榜
    • 获取拉新排行榜列表
  • 群裂变
    • 获取群裂变活动列表
    • 获取群裂变任务详情
    • 获取群裂变客户详情列表
  • 群打卡
    • 获取群打卡活动列表
    • 获取群打卡任务详情
  • 企微任务宝
    • 获取企微任务宝活动列表
    • 获取企微任务宝任务详情
    • 获取企微任务宝对应的客户数据列表
    • 获取客户对应的企微任务宝数据列表
  • 拉新排行榜
    • 获取拉新排行榜活动列表
  • 自定义表单
    • 获取自定义表单列表
    • 自定义表单用户与表单关系列表
    • 自定义表单提交数据详情列表
    • 获取自定义表单分组列表
  • 客户转化
    • 批量新增手机线索转化
  • 员工个人群发记录管理
    • 获取员工个人群发记录列表
    • 获取员工个人群发记录结果列表
  • 渠道码管理
    • 获取渠道码列表
    • 获取渠道码加人数据
  • 素材库管理
    • 获取素材库列表
    • 获取素材库标签列表
    • 新增素材
    • 更新素材
    • 删除素材
    • 新建素材分组
    • 修改素材分组
    • 添加素材库标签
    • 删除素材库标签
    • 删除素材分组
    • 素材分组列表
  • 互动雷达管理
    • 获取雷达列表
    • 获取雷达详情
    • 添加雷达
    • 修改雷达
    • 删除雷达
    • 上传file
    • 获取雷达分组列表
    • 获取雷达客户访问记录
  • 自定义侧边栏身份校验
    • 侧边栏模块化-自定义卡片功能说明
    • 自定义侧边栏Code校验
      GET
  • 有赞订单管理
    • 获取有赞订单
    • 获取有赞订单列表
  • 小鹅通订单管理
    • 获取小鹅通TOKEN
  • 项目管理
    • 项目列表
  • 门店信息
    • 批量导入门店
    • 批量更新门店
    • 门店列表
  • 人群包
    • 人群包列表获取
    • 创建人群包
    • 更新人群包
    • 创建的人群包中添加数据
    • 获取人群包数据详情
  • 客户群发
    • 客户群发创建
    • 群发任务列表
    • 群群发详情获取
    • 员工群发结果
    • 客户群群发创建
    • 员工-群群发结果
    • 获取群发错误unionid/extid
  • 企微朋友圈
    • 企微朋友圈创建
    • 企微朋友圈任务列表
    • 企微朋友圈任务发表详情
  • 个人SOP
    • 个人SOP列表
    • 个人SOP详情-规则列表
    • 个人SOP详情-执行记录
  • 部门管理
    • 获取部门列表
  • 群标签管理
    • 获取群聊标签分组及其子列表
    • 群聊批量打标签
  • 话术库
    • 企业话术分组列表
    • 企业话术列表
  • 企微数据专区
    • 获取会话消息(企微数据专区)
  1. 自定义侧边栏身份校验

侧边栏模块化-自定义卡片功能说明

侧边栏模块化-自定义卡片#

功能概述#

侧边栏模块化是基于微伴助手侧边栏推出的满足客户个性化需求的功能。允许公司修改基础卡片的配置,开发自定义卡片或修改自定义卡片样式。
微伴开放平台还为开发者提供了 侧边栏模块化 DEMO,供开发者体验和快速接入。

使用场景#

侧边栏个性化展示
展示地图、图表、关系图等微伴助手暂无法提供的页面。
例如:客户的车辆需要报修,开发者需要在员工的侧边栏展显示客户车辆的位置。此时自定义字段无法满足需求,企业可以开发地图页面侧边栏卡片,以便在侧边栏展示客户的车辆位置和地图信息。
如下图所示:
敏感数据保护场景
部分企业业务涉及敏感信息,不能将数据存储在微伴后端数据库,通过使用自定义卡片对接企业自身的后端数据库,向其发送请求~~~~进行数据交互,以保证敏感数据安全。
例如:客户的银行卡信息和身份证号都属敏感信息,银行不能将数据保存到微伴后端中,因此银行定制自定义卡片,将对应url配置为从请求银行后端以获取敏感信息的前端页面,以保证敏感数据安全。
已有功能集成到侧边栏
将企业私有的网页集成到侧边栏中,企业员工在侧边栏可以直接通过企业微信侧边栏与其后端服务器进行交互,以方便员工操作,避免造成员工在多个页面之间进行跳转操作。
例如:企业已有一个提交工单、导入订单的网页,企业可以创建自定义卡片,卡片链接设置为提交工单、导入订单网页的url,将这些卡片集成到侧边栏,员工就可以在侧边栏上对应的卡片上提交工单、导入订单。
流程图

接入指南#

流程概述#

接入步骤#

1.
实现一个自定义卡片后端服务器。后端需要实现一个接收code的后端接口。后端主要用来接收code,调用 OpenAPI接口获取数据,向前端返回数据。
2.
实现一个自定义卡片前端页面并挂载在后端服务器上。前端会以iframe方式引入到**「客户画像」**侧边栏中。前端页面应该处理来自员工的交互,并根据情况调用【前端sdk接口】控制主体页面(即客户画像页面)的行为。同时因为前端会向后端服务器请求数据,前端需要维护登录态以防止被恶意攻击。
3.
创建和配置自定义卡片模块。建议可见范围仅设置为开发者,以方便调试。
4.
微伴侧边栏预览和调试。在可见范围内的企微账号中,打开侧边栏即可预览和调试卡片。
交互时序图:
image.png

后端服务器#

接收code的后端接口#

企业开发者需要在卡片后端开发该接口,暴露给微伴侧边栏进行调用。
员工打开侧边栏,此时初始化卡片,侧边栏会向卡片链接发起请求,请求中携带code,企业开发者需要在卡片链接对应的服务中配置接收code的后端接口。
请求方式:GET
请求地址:IFRAME_URL?corp_id=CORP_ID&code=CODE&origin=ORIGIN
query参数:
参数类型必填说明
corp_idstr是公司id
codestr是信息兑换凭证
originstr是请求源
返回渲染页面

自定义卡片模块创建和配置#

创建自定义卡片模块#

1.
进入**「侧边栏管理」页面,点击「客户画像」,可以选择「单聊画像」或是「群聊画像」进行画像的配置管理,选择「单聊画像」**,添加自定义画像;
image.png
1.
选择**「添加自定义画像」**,输入画像名称,选择客服成员,只有选中的客服成员可见该侧边栏
image.png
2.
选择**「新增画像卡片」**
image.png
1.
编辑**「新增画像卡片」页面,卡片链接需要填入公网网页链接。开启「默认隐藏」**卡片会在侧边栏不可见,但是卡片前端代码依然会在侧边栏运行,卡片可以持续与后端交互,达到触发条件时,卡片可以调用wb.changeCardProperty使卡片可见。
image.png

配置自定义卡片布局#

例如企业可以通过修改卡片的间距和高度,使得侧边栏的布局更加紧凑;例如企业可以选择勾选需要的卡片进行展示来精简侧边栏的布局;例如企业可以长按卡片并拖动以改变卡片展示的顺序

修改卡片的间距和高度#

1.
选择**「画像卡片」**工单信息进行修改
image.png
2.
在**「修改卡片」**页面,将卡片的高度由600改为400,将卡片的上边距由150改为50
image.png
image.png
3.
在**「侧边栏展示」**页面,侧边栏的卡片高度、上边距修改生效
image.png

API列表#

OpenAPI接口#

侧边栏自定义卡片开发高度依赖于微伴助手OpenAPI
微伴助手OpenAPI文档
OpenAPI 接口需要由开发者后端调用,不可由前端直接调用。调用时需要走 OpenAPI标准授权。

获取当前员工和客户信息#

开放身份校验 -自定义侧边栏身份校验
接口将会返回客户id(staff_id),客户id(external_user_id)等信息。
根据这些信息通过OpenAPI的其他接口例如 获取员工详情,获取客户详情 等进行进一步的数据开发。

前端sdk接口#

功能概述#

前端sdk通过数据存取和自定义事件接口,给自定义卡片开发者提供了纯前端的跨卡片/iframe通信和数据传输的能力,让开发者无需通过后端接口就能在多个同页面的卡片间共享数据或进行交互联动

引入JS文件#

在需要调用JS接口的页面引入如下JS文件:https://mpa.oss-cn-hangzhou.aliyuncs.com/weiban-prod/weiban-client-js-sdk.0.2.js
示例
<script src="https://mpa.oss-cn-hangzhou.aliyuncs.com/weiban-prod/weiban-client-js-sdk.0.2.js"></script>
Copy

刷新页面#

刷新微伴页面
wb.refresh()
Copy

显示对话框#

toast 类型#

显示一个toast
wb.showDialog("toast", toastType, message)
Copy
参数说明
参数类型说明
toastType"success" \"warning" \"error"成功 \警告 \失败
messagestring弹出消息

全屏页面类型#

显示一个全屏页面,页面会用iframe方式载入,行为和自定义卡片一致
wb.showDialog("page", url)
Copy
参数说明
参数类型说明
urlstring页面链接

抽屉类型#

在页面底部显示一个抽屉,抽屉会用iframe方式载入,行为和自定义卡片一致
wb.showDialog("drawer", url, height)
Copy
参数说明
参数类型说明
urlstring页面链接
heightnumber弹窗高度,设计稿对应750px

变更卡片属性#

设置卡片可见性#

wb.changeCardProperty("visibility", value)
Copy
参数说明
参数类型说明
value"visible" \"hidden"可见 \隐藏

设置卡片高度#

wb.changeCardProperty("height", value)
Copy
参数说明
参数类型说明
valuenumber卡片高度,设计稿对应750px

设置卡片上边距#

wb.changeCardProperty("marginTop", value)
Copy
参数说明
参数类型说明
valuenumber卡片上边距,设计稿对应750px

数据存取#

给自定义卡片开发者提供了纯前端的跨卡片/iframe数据传输的能力,让开发者无需通过后端接口就能在多个同页面的卡片间共享数据

获取数据#

wb.getStorageData(scope,key,callback)
Copy
参数说明
参数类型说明
scope"session" \"target" \"global"session:临时会话,页面刷新消失target:针对同一个聊天对象是持久化的,多次打开对应同一聊天对象的侧边栏时数据不会消失global:持久会话,所有聊天对象都可以访问,页面刷新不会消失
keystring需要获取值的键
callbackfunction回调方法,参数为获取到的值

赋值数据#

wb.setStorageData(scope,key,value)
Copy
参数说明
参数类型说明
scope"session" \"target" \"global"session:临时会话,页面刷新消失target:针对同一个聊天对象是持久化的,多次打开对应同一聊天对象的侧边栏时数据不会消失global:持久会话,所有聊天对象都可以访问,页面刷新不会消失
keystring需要赋值的键
valuestring需要赋值的值

自定义事件#

给自定义卡片开发者提供了纯前端的跨卡片/iframe通信能力,让开发者无需通过后端接口就能在多个同页面的卡片间进行交互联动

设置自定义事件监听器#

wb.addCustomEventListener(eventName,handler)
Copy
参数说明
参数类型说明
eventNamestring事件名
handlerfunction需要处理的回调函数

发送自定义事件#

wb.sendCustomEvent(eventName,data)
Copy
参数说明
参数类型说明
eventNamestring事件名
dataany传递的数据

发送消息到当前会话框#

// 发送方式
wb.sendCustomEvent('WB_SEND_CHAT_MESSAGE',{data})

//监听发送消息的调用返回
wb.addCustomEventListener('WB_SEND_CHAT_MESSAGE',(res)=>{
	console.log(res)
})
参数说明
参数类型说明
eventNameWB_SEND_CHAT_MESSAGE指定事件名
data如下介绍传递的数据

代码demo#

侧边栏模块化的示例代码
上一页
获取雷达客户访问记录
下一页
自定义侧边栏Code校验
Built with