# scrm_mobile_command **Repository Path**: hjb410/scrm_mobile_command ## Basic Information - **Project Name**: scrm_mobile_command - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2018-12-25 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 版本 |版本号|内容| |:-:|:-:| |v1.0|微信指令| |v1.1|修改通用结构| |v1.2|增加Extra附带参数 增加微客服和微信映射 发朋友圈可带评论 增加若干设备控制指令| |v1.2.1|发送朋友圈 屏蔽 单词拼写错误| |v1.2.2|修改导入联系人参数| |v1.2.3|微客服和微信好友映射表| |v1.2.4|修改app设置| |v1.2.5|微信图片保存| |v1.2.6|增加微信宿主id字段| |v1.2.7|增加指派设备调用业务端接口指令| # 概述 为了方便扩展以及理解 该协议参照了http协议的定义 `区分大小` ## 通用结构 #### 发送指令 ``` GET /wechat/friend/list 1\r\n //协议头 方法[空格]访问路径[空格]指令序列 自增整型 HostWxId:""\r\n// *必填参数 宿主微信ID Extra:{}\r\n //可选 回调时附带此内容 Content:{}\r\n //POST PUT参数 选填 ``` 和`http`类似的发送指令方法有 `GET` `POST` `DELET` `PUT` #### 响应(暂不需要 响应通过回调http实现) ``` 1 200 OK\r\n //响应头 响应指令序列[空格]响应码[空格]消息 Message:OK\r\n //消息一般出错情况会该消息 ``` 响应码 `200` 成功 `404`客户端为未定义指令 `500`执行指令出错`502`与微信连接失败 `504`超时 ## 指令 # 微信 ### 微信备注 ### 获取 ``` GET /wechat/friend/{好友微信id}/remark ``` ##### 参数：无 ##### 返回 * 状态码:200/404/500 * Content:用户信息 * remark 备注 ### 修改或增加 ``` POST /wechat/friend/{好友微信id}/remark ``` ##### 参数 ： * remark 备注 ##### 返回 ： * 状态码:200/500 ### 删除 ``` DELETE /wechat/friend/{好友微信id}/remark ``` ##### 参数 ：无 ##### 返回 ： * 状态码:200/500 ##### ### 好友标签 ### 获取 ``` GET /wechat/friend/{好友微信id}/tag ``` ##### 参数：无 ##### 返回 * 状态码:200/404/500 ### 修改或增加 ``` POST /wechat/friend/{好友微信id}/tag ``` ##### 参数 ： * tag 不同标签以逗号分隔 ##### 返回 ： * 状态码:200/500 ### 删除 ``` DELETE /wechat/friend/{好友微信id}/tag ``` ##### 参数 ：无 ##### 返回 ： * 状态码:200/500 ### 加微信好友 ``` POST /wechat/friend ``` ##### 参数 ： * type : 添加类型 phone/wechat * identifier : 手机号/微信号 ##### 返回 ： * 状态码:200/500 ### 删除微信好友 ``` POST /wechat/friend/delete ``` ##### 参数 ： * wxId: 好友微信ID ##### 返回 ： * 状态码:200/500 ### 发朋友圈 ``` POST /wechat/circle ``` ##### 参数 ： * type : 仅文字txt 图文picture 视频video * permission : 私密 private 指定可见 protected 全可见 public 指定屏蔽 forbidden * tagList: [指定标签] * pictureList: [图片下载路径] * video: 视频下载路径 * videoThumbnail: 视频封面 * content: 文字内容 * commentList:[评论] * comment 评论内容 * delayTime 延时时间 单位：秒 ##### 返回 ： * 状态码:200/500 ### 微信配置 ### 获取 ``` GET /wecaht/settings ``` ##### 参数：无 ##### 返回 * 状态码:200/404/500 ### 修改 ``` POST /wechat/settings ``` ##### 参数 ： * save\_room\_image : 保存群图片 1 true 0 false * save\_chat\_image : 保存个人图片 1 true 0 false ##### 返回 ： * 状态码:200/500 ### 朋友圈点赞 ``` POST /wechat/circle/praise ``` ### 设置微客服和微信映射表 ``` POST /wechat/vmachat ``` #### 参数:[映射列表] * staff\_im\_id : string 微客服im账号 * wx_id : string 微信id ##### 参数 ：无 ### 设备管理 ### 风险控制 ``` GET /device/rish_management ``` ##### 参数：无 ``` POST /device/rish_management ``` ##### 参数: * use\_system\_luncher : 可选 返回系统桌面 1 true 0 false * use\_system\_settings : 可选 操作手机设置 * use\_wechat\_camera : 可选 使用微信摄像头 * use\_moblie\_camera : 可选 使用手机摄像头 * use\_wechat\_settings : 可选 使用微信设置 * use\_phone\_ assistant : 可选 使用语音助手 * use\_buletooth : 可选 蓝牙 * use\_usb : 可选 * use\_wechat\_scan : 可选 微信扫一扫 * use\_top\_search : 可选 顶部搜索栏 * set\_circle_background : 可选 设置朋友圈背景 * set\_wechat\_sign : 可选 微信签名 * upload\_call\_recording : 可选 通话录音上传 * upload\_phone\_message : 可选 短信上传 * view\_call\_history : 查看手机历史记录 * visible\_friend\_wxid : 好友微信号可见 * visible\_wechat\_chat\_phone\_number : 微信聊天消息号码可见 * view\_all\_app : 查看所有应用 * view\_phone\_task\_history : 查看手机历史任务 * register\_protect : 注册不保护 ### 检查更新 ``` GET /device/update ``` ##### 参数:无 ### APP设置 ``` POST /device/apps ``` ##### 参数: * list[应用消息] * package_name 应用名称 * status 启用 1 不启动 0 ### 导入联系人 ``` POST /device/contacts ``` #### 参数:[联系人] * list [联系人列表] * name : 姓名 * phone_number : 电话 * clear_local:导入联系人之前 是否清理本地联系人 1 true 0 false ### 群公告修改 ``` POST /wechat/room/announce ``` ##### 参数 ： * chatroomId : 群微信ID * announce : 公告内容 ##### 返回 ： * 状态码:200/500 ### 群踢人 ``` POST /wechat/room/remove/friends ``` ##### 参数 ： * chatroomId : 群微信ID * friendsId : 需要踢的微信ID列表,逗号隔开 ##### 返回 ： * 状态码:200/500 ### 群拉人 ``` POST /wechat/room/addFriends ``` ##### 参数 ： * chatroomId : 群微信ID * friendsId : 需要邀请的微信ID列表,逗号隔开 ##### 返回 ： * 状态码:200/500 ### 指派设备调用业务端接口 ``` POST /app/interface ``` ##### 参数 ： * type : 1获取群自动回复 2获取群行为管理 3获取群入群问候 4获取全局通过好友后自动回复指令入参 5获取个人号通过好友后自动回复指令入参 6新消息自动回复获取指令入参 7获取群发消息 ##### 返回 ： * 状态码:200/500 ### 给好友/群聊发消息 ``` POST /wechat/send_message ``` #### 参数:[消息列表] * list [消息列表] * 参考 IM_MESSAGE.md 中的消息类型 ##### 返回 ： * 状态码:200/500 ### 群消息发送 ``` POST /wechat/room/send ``` ##### 参数 ： * chatroomId : 群微信ID * atWxId : 需要艾特的微信人员ID，以“,”隔开（英文字母的逗号格式） * content : 发送的消息内容，如果atWxId不为空，则content必须带上“@wxId对应的wxName，并且结束后以空格隔开，多个atWxId，则有多个@，并且都已空格隔开” ##### 返回 ： * 状态码:200/500 ### 企业全局设置 ``` POST /enterprise/config ``` ##### 参数 ： * notSwitchGroup: 禁止转让群主状态 0关闭 1开启 * notDeleteFriend: 禁止删除好友状态 0关闭 1开启 ##### 返回 ： * 状态码:200/500