微信公众号开发教程[007]-消息管理-客服消息

        微信公众号现在提供客服功能啦,在粉丝与公众号产生特定的互动后,微信允许开发者在48小时内,调用客服接口,给粉丝发送消息.目前允许提供客服的动作如下(摘自官方文档):

 

1、用户发送信息
2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权

 

        

        客服功能需要另外开通,并且需要微信认证之后的公众号才能开通.开通方式为:微信官方后台管理->添加功能插件->客服务功能.

 

 

        在开通了客服并在功能中进行相应的设置之后,在官方管理后台的"功能"项目下,应该会多一项"多客服"的栏目(可自由选择是否需要多客服).如下:

        微信公众号的客服功能api主要有客服账号管理和发送客服消息2大类.客服账号管理又分为添加,删除,修改,查询客服账号,以及设置客服账号头像等功能.发送客服消息即可以以某个客服帐号来发送(即是多客服),也可以以通用的形式来发送.重申一下:客服账号管理api只能在认证了的真实公众号上能用,发送客服消息在测试号上就能用.

        客服账号管理api有2个比较重要的参数需要说明下.

        1).kf_account,这个是完整的客服账号.格式为:客服账号名@公众号微信号.要注意的是,@后面的不是原始ID:

 

        也不是AppID:

        这些ID都是针对开发者的,申请公众号后,由微信官方给定的;公众号微信号是针对普通用户的,可以由开发者自己填写.比如,查询用户的微信号,可以添加新朋友,查询公众号的微信号,可以添加公众号.

        公众号的微信号如下:

 

2).password,这个是客服账号登录密码,为密码明文的32位加密MD5值.该密码仅用于公众平台官网的多客服功能,若不使用多客服功能,则不必设置密码.

 

        发送客服消息api有个比较重要的参数需要说明下.

1).如果要以某个客服帐号来发消息,则需在JSON数据包的后半部分加入customservice参数.例如:

以通用的形式来发送的json应该是

 

{"touser": "oe5SXv71irmrQ0TH-JxA-z_hmYLE", "msgtype": "text", "text": {"content": "您确实要购买这款产品么?"}}

 

而以某个客服帐号来发送的json应该是:

 

{"touser": "oe5SXv71irmrQ0TH-JxA-z_hmYLE", "msgtype": "text", "text": {"content": "您确实要购买这款产品么?"}, "customservice": {"kf_account": "kf001@little_shadow"}}

 

 

 

 

 

        现在开始偿试调用这些接口.

 

access_token;
	return $ACCESS_TOKEN;
}

function add() { //添加客服帐号
	$ACCESS_TOKEN = "ArA-yA6R5WVQ2e8mahm9a9xmZITNxaCwQiGzXSDuubWMidsR7MMJJ365hxsw5d3fQUTO5hmTR46TqZcQdnLw8Me9-aJ_TBS35NgUq8Cu_EfCXvGazRKSI649vWlzySrkANIcAFAMZU";
	$url = "https://api.weixin.qq.com/customservice/kfaccount/add?access_token=$ACCESS_TOKEN";
	$data = '{"kf_account": "kf001@little_shadow", "nickname": "小薇", "password": "99b1ff8f11781541f7f89f9bd41c4a17"}';
	$result = curl_http_post($url, $data);
	echo $result;
}

function edit() { //修改客服帐号
	$ACCESS_TOKEN = "ArA-yA6R5WVQ2e8mahm9a9xmZITNxaCwQiGzXSDuubWMidsR7MMJJ365hxsw5d3fQUTO5hmTR46TqZcQdnLw8Me9-aJ_TBS35NgUq8Cu_EfCXvGazRKSI649vWlzySrkANIcAFAMZU";
	$url = "https://api.weixin.qq.com/customservice/kfaccount/update?access_token=$ACCESS_TOKEN";
	$data = '{"kf_account": "kf001@little_shadow", "nickname": "爱大米", "password": "a644e388830bc71053255a0cc17d4da4"}';
	$result = curl_http_post($url, $data);
	echo $result;
}

function delete() { //删除客服帐号
	$ACCESS_TOKEN = "ArA-yA6R5WVQ2e8mahm9a9xmZITNxaCwQiGzXSDuubWMidsR7MMJJ365hxsw5d3fQUTO5hmTR46TqZcQdnLw8Me9-aJ_TBS35NgUq8Cu_EfCXvGazRKSI649vWlzySrkANIcAFAMZU";
	$url = "https://api.weixin.qq.com/customservice/kfaccount/del?access_token=$ACCESS_TOKEN";
	$data = '{"kf_account": "kf001@little_shadow", "nickname": "爱大米", "password": "a644e388830bc71053255a0cc17d4da4"}';
	$result = curl_http_get($url, $data);
	echo $result;
}

function thumb() { //设置客服帐号的头像
	$ACCESS_TOKEN = "ArA-yA6R5WVQ2e8mahm9a9xmZITNxaCwQiGzXSDuubWMidsR7MMJJ365hxsw5d3fQUTO5hmTR46TqZcQdnLw8Me9-aJ_TBS35NgUq8Cu_EfCXvGazRKSI649vWlzySrkANIcAFAMZU";
	$url = "http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=$ACCESS_TOKEN&kf_account=kf001@little_shadow";
	$result = curl_http_upload($url, "media", "a.jpg");
	echo $result;
}

function query() { //获取所有客服账号
	$ACCESS_TOKEN = "ArA-yA6R5WVQ2e8mahm9a9xmZITNxaCwQiGzXSDuubWMidsR7MMJJ365hxsw5d3fQUTO5hmTR46TqZcQdnLw8Me9-aJ_TBS35NgUq8Cu_EfCXvGazRKSI649vWlzySrkANIcAFAMZU";
	$url = "https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=$ACCESS_TOKEN";
	$result = curl_http_get($url);
	echo $result;
}

function reply() { //发消息文本消息
	$ACCESS_TOKEN = "ZoSCh7gwNhiubWy9qG3cs33_Kjblhue7rpDe3YMoAetxxKewpFKSQe3HPOlIBsAOb-npvmfslUvBuyAGIBrfRYuY1JI00NAF57l4X-sf57PESMCSFPlhtnJQdKyw4gtMTGPcACABOX";
	$url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=$ACCESS_TOKEN";
	$data = '{"touser": "oe5SXv71irmrQ0TH-JxA-z_hmYLE", "msgtype": "text", "text": {"content": "您确实要购买这款产品么?"}}';
	$result = curl_http_post($url, $data);
	echo $result;
}
?>