2. 程式人生 > >微信開發之客服訊息的使用

微信開發之客服訊息的使用

阿新 • • 發佈：2018-12-24

之前的訊息傳送與接收都是使用者給微信發一條，之後微信回覆給使用者，也就是API上面所說的被動回覆訊息，那麼微信是否支援主動給關注使用者發訊息嗎，答案是肯定的，但是卻有一些限制。看下微信開發文件上怎麼說就明白了：

當用戶主動發訊息給公眾號的時候（包括髮送資訊、點選自定義選單、訂閱事件、掃描二維碼事件、支付成功事件、使用者維權），微信將會把訊息資料推送給開發者，開發者在一段時間內（目前修改為48小時）可以呼叫客服訊息介面，通過POST一個JSON資料包來發送訊息給普通使用者，在48小時內不限制傳送次數。此介面主要用於客服等有人工訊息處理環節的功能，方便開發者為使用者提供更加優質的服務。

這次就針對客服訊息分享下我的心得和體會

1  客服介面-發訊息介面使用說明

介面呼叫請求說明

各訊息型別所需的JSON資料包如下：

傳送文字訊息

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    }
}

傳送圖片訊息

{
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    {
      "media_id":"MEDIA_ID"
    }
}

傳送語音訊息

{
    "touser":"OPENID",
    "msgtype":"voice",
    "voice":
    {
      "media_id":"MEDIA_ID"
    }
}

......,基本上來說常用的訊息型別，客服介面都是支援的

2  封裝客服訊息介面

       public static String makeTextCustomMessage(String openId,String content){
		content.replace("\"", "\\\"");
		String jsonMsg="{\"touser\":\"%s\",\"msgtype\":\"text\",\"text\":{\"content\":\"%s\"}}";
		return String.format(jsonMsg, openId,content);
		
	}
	
	/**
	 * 組裝圖片客服訊息
	 * 
	 * @param openId 訊息傳送物件
	 * @param mediaId 媒體檔案id
	 * @return
	 */
	public static String makeImageCustomMessage(String openId, String mediaId) {
		String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"image\",\"image\":{\"media_id\":\"%s\"}}";
		return String.format(jsonMsg, openId, mediaId);
	}

	/**
	 * 組裝語音客服訊息
	 * 
	 * @param openId 訊息傳送物件
	 * @param mediaId 媒體檔案id
	 * @return
	 */
	public static String makeVoiceCustomMessage(String openId, String mediaId) {
		String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"voice\",\"voice\":{\"media_id\":\"%s\"}}";
		return String.format(jsonMsg, openId, mediaId);
	}

	/**
	 * 組裝視訊客服訊息
	 * 
	 * @param openId 訊息傳送物件
	 * @param mediaId 媒體檔案id
	 * @param thumbMediaId 視訊訊息縮圖的媒體id
	 * @return
	 */
	public static String makeVideoCustomMessage(String openId, String mediaId, String thumbMediaId) {
		String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"video\",\"video\":{\"media_id\":\"%s\",\"thumb_media_id\":\"%s\"}}";
		return String.format(jsonMsg, openId, mediaId, thumbMediaId);
	}

	/**
	 * 組裝音樂客服訊息
	 * 
	 * @param openId 訊息傳送物件
	 * @param music 音樂物件
	 * @return
	 */
	public static String makeMusicCustomMessage(String openId, Music music) {
		String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"music\",\"music\":%s}";
		jsonMsg = String.format(jsonMsg, openId, JSONObject.fromObject(music).toString());
		// 引數名稱替換 @20140125
		jsonMsg = jsonMsg.replace("musicUrl", "musicurl");
		jsonMsg = jsonMsg.replace("HQMusicUrl", "hqmusicurl");
		jsonMsg = jsonMsg.replace("thumbMediaId", "thumb_media_id");
		return jsonMsg;
	}

	/**
	 * 組裝圖文客服訊息
	 * 
	 * @param openId 訊息傳送物件
	 * @param articleList 圖文訊息列表
	 * @return
	 */
	public static String makeNewsCustomMessage(String openId, List<Article> articleList) {
		String jsonMsg = "{\"touser\":\"%s\",\"msgtype\":\"news\",\"news\":{\"articles\":%s}}";
		jsonMsg = String.format(jsonMsg, openId, JSONArray.fromObject(articleList).toString().replaceAll("\"", "\\\""));
		// 將jsonMsg中的picUrl替換為picurl
		jsonMsg = jsonMsg.replace("picUrl", "picurl");
		return jsonMsg;
	}

	public static boolean sendCustomMessage(String token,String jsonMsg){
		boolean flag=false;
		//String accessToken=getAccessToken("xxxx","xxxx").getToken();
		String requestUrl="https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN";
		requestUrl=requestUrl.replace("ACCESS_TOKEN", token);
		JSONObject jsonResult=CommonUtil.httpsRequest(requestUrl, "POST", jsonMsg);
		if(jsonResult!=null){
			int errorCode=jsonResult.getInt("errcode");
			String errorMessage=jsonResult.getString("errmsg");
			if(errorCode==0){
				flag=true;
			}else{
				System.out.println("客服訊息傳送失敗:"+errorCode+","+errorMessage);
				flag=false;
			}
		}
		return flag;
	}

