一、手机盒子使用

1. 连接手机盒子与 PC

1. 将手机盒子接上电源。使用 usb 数据线连接例子与 PC。 并打开手机盒子的电源
   
   

2. 打开手机盒子电源后，手机面板亮起蓝灯，表示手机服务器开始进行工作
   

2. 预览并远程操作手机

3. 更换手机主板

如何更换手机主板

4. 手机出现待授权如何处理

手机偶尔会出现丢失授权的情况。如果丢失授权就无法从 PC 操作手机。这时可以重启一下手机盒子，看授权是否能够自动恢复。如果授权无法恢复，则需要将手机主板从盒子中卸下寄给我们重新授权，重新授权完成后将手机主板插回手机盒子即可。

二、软件安装

下面的操作请按照顺序操作：

Step1：安装“企业微信群控”

群控只能安装在Windows电脑上。

用 Google 浏览器 Chrome 打开地址下载（用其它浏览器下载可能出错）：
https://software.gnlab.cn/rpaclient.wecom/install.exe

Step2：连接软硬件

用USB3.0的连接线，连接主机和手机（如果连接的手机超过10台，建议使用 USB hub 解决）。

如手机弹出以下提示，在进行下一步前必须在手机上点击确认。

Step3：在每台手机上安装框架

工具使用前，每台手机都需要安装框架。进入【企业微信群控】-【设备管理】-【点击选择待安装的APK文件】，逐个安装以下四个apk：

1. app-input.apk

2. app-wokload.apk

3. app-work.apk

4. wxwork_android（企业微信apk，如手机已安装企业微信，可以不安装）

5. Android 11 第一次使用，需要点击 '手机配置管理'|'APK 权限管理'|'授权APK 权限'， 然后在手机中手工给予设备权限 , 详细见 "常见问题"|"Android 11 初始化"
   
   

Step4：手机设置

检查输入法是否打开

某些手机上需要手工设置打开输入法，请在手机设置中打开语言和输入法，勾选 一个输入法

授予 APK 权限

操作如下：
Step1：在群控 '设备管理' 标签界面中勾选设备，点击 '手机配置管理'|'APK 权限管理'|'授予APK 权限'。
Step2：如果为 android 11 手机，并且 apk 没有相应的权限，则会在手机上弹出请求授权界面，请手工在此界面进行授权 。

设置允许后台运行

在华为某些机型上，会自动休眠后台控制，建议在设置 | 应用启动管理 中将 com.smart.GNZF.test 与 GNZF 设置为允许后台启动

全部勾选上或是起码选择允许后台活动

Step5：企业微信设置

手机端需要人工进入企业微信，过程中所有权限申请全部点击允许。

Step6：手机管理

给每个手机编号（贴纸、固定位置或换编号屏保），将群控系统中对应的手机名称修改为编号【设备管理】-【修改名称】，便于后期查找故障。

三、软件使用

1. 主动加人

视频版：

文字版本：

Step1：选择主动加人的方法

方法一：导入手机号或二维码

Step 1：设置格式

支持两种格式：
第一种格式——txt 格式

1. 一行一个手机号，或一行一个二维码 URL；

2. 使用【,】半角逗号分隔，手机号之后的内容都会被导入描述。

第二种格式——csv 格式（常用格式）：

1. 新建一个 Excel 表格；

2. 首列必须为“手机号”或者“二维码URL”，列名无规定；

3. 第二列，列名为“desc"或“描述”的内容，会导入到客户信息的描述中（≤150个字符）；

4. 第三列：列名为“tags"或"标签”的内容，也会导入“描述”中，后续可用 Quntool 转为标签 ；

5. 其它列的数据可以作为介绍语参数；

6. 另存为"CSV-UTF-8"格式。

如果发现中文乱码，修改文件编码为 UTF-8-BOM 编码格式，如何修改点这里 。

Step 2：选择添加客户方式

点击【引流加人】-【操作】-【选择添加客户方式】

方法二：API 号码源接口

详见：API 号码源接口

Step2：设置加好友介绍

当我们发送添加邀请时，用户会看到以下界面，再决定是否添加好友，因此这句话的文案非常重要。

“加好友介绍消息编辑器”可以设置邀请消息，以下是功能界面：

字段说明

• 不作处理 ：加好友时，介绍消息使用原来的内容模板，原来的内容模板可以通过手机查看。

• 设置为空白 ：加好友时，将自我介绍内容设置为空白

• 使用内容模板定制内容：加好友时，使用设定好的内容

