### 聚客通微信scrm客服系統通信協議 # 一、網絡通訊協議 datalength+databytes 的自定義長度的協議，其中： datalength：緊跟其后的databytes的數據長度（不包含自身長度），占4字節 databytes：protobuf 3.0協議數據序列化后的數據內容，長度不限 # 二、網絡應答模型 1、業務消息 服務端客戶端間的消息大致分為以下四類： 1）通知類消息 通常由客戶端發往服務器端，或者由服務器端發往客服客戶端，接收方一般需要作出接收確認回復或不回復(默認成功異常時回復)。 2）客戶端同步請求類消息 通常由手機客戶端或客服客戶端發出，服務端需要回復對應的響應消息。 3）服務器端指令類消息 通常是由服務器或者客服客戶端發出的操作手機客戶端的指令類消息，手機客戶端收到后一般需要回復接收成功確認消息，并在后續執行完指令后回復發送結果通知消息。 客戶端在與服務器建立連接后，需要先發送\*\*\*\*DeviceAuthReq\*\*\*\*請求獲取accesstoken后才能正常進行后續通信 2、心跳機制 已于服務器建立連接的客戶端需要每隔1分鐘發送一個心跳包 # 三、Protobuf消息定義 所有業務消息都轉化為protobuf消息進行序列化后傳輸，不同命令對應的消息使用protobuf的Any類型嵌套入根消息，接收方在收到根消息后根據命令碼反序列化為相應類型消息。 \*\*\*\*消息結構定義基本約定：\*\*\*\* 1）使用proto3語法 2）package 命名空間統一采用 \*\*\*\*Jubo.JuLiao.IM.Wx.Proto\*\*\*\* 3）消息命名采用 \*\*\*\*Pascal命名法\*\*\*\*，例如 FirstName,LastName 4）時間字段統一用\*\*\*\*Unix-Timestamp\*\*\*\*形式 5）message類型名全部為對應\*\*\*\*MsgType+Message\*\*\*\*后綴，如MsgType=DeviceAuthReq的消息的消息結構名定義為 message DeviceAuthReqMessage{} \*\*\*\*根消息（TransportMessage）\*\*\*\* 根消息代表最終直接序列化為網絡字節流的消息，其中應包含基本的發送方信息(用于授權認證)和其包含的具體的業務命令消息及命令碼標識。 所有的其他類型的消息都應該賦值到根消息的Content字段，并將MsgType字段設為對應值，之后將TransportMessage數據序列化做網絡傳輸。接收方在收到消息后根據MsgType將Content內容反序列化成對應的強類型消息。 ## **1、基礎消息類型** 1、客戶端發送的心跳包 HeartBeatReq = 1001; 2、消息接收確認回復（接收或拒絕接收） MsgReceivedAck = 1002; 3、錯誤單獨提升為一種消息類型 Error = 1003; ## **2、設備客戶端授權類消息** 1、設備(手機客戶端、客服客戶端)獲取通信token請求 DeviceAuthReq = 1010; 2、設備(手機客戶端、客服客戶端)獲取通信token響應 DeviceAuthRsp = 1011; 3、設備授權后退出(僅用于服務端內部) DeviceExitNotice = 1012; 4、賬號強制下線通知 AccountForceOfflineNotice = 1013; ## **3、手機客戶端上傳的通知類消息** 1、手機客戶端微信上線通知 WeChatOnlineNotice = 1020; 2、手機客戶端微信下線通知 WeChatOfflineNotice = 1021; 3、微信個人號新增好友通知 FriendAddNotice = 1022; 4、微信個人號移除好友通知 FriendDelNotice = 1023; 5、微信好友發來聊天消息 FriendTalkNotice = 1024; 6、任務執行結果通知 TaskResultNotice = 1025; 7、手機上回復好友的聊天消息 WeChatTalkToFriendNotice = 1026; 8、有好友請求添加好友的通知 FriendAddReqeustNotice = 1027; 9、手機端向服務端通知聊天執行結果 TalkToFriendTaskResultNotice = 1028; 10、圖片或視頻消息的詳細內容結果 RequestTalkDetailTaskResultNotice = 1029; 11、上傳手機客戶端上微信的二維碼 PullWeChatQrCodeTaskResultNotice = 1030; 12、手機上發送了朋友圈通知 CircleNewPublishNotice = 1031; 13、手機上刪除朋友圈通知 CircleDelNotice = 1032; 14、手機檢測到有人點贊/取消點贊通知 CircleLikeNotice = 1033; 15、手機檢測到有人評論/刪除朋友圈通知 CircleCommentNotice = 1034; 16、消息標記為已讀 PostMessageReadNotice = 1035; 17、聯系人信息上傳 ContactsInfoNotice = 1036; 18、群聊新增通知 ChatRoomAddNotice = 1037; 19、聯系人標簽新增，修改通知 ContactLabelAddNotice = 1038; 20、收錢任務執行結果通知 TakeMoneyTaskResultNotice = 1039; 21、朋友圈圖片上傳 CircleDetailNotice = 1040; 22、群聊刪除通知 ChatRoomDelNotice = 1041; 23、群聊信息變更通知 ChatRoomChangedNotice = 1042; 24、群二維碼 PullChatRoomQrCodeTaskResultNotice = 1043; ## **4、服務端、客服客戶端發給設備的指令類消息** 1、給好友發消息任務 TalkToFriendTask = 1070; 2、發送朋友圈任務 PostSNSNewsTask = 1071; 3、主動添加好友任務 AddFriendsTask = 1072; 4、發送朋友圈任務后數據回傳 PostSNSNewsTaskResultNotice = 1073; 5、刪除朋友圈 DeleteSNSNewsTask = 1074; 6、客戶端或者服務端接受好友請求通知 AcceptFriendAddRequestTask = 1075; 7、群發消息任務 WeChatGroupSendTask = 1076; 8、執行養號動作命令 WeChatMaintenanceTask = 1077; 9、請求圖片或視頻消息的詳細內容 RequestTalkDetailTask = 1078; 10、服務端主動要求手機上傳當前登錄的微信二維碼 PullWeChatQrCodeTask = 1079; 11、觸發手機推送好友列表任務 TriggerFriendPushTask = 1080; 12、觸發手機推送朋友圈列表任務 TriggerCirclePushTask = 1081; 13、朋友圈評論刪除任務 CircleCommentDeleteTask = 1082; 14、朋友圈評論刪除任務反饋 CircleCommentDeleteTaskResultNotice = 1083; 15、朋友圈評論回復任務 CircleCommentReplyTask = 1084; 16、朋友圈評論回復反饋 CircleCommentReplyTaskResultNotice = 1085; 17、通知手機將某個聊天窗口置為已讀 TriggerMessageReadTask = 1086; 18、消息撤回 RevokeMessageTask = 1087; 19、轉發消息 ForwardMessageTask = 1088; 20、通知手機推送聊天記錄 TriggerHistoryMsgPushTask = 1089; 21、獲取群聊二維碼 PullChatRoomQrCodeTask = 1090; ## **5、服務端通知執行的命令** 1、服務端通知pc客戶版本升級 UpgradeAppNotice = 1093; 2、通知手機客戶端軟件升級 UpgradeDeviceAppNotice = 1094; 3、清粉任務 PostFriendDetectTask = 1095; 4、終止清粉任務 PostStopFriendDetectTask = 1096; 5、刪除設備通知 PostDeleteDeviceNotice = 1097; 6、朋友圈點贊任務 PostMomentsPraiseTask = 1098; 7、停止朋友圈點贊任務 PostStopMomentsPraiseTask = 1099; 8、養號任務停止 PostStopWeChatMaintenanceTask = 1100; 9、修改備注任務 ModifyFriendMemoTask = 1101; 10、領取紅包或轉賬 TakeLuckyMoneyTask = 1200; 11、獲取指定好友朋友圈 PullFriendCircleTask = 1201; 12、獲取朋友圈圖片 PullCircleDetailTask = 1202; 13、單條朋友圈點贊任務 CircleLikeTask = 1203; 14、觸發手機推送群聊列表 TriggerChatroomPushTask = 1210; 15、請求具體群聊的詳細信息 RequestChatRoomInfoTask = 1211; 16、獲取聯系人詳細信息（不一定是好友，如群聊成員） RequestContactsInfoTask = 1212; 17、群聊管理 ChatRoomActionTask = 1213; 18、群內加好友 AddFriendInChatRoomTask = 1214; 19、通訊錄加好友 AddFriendFromPhonebookTask = 1215; 20、刪除好友 DeleteFriendTask = 1216; 21、發紅包 SendLuckyMoneyTask = 1217; 22、獲取聊天消息的原始內容（主要是xml內容） RequestTalkContentTask = 1218; 23、返回聊天消息的原始內容 RequestTalkContentTaskResultNotice = 1219; 24、轉發消息內容 ForwardMessageByContentTask = 1220; ## **6、手機端主動發出的交互類消息** 1、手機端推送好友列表 FriendPushNotice = 2026; 2、手機端推送當前安裝版本 PostDeviceInfoNotice = 2027; 3、手機端回傳檢測清粉好友數 PostFriendDetectCountNotice = 2028; 4、手機回傳朋友圈數據 CirclePushNotice = 2029; 5、手機回傳朋友圈點贊數量 PostMomentsPraiseCountNotice = 2030; 9、手機端推送群聊列表 ChatroomPushNotice = 2031; 7、手機端推送標簽列表 ContactLabelInfoNotice = 2032; 8、推送歷史消息 HistoryMsgPushNotice = 2033; 9、群成員（陌生人）信息 ChatRoomMembersNotice = 2034; sdk適用于微信營銷軟件研發、微信營銷手機研發、微信手機群控云控系統研發、微信SCRM客服系統研發、微信營銷工具研發等，很多scrm都是基于這個sdk二次開發的。 項目地址https://www.wuliaokankan.cn/url301/138.html