3 呼叫客服訊息傳送介面給指定使用者傳送客服訊息 
List<Article> all=new ArrayList<Article>();
		
	
		
		Article a2=new Article();
		a2.setDescription("最崇拜的明星Justin Timberlake");
		a2.setPicUrl("http://img3.douban.com/view/photo/photo/public/p1408738004.jpg");
		a2.setTitle("賈斯汀·汀布萊克(Justin Timberlake),1981年1月31日出生於美國田納西州孟菲斯市，美國男歌手、演員、音樂製作人、主持人，前男子演唱組合超級男孩成員。");
		a2.setUrl("http://baike.haosou.com/doc/3382630-3560934.html?from=1358&sid=3560934&redirect=search");
		
		all.add(a2);
		
		
		String articleMsg=makeNewsCustomMessage("xxx", all);
		boolean res=sendCustomMessage(token,articleMsg);
		if(res){
			System.out.println("客服訊息傳送成功");
		}else{
			System.out.println("客服訊息傳送失敗");
		}

到這裡程式就寫好了，來看下執行效果：


4  多客服的使用

多客服功能主要用於處理需人工操作、耗時較長的場景，我們都知道如果微信伺服器在5秒鐘沒給使用者返回訊息則會出現“公眾號暫時無法提供服務”。這樣使用者體驗會很差，有這種情況不妨考慮下多客服。

個人建議是可以把多客服看成是一種比較特別的訊息型別，這樣的話只需修改一下MessageUtil就OK了，加入如下程式碼:

 /** 
     * 客服訊息物件轉換成xml 
     *  
     * @return xml 
     */  
    public static String customMessageToXml(CustomServiceMessage customServiceMessage) {  
    	
        xstream.alias("xml", customServiceMessage.getClass());  
        return xstream.toXML(customServiceMessage);  
    }

並且加一種訊息型別： 
    /** 
     * 多客服訊息
     */  
    public static final String TRANSFER_CUSTOMER_SERVICE = "transfer_customer_service";


5  修改微信訊息處理核心工具類 
 // 文字訊息  
 if (msgType.equals(MessageUtil.REQ_MESSAGE_TYPE_TEXT)) { 
       String content=requestMap.get("Content");
       if(content.startsWith("人工客服")){
            	CustomServiceMessage cus=new CustomServiceMessage();
            	cus.setToUserName(fromUserName);  
            	cus.setFromUserName(toUserName);  
            	cus.setCreateTime(new Date().getTime());  
            	cus.setMsgType(MessageUtil.TRANSFER_CUSTOMER_SERVICE);  
            	TransInfo t=new TransInfo();
            	t.setKfAccount("你的客服賬號");
            	cus.setTransInfo(t);	
            	respMessage=MessageUtil.customMessageToXml(cus);
            		
        }else{
            respContent = "您傳送的是文字訊息！"; 
        }
                
}
順帶貼上CustomServiceMessage和TransInfo的程式碼： 
package com.debug.weixin.message.res;