内容模板
当启用“使用内容模板定制内容”，系统就会自动发送模板内容给用户。

例如，想要发送“XX先生/女士，你好，我在XX上看到了你的介绍，希望与你详谈”，只要输入以下内容：%FullName%%Gender%，你好，我在%Website%上看到了你的介绍，希望与你详谈。

两个%之间，是导入表格的列名，所有列名都可以作为内容模板的变量值。

Step3：设置加人间隔和上限

• 加人间隔：间隔多少秒发送邀请。

• 每日最大添加数：点击了申请添加好友的数量，也就是“申请用户”。该数量和账号权重有关，没有明确的限制，建议从低的数量开始测试。

• 设置好友描述：勾选后，系统会在好友备注里自动添加“描述”字段。

• 优先添加类型：一个号码即注册了个人微信，也注册了企业微信时，可以选择优先添加哪个。

• 数据统计：显示成功添加数、待添加数
  

• 工作时间段：可以设置用户比较有空加人的时段。
  

• 工作前检查手机端框架：勾选后，系统在启动的时候，优先检查手机是否已经安装框架。

Step4：检查加人过程

系统开始自动加人后，我们就可以看到任务处理消息，关注以下四个任务消息。

• 查看任务处理消息
  在【引流加人】-【日志】窗口，可以看到每台设备的工作进展（如下图）：
  

• 查看每台设备加人情况
  在【引流加人】-【活动设备列表】窗口，可以查看每台设备的加人次数，以及成功加人的数量。

字段说明：

• 启动时间：开启加人时间

• 更新时间：最近工作时间

• 本次回复聊天：如果配置了聊天模板，根据聊天规则，系统回复聊天的次数

• 本次成功添加：在本次加人运行期间（一次“开始”-“停止”的运行），系统成功找到手机号或二维码对应的用户，并发送给用户“添加为联系人”的邀请数量。

• 本次分配任务：在本次加人运行期间（一次“开始”-“停止”的运行），系统分配给设备的手机号和二维码数量。

• 本日成功添加：当日成功添加的数量

• 状态：

  • 检查任务：获取加人手机号码或二维码链接。

  • 工作间暂停：当设置了加人间隔时间，在间隔期间，设备会暂停加人。

  • 超出限制：超过了当日最大添加数。

  • 操作过频：企业微信提示操作过频。

  • 检测聊天回复：在设置中开启聊天回复功能时，检测是否有需要回复的聊天内容。

  • 检测未读消息：当开启【设置】-【自动回复】-【只回复新消息】时，系统会检测未读消息有哪些，再进行回复。

  • 无工作数据：手机号或二维码链接的所有数据已读取完。

  • 停止：停止加人。
    

• 每日新增加用户显示
  程序可以在工作的过程中动态计算每个设备的申请添加好友的相关数据
  

分配用户（意向用户）：当日该设备被分配需添加好友的数量（包含无效用户）
无效用户：当日该设备发现不存在用户的数量 (该值目前仅针对手机号查找用户有效)
无效率：无效用户/意向用户
申请用户：点击了申请添加好友的数量
成功申请率：申请用户/意向用户
新增用户：从手机端 工作台|客户联系|我的客户数 中查询得到的今日新增用户 （5 分钟查询一次）
意向通过率： 新增用户/意向用户 （注：新增用户包括手工添加用户）
申请通过率：新增用户/申请用户（注：新增用户包括手工添加用户）

• 查看暂停设备列表
  当设备处于暂停状态时，就会出现在【引流加人】-【暂停设备列表】。有如下几种暂停状况：

  • 不在工作时间

  • 加人过频

  • 超出当日加人限制数

  • 无工作任务

  • 连续5次加人不成功，该账号就会自动被锁定，无法继续加人
    [图片]

3. 设备分组加人 | 多个api/文件如何分组加人

程序可以将设备分组加不同的数据源。

第一，创建分组、设置分组的api地址、自我介绍

1. 点击设置--》分组配置，右上角➕添加分组

2. 每个分组分别设置 API 地址，打招呼模板，加人时间间隔
   

第二，分组运行

在群控系统中将设备添加进分组：

5. 加好友前外呼

程序可以从一知外呼的已完成任务列表中提取电话号码，并根据意向决定是否添加好友 。该功能从 1.75 及之后版本提供支持

1. 在引流加人界面中启用外呼功能
   
   

2. 点 '开始' 按钮启动任务

