## 開發者模式消息及事件格式 ### 接入和結束會話事件 1、接入會話事件：system\_notify\_in\_receive ~~~ { "App_Type":?"yunh5", "ChannelId":?"15033", "ChannelName":?"xy007", "Content":?"", "CreateTime":?1697444398, "FromUserName":?799533513, "MsgId":?"652cf22e7a3ca", "Event":?"system_notify_in_receive", "StaffId":?null, "StaffName":?"\\\\u5728\\\\u7ebf\\\\u5ba2\\\\u670d", "ToBusiness":?true, "ToUserName":?"lkkk1", "ChatSessionId":?"20211", "wechatapp\_id":?"211079" } ~~~ 2、結束會話事件：system\_notify\_out\_receive ~~~ { "App_Type":?"yunh5", "ChannelId":?"15033", "ChannelName":?"xy007", "Content":?"", "CreateTime":?1697444398, "FromUserName":?799533513, "MsgId":?"652cf22e7a3ca", "Event":?"system_notify_out_receive", "StaffId":?null, "StaffName":?"在線客服", "ToBusiness":?true, "ToUserName":?"lkkk1", "ChatSessionId":?"20211", "wechatapp_id":?"211079" } ~~~ ### 小程序C端消息和事件 1.C端文本 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": 1482048670, "MsgType": "text", "Content": "this is a test", "MsgId": 1234567890123456 } ``` 2.C端圖片 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": 1482048670, "MsgType": "image", "PicUrl": "this is a url", "MediaId": "media_id", "MsgId": 1234567890123456 } ``` 3.C端小程序卡片 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": 1482048670, "MsgType": "miniprogrampage", "MsgId": 1234567890123456, "Title":"title", "AppId":"appid", "PagePath":"path", "ThumbUrl":"", "ThumbMediaId":"" } ``` 4. C端進入會話事件 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": 1482048670, "MsgType": "event", "Event": "user_enter_tempsession", "SessionFrom": "sessionFrom" } ``` 5、其他C端事件可參考微信開發者文檔 ### 公眾號C端消息和事件 1、文本消息 ``` json { "Content": "哈哈哈", "CreateTime": "1688444107", "FromUserName": "oRjZX59v2IYoARjcVUA3OgB_5QsQ", "MsgId": "24172710472080493", "MsgType": "text", "ToBusiness": false, "ToUserName": "gh_bba8f05106a1" } ``` 2、圖片消息 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": "1348831860", "MsgType": "image", "PicUrl": "this is a url", "MediaId": "media_id", "MsgId": "1234567890123456", "ToBusiness": false // 標記是否為客服發送消息 } ``` 3、語音消息 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": "1357290913", "MsgType": "voice", "MediaId": "media_id", "Format": "Format", "MsgId": "1234567890123456", "ToBusiness": false // 標記是否為客服發送消息 } ``` 4、視頻消息 ``` json { "ToUserName": "toUser", "FromUserName": "fromUser", "CreateTime": "1357290913", "MsgType": "video", "MediaId": "media_id", "ThumbMediaId": "thumb_media_id", "MsgId": "1234567890123456", "ToBusiness": false // 標記是否為客服發送消息 } ``` 5、關注、取關事件 ``` json { "ToUserName": "toUser", "FromUserName": "FromUser", "CreateTime": "123456789", "MsgType": "event", "Event": "subscribe", // subscribe：關注，unsubscribe：取關 "ToBusiness": false // 標記是否為客服發送消息 } ``` 6、掃描渠道二維碼關注 ``` json { "ToUserName": "toUser", "FromUserName": "FromUser", "CreateTime": "123456789", "MsgType": "event", "Event": "subscribe", "EventKey": "qrscene_123123", // 渠道二維碼的key，用于判斷是來自哪個渠道二維碼 "Ticket": "TICKET", "ToBusiness": false // 標記是否為客服發送消息 } ``` 7、掃描渠道二維碼事件（已關注粉絲掃碼） ``` json { "ToUserName": "toUser", "FromUserName": "FromUser", "CreateTime": "123456789", "MsgType": "event", "Event": "SCAN", "EventKey": "SCENE_VALUE", // 渠道二維碼的key，用于判斷是來自哪個渠道二維碼 "Ticket": "TICKET", "ToBusiness": false // 標記是否為客服發送消息 } ``` 8、點菜單事件（click） ``` json { "ToUserName": "toUser", "FromUserName": "FromUser", "CreateTime": "123456789", "MsgType": "event", "Event": "CLICK", // click一般用于點菜單后回復消息 "EventKey": "EVENTKEY" } ``` 9、點菜單跳轉鏈接（跳轉網址或者跳轉小程序） ``` json { "ToUserName": "toUser", "FromUserName": "FromUser", "CreateTime": "123456789", "MsgType": "event", "Event": "VIEW", "EventKey": "www.qq.com", //跳轉網址則為網址，跳轉小程序則為小程序的pagepath "MenuId": "MENUID", //菜單ID，點擊的是個性化菜單時，可以通過這個字段，知道是哪個規則的菜單被點擊了 "ToBusiness": false // 標記是否為客服發送消息 } ``` 10、其他消息和時間類型可以參考官方文檔 ### B端客服回復消息 1、文本消息 ~~~ { ? ?"App_Type": "wechat_kefu", ? ?"ChannelId": "14777", ? ?"ChannelName": "咸魚測試1", ? ?"MsgType": "text", ? ?"Content": "啦啦啦", ? ?"CreateTime": 1688441501, ? ?"FromUserName": "799533439", ? ? // 客服的uid ? ?"StaffId": "18186158229", ? ?// 客服登錄賬號 ? ?"StaffName": "管理員", ? ? ? // 客服昵稱 ? ?"MsgId": "64a3929d8e4df", ? ?"ToBusiness": false, ? ?"ToUserName": "h51a51-1688026512803-37275.0.14777" } ~~~ 2、圖片/視頻/語音/文件消息 ~~~ { ? ?"App_Type": "wechat_kefu", ? ?"ChannelId": "14777", ? ?"ChannelName": "咸魚測試1", ? ?"Content": "[這里是圖片/視頻/語音/文件消息的url鏈接]", ? ?"CreateTime": 1688442150, ? ?"FromUserName": "799533439", ? ?"MsgId": "oyeVrJ83bSzVxFMdkktuQVkUXDrhYgko", ? ?"MsgType": "image", ? ?"StaffId": "18186158229", ? ?"StaffName": "管理員", ? ?"ToBusiness": true, ? ?"ToUserName": "h51a51-1688026512803-37275.0.14777" } ~~~ 3、圖文消息 ~~~ { "App_Type": "yunh5", "ChannelId": "14777", "ChannelName": "咸魚測試1", "Content": "[這里是圖片的url鏈接]", "CreateTime": 1688443210, "Description": "這里是圖文的描述", "FromUserName": "799533439", "MsgId": "64a39949423e9", "MsgType": "multiple", "StaffId": "18186158229", "StaffName": "管理員", "Title": "這里是圖文的標題", "ToBusiness": true, "ToUserName": "h51a51-1688026512803-37275.0.14777", "Url": "[這里是跳轉的url鏈接]" } ~~~ 4、小程序卡片 ~~~ { "AppId": "wxf57cf2affa38e55d", "App_Type": "official_account", "Content": "[這里是圖片的url鏈接]", "CreateTime": 1688444505, "FromUserName": "799533439", "MsgId": "64a39e5784983", "MsgType": "miniprogrampage", "PagePath": "pages/index/index", "StaffId": "18186158229", "StaffName": "管理員", "Title": "[卡片標題]", "ToBusiness": true, "ToUserName": "oRjZX59v2IYoARjcVUA3OgB_5QsQ" } ~~~