import com.debug.weixin.pojo.TransInfo;

public class CustomServiceMessage extends BaseMessage {
	private TransInfo TransInfo;

	public TransInfo getTransInfo() {
		return TransInfo;
	}

	public void setTransInfo(TransInfo transInfo) {
		TransInfo = transInfo;
	}

}	


package com.debug.weixin.pojo;

public class TransInfo {
	private String KfAccount;

	public String getKfAccount() {
		return KfAccount;
	}

	public void setKfAccount(String kfAccount) {
		KfAccount = kfAccount;
	}
}

上面的程式碼如需測試需使用微信關注“多客服助手”或下載安裝“windows多客服”，具體參照如下連結：

這裡在貼2個我的執行截圖：

下面是windows的客戶端，就類似QQ的介面


差不多就這樣子了

相關推薦

微信開發之客服訊息的使用

之前的訊息傳送與接收都是使用者給微信發一條，之後微信回覆給使用者，也就是API上面所說的被動回覆訊息，那麼微信是否支援主動給關注使用者發訊息嗎，答案是肯定的，但是卻有一些限制。看下微信開發文件上怎麼說就明白了： 當用戶主動發訊息給公眾號的時候（包括髮送資訊、點選自定義選單、

微信小程式客服訊息實時通知之最佳實踐

我們做微信小程式開發的都知道，只要在小程式頁面中新增如下程式碼即可進入小程式的客服會話介面：  <button open-type="contact" >聯絡我們</button>  微信小程式客服會話介面如下圖所示： 但是，客戶給我們小程式發的訊息，微信伺服器並不會通知小程式管

微信小程式客服訊息之解決方案

小程式自公開發布起就有訊息推送功能，但由於張小龍對於微信小程式的定義為極簡的生活方式，所以為了避免小程式傳送過多的推送訊息騷擾使用者對於小程式訊息推送制定了許多的規則和限制。 一、小程式客服訊息的意義： 為豐富小程式的服務能力，提高服務質量，微信為小程式提供客服訊息能

【最佳實踐】微信小程式客服訊息實時通知如何快速低成本實現？

我們做微信小程式開發的都知道，只要在小程式頁面中新增如下程式碼即可進入小程式的客服會話介面： <button open-type="contact" >聯絡我們</button> 微信小程式客服會話介面如下圖所示：

asp傳送微信公眾號客服訊息原始碼

asp寫的，微信公眾號傳送客服訊息原始碼，支援文字傳送，圖文傳送，帶連結的文字傳送等，比模板訊息更靈活，適合很多應用場景，費話不說，上原始碼： <% Call Wx.C_A(“wx_token”)'呼叫函式，如果當前的token有效則不動，否則重新獲取並寫

微信小程式客服訊息授權給第三方Udesk

微信小程式客服訊息可能授權給第三方Udesk 一、必須是微信認證過的微信小程式 登入微信小程式後臺-設定-基本設定 連結：https://mp.weixin.qq.com/ 下面有一欄：微信認證（看是否認證） 二、以管理員身份登入Udesk後臺 1、地址：http://ud

微信小程式---客服訊息介面呼叫，拿來即用

<button open-type="contact" class='contactService' session-from="{{'https://https://mp.weixin.qq.com/debug/wxadoc/introduction/imag

微信開發-傳送客服訊息

模板訊息不好稽核通過，因此有時候我們需要傳送客服訊息。 客服訊息在傳送“圖文訊息”的時候不會夾帶客服圖示，而是一整塊的訊息，體驗相對比較好。 下邊描述一下發送客服訊息的大概過程。 1、公眾號配置 傳送客服訊息需要應用的服務響應線上，因此首先在公眾平臺進行配置（開發-&

技術小白之記錄微信小程式客服功能