3. 处理流程

   1. 创建一个外呼任务对应的本地数据库

   2. 程序会每间隔 3 秒检测一次外呼任务队列 (每次检测新增数据，每 5 分钟进行一次完整队列检测)

   3. 如果有一个号码外呼完成，检测该号码是否已存在于本地数据库中。（同一个外呼任务，如果一个号码被导入多次进行外呼，只处理一次。之后的会被忽略）

   4. 检测该号码是否还有重拨

   5. 如果没有重拨需求，则判断是否符合添加好友意向

   6. 根据意向添加好友，并将结果保持于统计数据库中
      

4. 批量管理设备
   对所有连接在群控上的手机都可以实现批量管理
   
   字段说明：

   1. 电源：点击后，亮屏的手机将进入锁屏状态，锁屏的手机将点亮屏幕（未解锁）。

   2. 首页：点击后，所有手机进入首页。

   3. 解锁：点击后，解锁手机，进入锁屏前的界面。

   4. 重启：重启群控手机。

   5. 禁用华为自动更新：一键关闭华为自动更新。
      

5. 手机配置管理
   可以批量对手机中的设置进行更改

   1. APK 权限管理 ,

      1. 授权 APK 权限。程序在后台自动设置 APK 对手机的读写权限，并判断是否为 android 11 ， 如果是 android 11，自动弹出文件管理权限页面，请求手工授予权限。详见 《Android 11 初始化》部分

      2. 查看 APK 属性。在手机中打开 APK 的对应的应用信息属性页面

      3. 查看 APK 文件权限 （android 11）。在手机中打开 APK 在 android 11 下的所有文件管理权限页面

   2. 禁用、启用 手机自动更新 ， 会关闭手机应用市场及手机自动更新。因为手机型号众多，参数各自没事，该功能只能兼容大部分小米及华为手机

   3. 禁用、启用 手机 WIFI， 打开或是关闭 WIFI 开关

   4. 禁用、启用 手机移动网络 ， 打开或是关闭手机的数据连接开关

7. 一键登录聚合聊天多个账号

群控可以搭配“QunTool”聚合聊天工具实现一键登录多个客服功能。

如需要使用此功能，请联系光年工程师部署。
⚠️一键登录时，群控不能在加人状态，否则一键登录会失败。

9. 数据推送

程序可以在工作过程中可以将加人的状态推送至指定的地址。从版本 1.67 及之后支持此功能，具体使用过程见：
飞书链接: 数据推送

10. 企业微信机器人通知

当程序操作手机发现需要人工干预的问题时，可以通过企业微信机器人发送通知消息。 从版本 1.238 及之后支持此功能。目前检测是否有不可控制的弹窗。
在 设置 | 其它设置 | 手机异常推送 中设置企业微信机器人地址

11. 养号模式

开启养号模式后，程序会在工作过程中控制企业微信随机选择同事进行聊天。聊天的内容为程序内置的一些励志话术及诗词内容。如果指定部门，则程序只会针对指定部门中的同事进行聊天

四、常见问题

1. 如何升级群控到最新版本？

a.点击检查更新

b.登录时如果有更新会自动提示更新

2. 如何修改 CSV 编码格式？

「UTF-8」和「带 BOM 的 UTF-8」的区别就是有没有 BOM，即文件开头有没有 U+FEFF。UTF-8 文件中放置 BOM 主要是微软的习惯。

2.1 Excel 修改编码格式

2.2 notepad++ 修改编码格式

A. 下载notepad++
翻墙下载最新版：https://notepad-plus-plus.org/downloads/
如无法翻墙，可以直接下载
npp.8.1.4.portable.x64.zip

B. 将文件拖动到 Notepad++，或者右键选择打开方式为 notepad++

C. 转为 UTF-8-BOM 编码

D. 点开文档检查有没有问题
如发现所有列都合并到了第一列，用Excel的分列功能即可。

3. 手机状态 offline （或电脑远程控制手机） 怎么处理？

1. 使用 adb 命令执行 ```.\adb.exe reconnect offline``` 尝试重新连接手机
2. 撤销 USB 调试授权，然后重新打开。重新插拨 usb 线 
3. 清空授权设备，重新插拨 usb 线 
4. 重启手机  
5. 关闭程序。 重启 adb 服务 
   5.1 方式1 任务管理器中关闭 adb.exe 然后再次启动程序  
   5.2 方式2 执行，adb kill-server 及 adb start-server 命令 
