微信公眾號 客服消息

當(dāng)用戶和公眾號產(chǎn)生特定動作的交互時（具體動作列表請見下方說明），微信將會把消息數(shù)據(jù)推送給開發(fā)者，開發(fā)者可以在一段時間內(nèi)（目前修改為48小時）調(diào)用客服接口，通過POST一個JSON數(shù)據(jù)包來發(fā)送消息給普通用戶。此接口主要用于客服等有人工消息處理環(huán)節(jié)的功能，方便開發(fā)者為用戶提供更加優(yōu)質(zhì)的服務(wù)。

目前允許的動作列表如下（公眾平臺會根據(jù)運(yùn)營情況更新該列表，不同動作觸發(fā)后，允許的客服接口下發(fā)消息條數(shù)不同，下發(fā)條數(shù)達(dá)到上限后，會遇到錯誤返回碼，具體請見返回碼說明頁）：

1、用戶發(fā)送信息
2、點(diǎn)擊自定義菜單（僅有點(diǎn)擊推事件、掃碼推事件、掃碼推事件且彈出“消息接收中”提示框這3種菜單類型是會觸發(fā)客服接口的）
3、關(guān)注公眾號
4、掃描二維碼
5、支付成功
6、用戶維權(quán)

為了幫助公眾號使用不同的客服身份服務(wù)不同的用戶群體，客服接口進(jìn)行了升級，開發(fā)者可以管理客服賬號，并設(shè)置客服賬號的頭像和昵稱。該能力針對所有擁有客服接口權(quán)限的公眾號開放。

另外，請開發(fā)者注意，本接口中所有使用到media_id的地方，現(xiàn)在都可以使用素材管理中的永久素材media_id了。

客服帳號管理

開發(fā)者在根據(jù)開發(fā)文檔的要求完成開發(fā)后，使用6.0.2版及以上版本的微信用戶在與公眾號進(jìn)行客服溝通，公眾號使用不同的客服賬號進(jìn)行回復(fù)后，用戶可以看到對應(yīng)的客服頭像和昵稱。

請注意，必須先在公眾平臺官網(wǎng)為公眾號設(shè)置微信號后才能使用該能力。

添加客服帳號

開發(fā)者可以通過本接口為公眾號添加客服賬號，每個公眾號最多添加10個客服賬號。該接口調(diào)用請求如下：

http請求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

返回說明（正確時的JSON返回結(jié)果）：

{
     "errcode" : 0,
     "errmsg" : "ok",
}

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息

修改客服帳號

開發(fā)者可以通過本接口為公眾號修改客服賬號。該接口調(diào)用請求如下：

http請求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

返回說明（正確時的JSON返回結(jié)果）：

{
     "errcode" : 0,
     "errmsg" : "ok",
}

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息

刪除客服帳號

開發(fā)者可以通過該接口為公眾號刪除客服帳號。該接口調(diào)用請求如下：

http請求方式: GET
https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

返回說明（正確時的JSON返回結(jié)果）：

{
     "errcode" : 0,
     "errmsg" : "ok",
}

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息

設(shè)置客服帳號的頭像

開發(fā)者可調(diào)用本接口來上傳圖片作為客服人員的頭像，頭像圖片文件必須是jpg格式，推薦使用640*640大小的圖片以達(dá)到最佳效果。該接口調(diào)用請求如下：

http請求方式: POST/FORM
http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
調(diào)用示例：使用curl命令，用FORM表單方式上傳一個多媒體文件，curl命令的具體用法請自行了解

返回說明（正確時的JSON返回結(jié)果）：

{
     "errcode" : 0,
     "errmsg" : "ok",
}

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息

獲取所有客服賬號

開發(fā)者通過本接口，獲取公眾號中所設(shè)置的客服基本信息，包括客服工號、客服昵稱、客服登錄賬號。

http請求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

返回說明（正確時的JSON返回結(jié)果）：

{
    "kf_list": [
        {
            "kf_account": "test1@test", 
            "kf_nick": "ntest1", 
            "kf_id": "1001"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
        }, 
        {
            "kf_account": "test2@test", 
            "kf_nick": "ntest2", 
            "kf_id": "1002"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }, 
        {
            "kf_account": "test3@test", 
            "kf_nick": "ntest3", 
            "kf_id": "1003"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }
    ]
}

錯誤時微信會返回錯誤碼等信息，請根據(jù)錯誤碼查詢錯誤信息

接口的統(tǒng)一參數(shù)說明

客服接口-發(fā)消息

接口調(diào)用請求說明

http請求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

各消息類型所需的JSON數(shù)據(jù)包如下：

發(fā)送文本消息

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

發(fā)送圖片消息

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

發(fā)送語音消息

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

發(fā)送視頻消息

{
    "touser":"OPENID",
    "msgtype":"video",
    "video":
    {
      "media_id":"MEDIA_ID",
      "thumb_media_id":"MEDIA_ID",
      "title":"TITLE",
      "description":"DESCRIPTION"
    }
}

發(fā)送音樂消息

{
    "touser":"OPENID",
    "msgtype":"music",
    "music":
    {
      "title":"MUSIC_TITLE",
      "description":"MUSIC_DESCRIPTION",
      "musicurl":"MUSIC_URL",
      "hqmusicurl":"HQ_MUSIC_URL",
      "thumb_media_id":"THUMB_MEDIA_ID" 
    }
}

發(fā)送圖文消息（點(diǎn)擊跳轉(zhuǎn)到外鏈） 圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過8，則將會無響應(yīng)。

{
    "touser":"OPENID",
    "msgtype":"news",
    "news":{
        "articles": [
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         },
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         }
         ]
    }
}

發(fā)送圖文消息（點(diǎn)擊跳轉(zhuǎn)到圖文消息頁面） 圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過8，則將會無響應(yīng)。

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

發(fā)送卡券

{
  "touser":"OPENID", 
  "msgtype":"wxcard",
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"        
            },
}

特別注意客服消息接口投放卡券僅支持非自定義Code碼和導(dǎo)入code模式的卡券的卡券。

請注意，如果需要以某個客服帳號來發(fā)消息（在微信6.0.2及以上版本中顯示自定義頭像），則需在JSON數(shù)據(jù)包的后半部分加入customservice參數(shù)，例如發(fā)送文本消息則改為：

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    },
    "customservice":
    {
         "kf_account": "test1@kftest"
    }
}

接口返回說明

返回數(shù)據(jù)示例（正確時的JSON返回結(jié)果）：