程式做到上線，必不可缺的便是使使用者在使用你製作的程式時，能夠反饋回一些建議，這就需要客服的功能了。 客服功能，官方微信上有提供專門的元件，如下： 客服訊息會話入口有兩個： 1、小程式內：開發者在小程式內新增客服訊息按鈕元件，使用者可在小程式內喚起客服會話頁面，給小程式發訊息； 2、已使

微信開發之獲取openid及推送模板訊息

有很多的朋友再問我怎麼獲取code，openid之類的問題，在這裡我就給大家分享一下。 在做微信支付是需要獲取openid的，推送模板訊息也是需要openid包括其他一些功能分享等也都是需要的，openid是什麼呢，這裡給大家解釋一下，是使用者在公眾號中的一個標識，就相當於你資料表中的I

微信開發之傳送訊息介面

傳送訊息，是指使用者公眾號向用戶傳送相應形式的訊息。根據微信開發文件，由以下四種形式：被動回覆，群發介面，客服訊息介面以及模板訊息介面。本文將基於Java語言以及個人微信測試號，說明被動回覆、客服訊息介

微信公眾號客服介面給指定使用者openid傳送訊息

微信開發文件: 客服介面-發訊息 介面呼叫請求說明 http請求方式: POST https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN 各訊息型別所需的

微信公眾平臺 客服介面-發訊息

微信公眾平臺技術文件：客服訊息 一、介面說明 當用戶和公眾號產生特定動作的互動時（具體動作列表請見下方說明），微信將會把訊息資料推送給開發者，開發者可以在一段時間內（目前修改為48小時）呼叫客服介面，通過POST一個JSON資料包來發送訊息給普通使用者。

微信公眾號客服系統訊息能即時提醒嗎？

微信公眾號的客服系統，當有使用者在後臺留言的時候，網頁版客服系統只能通過提示聲音來判斷，不會彈出訊息提醒。所以只能採用戴耳機安音響這種方式了嘛？當然不是，你需要的是一款可以訊息即時提醒的微信公眾號客服系統--米多客客服。1. 及時溝通的能力通過米多客客服軟體，打破了微信公眾平

php微信開發之帶參數二維碼的使用

cor odin ews json 保存 explode 想要 int gty 最近做微信PC端網頁微信相關功能的開發，從一個新手的角度來說，微信公眾號的文檔還是不好理解的，網上找的帖子大都也都基本上是復制微信公眾平臺上給的文檔，開發微信帶參數二維碼過程中還是遇到不少坑的，

微信開發之網頁授權

個人信息 ati 關註 技術分享 lin base 定義 技術 參數 第一步:成為開發者 　　在自己的公眾號點擊基本配置,點擊基本配置,填寫服務器配置 Url服務器地址是微信回調地址，必須以 http://或https://開頭，端口號必須為80或443。 Token令

武漢微信開發之小程序開發，應該從哪些方面做起？

如果 不同 你是 實踐 可能 了解 上帝 內容 簡單的 很多武漢微信開發的從業者不知道微信小程序開發應該從哪些方面做起，究其原因，大概是大多數武漢微信開發從業者都是技術出身，而不知道微信小程序開發也是應該從運營角度去考慮的。技術不懂運營，這個是所有開發類行業中的硬傷。所以，

微信開發之消息接收--文本消息(三)

事件 圖片 over ret ken .text tin equals char 一、消息格式 1 <xml> 2 <ToUserName>< ![CDATA[toUser] ]> 3 </ToUserNam

微信開發之消息回復--圖文消息(四)

轉換 turn ews exce 默認 nal ini equal 介紹 一、消息格式 1 <xml> 2 <ToUserName> 3 < ![CDATA[toUser] ]> 4 </T

微信紅包人工客服電話是多少

電話O755-85OOO6O3微信紅包人工客服電話是多少O755-32914926撥通後請再按225#鍵或者226#鍵分機號切記雖然網上經常有刷單被騙的新聞傳出，雖然有法律人士說這個行業屬於灰色，但仍算是一個不錯的選擇。因為時間自由，雖然不能賺大錢，但收入也還能讓人基本滿意，主要是如果找對平臺，投入很少收益卻