微信公众号接口调用说明之三:素材文件管理(v5.0)
    2021-12-15
  
前期工作

  调用微信公众号接口前,请先熟悉微信公众平台开发的前期准备工作与接口调用模式,具体详情请参考:
  https://mp.weixin.qq.com/wiki

1、添加客服帐号

调用方法
  
weixin::wx_cs_add()

相关参数

  共2个必选参数,具体如下:
   1、完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符
   2、客服昵称,最长16个字

调用实例
  
weixin::wx_cs_add('cs1@kyger','客服一号');

2、删除客服帐号

调用方法
  
weixin::wx_cs_del()

相关参数

  共1个必选参数,具体如下:
   1、待删除的完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符

调用实例
  
weixin::wx_cs_del('cs1@kyger');

3、更新客服帐号

调用方法
  
weixin::wx_cs_update()

相关参数

  共2个必选参数,具体如下:
   1、完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符
   2、客服昵称,最长16个字

调用实例
  
weixin::wx_cs_update('cs1@kyger','凯格客服');

4、上传客服头像

调用方法
  
weixin::wx_cs_headimg()

相关参数

  共2个必选参数,具体如下:
   1、完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符
   2、上传文件物理路径

调用实例
  
weixin::wx_cs_headimg('cs1@kyger','/demo.jpg');

5、邀请绑定客服帐号

调用方法
  
weixin::wx_cs_headimg()

相关参数

  共2个必选参数,具体如下:
   1、完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符
   2、接收绑定邀请的客服微信号

调用实例
  
weixin::wx_cs_headimg('cs1@kyger','kyger1305');

6、转发消息至微信客服

  当微信用户在公众号发送消息后,如果需要将该消息转发至微信客服,则需要使用weixin::transfer_service()方法将消息转至腾讯多客服系统。

调用方法
  
weixin::transfer_service()

相关参数

  共1个必选参数,具体如下:
   1、转发到指定客服的客服账号

调用实例
  
weixin::transfer_service('cs1@kyger');

7、获取客服基本信息

调用方法
  
weixin::wx_cs_list()

相关参数

  无

调用实例
  
$cs_list = weixin::wx_cs_list();

返回结果

  返回一维数组,其中"kf_list"为客服列表,二维数组,其结构为:
   $cs_list['kf_list'][0]['kf_account']:完整客服帐号,格式为:帐号前缀@公众号微信号
   $cs_list['kf_list'][0]['kf_headimgurl']:客服头像
   $cs_list['kf_list'][0]['kf_id']:客服编号
   $cs_list['kf_list'][0]['kf_nick']:客服昵称
   $cs_list['kf_list'][0]['invite_wx']:如果客服帐号尚未绑定微信号,但是已经发起了一个绑定邀请, 则此处显示绑定邀请的微信号
   $cs_list['kf_list'][0]['invite_expire_time']:如果客服帐号尚未绑定微信号,但是已经发起过一个绑定邀请, 邀请的过期时间,为unix 时间戳
   $cs_list['kf_list'][0]['invite_status']:邀请的状态,有等待确认“waiting”,被拒绝“rejected”, 过期“expired”

8、获取客服在线状态

调用方法
  
weixin::wx_cs_online()

相关参数

  无

调用实例
  
$cs_status = weixin::wx_cs_online();

返回结果

  返回一维数组,其中"kf_online_list"为客服状态列表,二维数组,其结构为:
   $cs_status['kf_online_list'][0]['kf_account']:完整客服帐号,格式为:帐号前缀@公众号微信号号
   $cs_status['kf_online_list'][0]['status']:客服在线状态,目前为:1、web 在线
   $cs_status['kf_online_list'][0]['kf_id']:客服编号
   $cs_status['kf_online_list'][0]['accepted_case']:客服当前正在接待的会话数

9、获取客户会话状态

调用方法
  
weixin::wx_cs_get_session()

相关参数

  共1个参数,具体如下:
   1、粉丝的openid

调用实例
  
$cs_session = weixin::wx_cs_get_session('abc');

返回结果

  返回一维数组,其中"kf_online_list"为客服状态列表,二维数组,其结构为:
   $cs_session['kf_online_list'][0]['createtime']:正在接待的客服,为空表示没有人在接待
   $cs_session['kf_online_list'][0]['kf_account']:会话接入的时间

10、关闭会话

调用方法
  
weixin::wx_cs_session_close()

相关参数

  共2个参数,具体如下:
   1、完整客服帐号,格式为:帐号前缀@公众号微信号
   2、粉丝的openid

调用实例
  
$result= weixin::wx_cs_session_close('cs1@kyger','abc');
if($result['errcode'] == 0){
    echo '关闭成功';
}else{
    echo $result['errmsg'];
}