微信开发指南

微客服致力于为开发者提供极致用户体验的多渠道在线客服系统,包括 App、微信、web/h5等. 官网SDK下载.

注解

个别地区会因为移动运营商的原因造成域名解析错误, 从而无法连接普通服务器, 所以需要使用ip服务器. Weixin端需要使用ip服务器链接, 同时客服也需要登录ip服务器

一. 准备工作

  1. 登录 管理后台,到 我的应用 页面,点击 创建应用 并保存
  2. 创建工作组, 并将相应的 ‘工作组ID’ 填写到 js代码 中相应的位置
  3. 分配客服,使用分配的客服账号登录 PC客服端下载
  4. 微信公众号后台->开发->基本设置->IP白名单->配置ip:121.40.237.122 和 121.41.95.114
  5. 在web管理后台添加微信公众号信息, 添加公众号信息
  6. 在web管理后台-微信公众号详情页面, 点击 ‘绑定工作组’, 将第二步创建的工作组绑定到微信公众号上面
  7. 微信公众号后台添加业务域名: 设置->公众号设置->功能设置->业务域名 和 JS接口安全域名 中添加: free.weikefu.net

小技巧

说明:在新的应用创建过程中,请尽量填写准确的信息,便于我们为您提供更加周到的服务

_images/web1.jpg _images/web2.jpg _images/web3.jpg

二. 微信自定义菜单 && 微商城

替换以下链接的“工作组ID”为第一步中分配的:工作组ID

1
http://free.weikefu.net/AppKeFu/weikefu/weixin/chat.php?wg=工作组ID&robot=false

或者使用ip服务器:

1
http://free.weikefu.net/AppKeFu/floatip/weixin/chat.php?wg=工作组ID&robot=false

举例:假如你的客服工作组ID为: wgdemo, 则你的自定义菜单链接应该为:

1
http://free.weikefu.net/AppKeFu/weikefu/weixin/chat.php?wg=wgdemo&robot=false

或者使用ip服务器

1
http://free.weikefu.net/AppKeFu/floatip/weixin/chat.php?wg=wgdemo&robot=false
  1. 电商模式

    涉及参数:goods, goodspic, goodsname, goodsprice, goodsurl

    1
    2
    3
    4
    5
    6
    7
    8
    参数解释: 1. goods, 是否显示电商模块,取值:true:显示, false:不显示
    2.goodspic, 商品图片, 内容请填写可以访问的图片url网址
    3.goodsname, 商品简介
    4.goodsprice,商品价格
    5.goodsurl, 商品链接
    参数具体位置请参考下图
    参考实例:goods=true&goodspic=http://weikefu.net/AppKeFu/images/dingyue.jpg&goodsname=电冰箱家用电器&goodsprice=2000&goodsurl=http://weikefu.net
    例如: http://free.weikefu.net/AppKeFu/weikefu/weixin/chat.php?wg=wgdemo&robot=false&goods=true&goodspic=http://weikefu.net/AppKeFu/images/dingyue.jpg&goodsname=电冰箱家用电器&goodsprice=2000&goodsurl=http://weikefu.net
    
  2. 机器人应答

    涉及参数:robot

    1
    2
    3
    参数解释:
    robot, 如果设置robot=false,则默认接入人工客服,
    如果设置robot=true,则默认接入机器人应答
    

    注解

    注意:需要首先在管理后台设置机器人应答内容

  3. 附言

    涉及参数:postscript

    1
    2
    参数解释:postscript, 当成功对接客服之后,自动发送此参数内容给客服
    参考实例:postscript=这里是附言消息
    
  4. 自定义聊天窗口标题和logo

    涉及参数:hidenav, title, logopic

    1
    2
    3
    4
    5
    6
    参数解释:
    1.hidenav, 是否隐藏顶部导航, 如果要隐藏设置为true,否则设置为false
    1.title, 对话窗口标题
    2.logopic, 对话窗口logo图片,参数内容请填写 可访问的图片url网址
    参数具体位置请参考下图
    参考实例:hidenav=false&title=测试标题&logopic=http://free.weikefu.net/AppKeFu/weikefu/web/img/kefu-avatar.png
    
  5. 自定义客服头像

    涉及参数:hideavatar, kefuavatar

    1
    2
    3
    4
    5
    参数解释:
    1.hideavatar, 是否显示头像,取值: true,隐藏头像不显示; false,显示客服头像
    2.kefuavatar, 客服头像图片网址,参数你内容为可访问的图片url网址
    隐藏客服头像参考实例: hideavatar=true&kefuavatar=任意值不起作用
    自定义客服头像参考实例:hideavatar=false&kefuavatar=http://weikefu.net/AppKeFu/images/dingyue.jpg
    
  6. 聊天记录

    参数history, 可选值: true(显示聊天记录) 或者 false(隐藏聊天记录)

    显示聊天记录:

    1
    http://free.weikefu.net/AppKeFu/weikefu/weixin/chat.php?wg=工作组ID&robot=false&history=true
    

    隐藏聊天记录:

    1
    http://free.weikefu.net/AppKeFu/weikefu/weixin/chat.php?wg=工作组ID&robot=false&history=false
    

三. 对接客服接口

提示

点击每张图片,查看大图

_images/weixin_detail.jpg _images/weixin_detail2.jpg _images/weixin_detail3.jpg

四. 其他

提示

更新日期:2017/11/22, 技术交流QQ群:474794719