功能介绍

渠道码是企业微信获客的核心工具，通过创建带参数的二维码，实现客户来源追踪、自动分配员工、自动打标签、自动发送欢迎语等功能。支持全天在线和自动上下线两种模式。

操作流程

CRM ＞ 企业微信 ＞ 客户管理 ＞ 企业渠道码

功能说明

渠道码类型

系统支持两种渠道码类型：

类型	说明	适用场景
活码（type=0）	固定二维码，长期有效	长期获客、门店展示
周期码（type=1）	按时间段分配不同员工	轮班制、分时段运营

代码来源：app/controller/admin/v1/work/ChannelCode.php:72

创建渠道码

创建渠道码需要设置以下信息：

基本信息

• 二维码名称：便于管理和识别
• 二维码分类：一级分类，便于归类管理
• 状态：启用/禁用

客户设置

• 客户标签：扫码添加后自动打标签（label_id[]）
• 自动加好友：开启后无需确认自动成为好友（skip_verify）

员工分配

• 全天在线模式：
  • 选择分配员工（userids[]）
  • 设置员工添加上限（add_upper_limit）
  • 设置备用员工（reserve_userid[]）
• 自动上下线模式：
  • 设置周期（cycle[]）
  • 每个周期指定不同员工
  • 客户扫码后随机分配

欢迎语

• 设置扫码后的欢迎语（welcome_words[]）
• 支持插入客户名称、图片、小程序

代码来源：app/controller/admin/v1/work/ChannelCode.php:72

渠道分类管理

渠道码支持分类管理，便于组织和查找：

操作	说明	方法
查看列表	查看所有渠道分类	index
新建分类	创建新的渠道分类	save
修改分类	修改分类名称和排序	update
删除分类	删除分类（需先清空分类下的渠道码）	delete

代码来源：app/controller/admin/v1/work/ChannelCate.php:38-129

批量移动分类

支持批量将渠道码移动到其他分类：

1. 选择多个渠道码
2. 点击"批量移动分类"
3. 选择目标分类
4. 确认提交

代码来源：app/controller/admin/v1/work/ChannelCode.php:209

扫码客户统计

查看每个渠道码带来的客户数据：

• 扫码添加的客户列表
• 客户基本信息
• 添加时间

代码来源：app/controller/admin/v1/work/ChannelCode.php:196

自动化流程

欢迎语自动发送

客户扫码添加好友后，系统自动发送欢迎语：

1. 客户扫码 → 企业微信回调
2. 系统触发 work.welcome 事件
3. 事件监听器：
   • 从 state 中解析渠道码ID（channelCode-{id} 格式）
   • 查询渠道码对应的欢迎语
   • 替换 ##客户名称## 为实际客户名称
   • 调用 Work::sendWelcome() 发送

内部知识：

• 事件：work.welcome → WelcomeSendListener
• 欢迎码有效期：20秒（企业微信限制）
• 如果渠道码无欢迎语，取该员工的默认欢迎语

代码来源：app/listener/work/WelcomeSendListener.php:41

标签自动设置

客户扫码添加好友后，系统自动设置标签：

1. 客户扫码 → 企业微信回调
2. 系统触发 work.label 事件
3. 事件监听器：
   • 从 state 中解析渠道码ID
   • 查询渠道码关联的标签列表
   • 调用 Work::markTags() 打标签

内部知识：

• 事件：work.label → ClientLabelListener
• 标签来源：渠道码配置的 label_id 字段（JSON格式）

代码来源：app/listener/work/ClientLabelListener.php:32

商城用户绑定

客户扫码添加好友后，系统自动绑定商城用户：

1. 客户扫码 → 企业微信回调
2. 系统触发 work.user 事件
3. 事件监听器：
   • 根据 unionid 查询商城用户
   • 如果存在，自动绑定

内部知识：

• 事件：work.user → ClientBindUserListener
• 绑定依据：unionid
• 更新客户记录的 uid 字段

代码来源：app/listener/work/ClientBindUserListener.php:28

渠道码定时同步

渠道码通过定时任务自动同步到企业微信：

• 监听器：AutoChannel（继承 Cron，1秒 tick）
• 同步内容：渠道码配置、员工分配、欢迎语

代码来源：app/listener/work/AutoChannel.php:25

常见问题

Q: 渠道码和普通二维码有什么区别？

A: 渠道码是带参数的二维码，可以实现：

• 客户来源追踪
• 自动分配员工
• 自动打标签
• 自动发送欢迎语
• 扫码数据统计

普通二维码没有这些功能。

Q: 如何选择活码和周期码？

A:

• 活码：适合长期获客场景，如门店展示、宣传物料
• 周期码：适合轮班制场景，如客服轮班、分时段运营

Q: 员工添加上限是什么意思？

A: 员工添加上限是指该员工可以添加的最大客户数量。达到上限后，新客户会自动分配给备用员工。

Q: 欢迎语中的 ##客户名称## 是什么？

A: ##客户名称## 是变量占位符，系统会自动替换为客户的实际名称。发送前会进行替换处理。

Q: 渠道码分类删除失败怎么办？

A: 渠道码分类下有渠道码时不允许删除。请先将分类下的渠道码移动到其他分类，再删除分类。