6. 关闭 usb hub 依次打开电源。 
7. 重启电脑         

4. 同时存在多种加人数据时，程序优先选择哪个数据源？

1. 设备分组后，在分组设置中启动了 API 获取加人数据

2. 在工作界面中启用了 API 获取加人数据

3. 使用了一知外呼功能，从一知外呼任务队列中获取加人数据

4. 本地导入手机号或二维码的加人数据

6. 批量授权

程序可以在设备管理界面中通过命令批量给设备中的 com.smart.GNZF 应用授予 WRITE_EXTERNAL_STORAGE， READ_EXTERNAL_STORAGE，ACCESS_MEDIA_LOCATION 权限。

• 实际测试时授权完成后，在手机设置|应用管理的界面中有时能看到 com.smart.GNZF 获得了相应的权限，有时又不行。但是通过命令行查询应用已获得了相应的权限

• 华为手机上查询手机给APK 授予了 ACCESS_MEDIA_LOCATION 权限，虽然APK 并没有请求过该权限。所以执行批量授权时，也授权了 ACCESS_MEDIA_LOCATION 权限。但小米手机中并没有要求该权限，会在程序中提示一个错误，可忽略该错误。

7. 朋友圈发布大文件视频问题

当朋友圈发布视频文件时，如果视频文件比较大（样本为 30 M），企业微信会进行视频文件进行转码，将其转为转小的文件。目前发现，程序在某些手机上处理转码页面时，可能会判断失败，导致卡在该页面。如果出现该情况建议先将文件转为较小文件（企业微信针对 30 M 样本文件转为 3 M 后进行发布 ）

五、手机设置

1. 华为手机设置

Step1：依次点击 设置 -> 系统和更新 -> 软件更新 -> 右上角设置按钮，把 WLAN 自动下载和夜间安装全部关闭

Step2：点击 设置-》关于手机-》连续点击版本号多次，直到出现提示【您正处于开发者模式】，然后点击返回，依次点击 系统-》开发人员选项，下面的操作顺序必须按照规定操作：

1. 找到“锁屏”，关闭

2. 找到”保持唤醒状态“，打开

3. 找到 “USB调试”，打开

4. 找到“连接USB时总是弹出提示"，关闭

5. 找到"监控ADB安装应用"，关闭

6. 找到“仅充电模式下允许ADB调试"，打开

Step3：点击设置 -》 显示与亮度 -》 休眠 -》 永不
Step4：最新的华为手机需要安装驱动才能被正常识别。安装手机中自带的华为手机助手即可

在群控中该手机不显示，但在 windows 设备管理中该手机会显示 hdb interface ， 而不是之前的 adb interface 。 安装手机助手后即可被正常识别。

2. 小米手机设置

Step1：依次点击 设置-》我的设备-》MIUI版本-》右上角【⋮】按钮-》系统更新设置-》关闭“自动下载”、“智能更新”

Step2：点击小米应用商店-》我的-》右上角“设置”-》关闭“应用更新通知”、“自动升级”

Step3：点击 设置-》我的设备-》全部参数-》多次点击“MIUI版本”，看到提示【您正处于开发者模式】

Step4：点击设置-》更多设置-》开发人员选项（如果没有出现，说明上一步没有打开开发者模式），下面的操作必须按照规定操作：

1. “不锁定屏幕”，打开

2. “直接进入系统”，打开

3. “系统自动更新”，关闭

4. “USB调试”，打开

5. “USB安装”，打开（需登录小米账号才能打开）

6. “USB调试（安全设置）”，打开

7. 启用MIUI优化，关闭

8. 高风险功能开启提醒，关闭
   

3. 手机输入法的使用

PC 在手机中直接输入中文

在手机远程控制窗口中，点击需要输入文字的输入框，输入法自动弹出。请确认当前 PC 上为英文输入状态，手机中输入法为中文输入状态。否则无法进行正常的文字输入

1. PC 上为英文输入状态
   

2. 手机中为中文输入状态
   

3. 这时即可使用键盘直接进行中文的输入
   

手机与 PC 之间复制文本

手机中复制文本至 PC

直接在手机中长按然后选择待复制文本，选择复制。然后在 PC 中进行粘贴

从 PC 复制文本至手机

1. 如果手机剪贴板中有内容，先清空手机中的剪切板。长按输入框，选择剪贴板，然后清空所有

2. 在 PC 中复制文本

3. 在手机中按 ctrl+v 将文本复制入手机

4. 在输入法工具中选择粘贴按钮