一、软件安装

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

Step1：安装“光年RPA机器人系统企业微信版”桌面软件

您需要准备一台windows电脑连接我们寄给您的手机盒子，并在电脑上安装“光年RPA机器人系统企业微信版”软件。请从以下地址下载并安装软件：
https://software.gnlab.cn/rpaclient.wecom/install.exe

电脑配置推荐如下：
- CPU 6 代 i7 或以上
- 内存 推荐 16 G， 最少 8 G
- 硬盘 C 盘剩余空间 200 G
- 操作系统 windows 10/11

Step2：使用usb线将手机盒子与windows电脑连接

1.需要将手机盒子与电脑连接，详细操作步骤请参照： 手机盒子使用指南
2.启动软件后，即可在软件中操作手机盒子中的手机

 

二、软件使用

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 编码格式，如何修改点这里 。

#601px #461px

Step 2：选择添加客户方式

点击【引流加人】-【操作】-【选择添加客户方式】
动画1.gif#390px #402px

 

方法二：API 号码源接口

提示

该功能可以通过一个 API 接口获取手机号码进行好友添加。

详见：API 号码源接口

Step2：设置加好友介绍

当我们发送添加邀请时，用户会看到以下界面，再决定是否添加好友，因此这句话的文案非常重要。
#325px #544px
“加好友介绍消息编辑器”可以设置邀请消息，以下是功能界面：
动画3.gif#467px #440px

字段说明

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

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

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

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

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

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

Step3：设置加人间隔和上限

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

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

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

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

  • 数据统计：显示成功添加数、待添加数
    #545px #287px

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

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

Step4：检查加人过程

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

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

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

字段说明：

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

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

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

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

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

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

  • 状态：

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

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

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

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

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

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

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

    • 停止：停止加人。

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

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

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

    • 不在工作时间

    • 加人过频

    • 超出当日加人限制数

    • 无工作任务

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

 

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

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

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

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

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

第二，分组运行

在群控系统中将设备添加进分组：
动画4.gif

 

5. 加好友前外呼

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

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

  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”聚合聊天工具实现一键登录多个客服功能。
quntool登录.gif

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

 

9. 数据推送

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

10. 企业微信机器人通知

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

11. 养号模式

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

 

三、常见问题

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

a.点击检查更新

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

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

提示

修改文件编码为 UTF-8-BOM 编码格式，否则会乱码。

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

2.1 Excel 修改编码格式

e42b457d-fb22-4d11-b47a-70093289511c.gif

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. 本地导入手机号或二维码的加人数据

更新时间：2023-11-24 15:52