164 lines
8.4 KiB
C#
164 lines
8.4 KiB
C#
|
/*--------------------------------------------------------------------------
|
|||
|
|
* ServiceAdminAPI.cs
|
|||
|
|
*Auth:deepleo
|
|||
|
|
* Date:2015.01.15
|
|||
|
|
* Email:2586662969@qq.com
|
|||
|
|
* Website:http://www.weixinsdk.net
|
|||
|
|
*--------------------------------------------------------------------------*/
|
|||
|
|
|
|||
|
|
using System;
|
|||
|
|
using System.Collections.Generic;
|
|||
|
|
using System.Linq;
|
|||
|
|
using System.Text;
|
|||
|
|
using System.Net.Http;
|
|||
|
|
using Codeplex.Data;
|
|||
|
|
using System.IO;
|
|||
|
|
|
|||
|
|
namespace Deepleo.Weixin.SDK
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 客服管理
|
|||
|
|
/// http://mp.weixin.qq.com/wiki/9/6fff6f191ef92c126b043ada035cc935.html
|
|||
|
|
/// </summary>
|
|||
|
|
public class ServiceAdminAPI
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取客服基本信息
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic GetServiceInfo(string access_token)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token={0}", access_token);
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.GetAsync(url).Result;
|
|||
|
|
return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取在线客服接待信息
|
|||
|
|
/// kf_account 完整客服账号，格式为：账号前缀@公众号微信号
|
|||
|
|
/// status 客服在线状态 1：pc在线，2：手机在线。若pc和手机同时在线则为 1+2=3
|
|||
|
|
/// kf_id 客服工号
|
|||
|
|
/// auto_accept 客服设置的最大自动接入数
|
|||
|
|
/// accepted_case 客服当前正在接待的会话数
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic GetOnlineServiceInfo(string access_token)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token={0}", access_token);
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.GetAsync(url).Result;
|
|||
|
|
return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 添加客服账号
|
|||
|
|
/// 开发者通过本接口可以为公众号添加客服账号，每个公众号最多添加10个客服账号。
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <param name="kf_account">完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。如果没有公众号微信号，请前往微信公众平台设置。</param>
|
|||
|
|
/// <param name="nickname">客服昵称，最长6个汉字或12个英文字符</param>
|
|||
|
|
/// <param name="pswmd5">客服账号登录密码，格式为密码明文的32位加密MD5值</param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic AddService(string access_token, string kf_account, string nickname, string pswmd5)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("https://api.weixin.qq.com/cgi-bin/media/uploadnews?access_token={0}", access_token);
|
|||
|
|
var builder = new StringBuilder();
|
|||
|
|
builder
|
|||
|
|
.Append("{")
|
|||
|
|
.Append('"' + "kf_account" + '"' + ":").Append(kf_account).Append(",")
|
|||
|
|
.Append('"' + "nickname" + '"' + ":").Append(nickname).Append(",")
|
|||
|
|
.Append('"' + "password" + '"' + ":").Append(pswmd5)
|
|||
|
|
.Append("}");
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.PostAsync(url, new StringContent(builder.ToString())).Result;
|
|||
|
|
return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 设置客服信息
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <param name="kf_account">完整客服账号，格式为：账号前缀@公众号微信号，账号前缀最多10个字符，必须是英文或者数字字符。如果没有公众号微信号，请前往微信公众平台设置。</param>
|
|||
|
|
/// <param name="nickname">客服昵称，最长6个汉字或12个英文字符</param>
|
|||
|
|
/// <param name="pswmd5">客服账号登录密码，格式为密码明文的32位加密MD5值</param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic UpdateService(string access_token, string kf_account, string nickname, string pswmd5)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("https://api.weixin.qq.com/customservice/kfaccount/update?access_token={0}", access_token);
|
|||
|
|
var builder = new StringBuilder();
|
|||
|
|
builder
|
|||
|
|
.Append("{")
|
|||
|
|
.Append('"' + "kf_account" + '"' + ":").Append(kf_account).Append(",")
|
|||
|
|
.Append('"' + "nickname" + '"' + ":").Append(nickname).Append(",")
|
|||
|
|
.Append('"' + "password" + '"' + ":").Append(pswmd5)
|
|||
|
|
.Append("}");
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.PostAsync(url, new StringContent(builder.ToString())).Result;
|
|||
|
|
return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 上传客服头像
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <param name="kf_account">完整客服账号，格式为：账号前缀@公众号微信号</param>
|
|||
|
|
/// <param name="icon"></param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic UploadIcon(string access_token, string kf_account, string icon)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("http://api.weixin.qq.com/customservice/kfacount/uploadheadimg?access_token={0}&kf_account={1}", access_token, kf_account);
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.PostAsync(url, new StreamContent(new FileStream(icon, FileMode.Open, FileAccess.Read)));
|
|||
|
|
if (!result.Result.IsSuccessStatusCode) return string.Empty;
|
|||
|
|
var media = DynamicJson.Parse(result.Result.Content.ReadAsStringAsync().Result);
|
|||
|
|
return media.media_id;
|
|||
|
|
}
|
|||
|
|
/// <summary>
|
|||
|
|
/// 删除客服账号
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="access_token"></param>
|
|||
|
|
/// <param name="kf_account"></param>
|
|||
|
|
/// <returns>success: {"errcode" : 0,"errmsg" : "ok",}； 其他代码请使用ExplainCode解析返回代码含义 </returns>
|
|||
|
|
public static dynamic DeleteService(string access_token, string kf_account)
|
|||
|
|
{
|
|||
|
|
var url = string.Format("https://api.weixin.qq.com/customservice/kfaccount/del?access_token={0}&kf_account={1}", access_token, kf_account);
|
|||
|
|
var client = new HttpClient();
|
|||
|
|
var result = client.GetAsync(url).Result;
|
|||
|
|
return DynamicJson.Parse(result.Content.ReadAsStringAsync().Result);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 解释客服管理接口返回码说明
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="opercode"></param>
|
|||
|
|
/// <returns></returns>
|
|||
|
|
public static string ExplainCode(int code)
|
|||
|
|
{
|
|||
|
|
switch (code)
|
|||
|
|
{
|
|||
|
|
case 0:
|
|||
|
|
return "成功(no error)";
|
|||
|
|
case 61451:
|
|||
|
|
return "参数错误(invalid parameter)";
|
|||
|
|
case 61452:
|
|||
|
|
return "无效客服账号(invalid kf_account)";
|
|||
|
|
case 61453:
|
|||
|
|
return "账号已存在(kf_account exsited)";
|
|||
|
|
case 61454:
|
|||
|
|
return "账号名长度超过限制(前缀10个英文字符)(invalid kf_acount length)";
|
|||
|
|
case 61455:
|
|||
|
|
return "账号名包含非法字符(英文+数字)(illegal character in kf_account)";
|
|||
|
|
case 61456:
|
|||
|
|
return "账号个数超过限制(10个客服账号)(kf_account count exceeded)";
|
|||
|
|
case 61457:
|
|||
|
|
return "无效头像文件类型(invalid file type)";
|
|||
|
|
default:
|
|||
|
|
return "";
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|