客服消息接口

class wechatpy.client.api.WeChatCustomService(client=None)[源代码]
add_account(account, nickname, password)[源代码]

添加客服账号 详情请参考 http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html

参数
  • account – 完整客服账号,格式为:账号前缀@公众号微信号

  • nickname – 客服昵称,最长6个汉字或12个英文字符

  • password – 客服账号登录密码

返回

返回的 JSON 数据包

close_session(openid, account, text=None)[源代码]

多客服关闭会话 详情请参考 http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html

参数
  • openid – 客户 openid

  • account – 完整客服账号

  • text – 附加信息,可选

返回

返回的 JSON 数据包

create_session(openid, account, text=None)[源代码]

多客服创建会话 详情请参考 http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html

参数
  • openid – 客户 openid

  • account – 完整客服账号

  • text – 附加信息,可选

返回

返回的 JSON 数据包

delete_account(account)[源代码]

删除客服账号 详情请参考 http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html

参数

account – 完整客服账号,格式为:账号前缀@公众号微信号

返回

返回的 JSON 数据包

get_accounts()[源代码]

获取客服账号列表 详情请参考 http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html

返回

客服账号列表

get_online_accounts()[源代码]

获取在线客服接待信息 详情请参考 http://mp.weixin.qq.com/wiki/9/6fff6f191ef92c126b043ada035cc935.html

返回

客服接待信息列表

get_records(start_time, end_time, msgid=1, number=10000)[源代码]

获取客服聊天记录

参数
  • start_time – 查询开始时间,UNIX 时间戳

  • end_time – 查询结束时间,UNIX 时间戳,每次查询不能跨日查询

  • msgid – 消息id顺序从小到大,从1开始

  • number – 每次获取条数,最多10000条

返回

返回的 JSON 数据包

get_session(openid)[源代码]

获取客户的会话状态 详情请参考 http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html

参数

openid – 客户 openid

返回

返回的 JSON 数据包

get_session_list(account)[源代码]

获取客服的会话列表 详情请参考 http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html

参数

account – 完整客服账号

返回

客服的会话列表

get_wait_case()[源代码]

获取未接入会话列表 详情请参考 http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html

返回

返回的 JSON 数据包

update_account(account, nickname, password)[源代码]

更新客服账号 详情请参考 http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html

参数
  • account – 完整客服账号,格式为:账号前缀@公众号微信号

  • nickname – 客服昵称,最长6个汉字或12个英文字符

  • password – 客服账号登录密码

返回

返回的 JSON 数据包

upload_headimg(account, media_file)[源代码]

上传客服账号头像 详情请参考 http://mp.weixin.qq.com/wiki/1/70a29afed17f56d537c833f89be979c9.html

参数
  • account – 完整客服账号

  • media_file – 要上传的头像文件,一个 File-Object

返回

返回的 JSON 数据包