Appearance
功能介绍
欢迎语是企业微信客户运营的重要工具，在客户添加好友后自动发送，帮助建立良好的第一印象。支持通用欢迎语和成员专属欢迎语两种模式。
操作流程
CRM ＞ 企业微信 ＞ 客户管理 ＞ 欢迎语
功能说明
欢迎语类型
系统支持两种欢迎语类型：
| 类型 | 说明 | 适用场景 |
|---|---|---|
| 默认欢迎语（type=0） | 所有成员共用 | 统一品牌形象 |
| 指定成员欢迎语（type=1） | 不同成员不同欢迎语 | 个性化服务 |
代码来源：app/controller/admin/v1/work/Welcome.php:70
创建欢迎语
创建欢迎语需要设置以下信息：
基本信息
- 欢迎语类型：默认/指定成员
- 关联成员：指定成员时选择成员（
userids[]） - 排序：同一成员有多个欢迎语时的优先级
消息内容
- 文字内容：欢迎语文本
- 附件：支持图片、小程序等多媒体内容（
attachments[]）
代码来源：app/controller/admin/v1/work/Welcome.php:70
欢迎语发送机制
客户添加好友后，系统自动发送欢迎语：
- 客户扫码/添加好友 → 企业微信回调
- 系统触发
work.welcome事件 - 事件监听器处理：
- 解析渠道码ID（如果有）
- 查询渠道码对应的欢迎语
- 如果渠道码无欢迎语，取成员的默认欢迎语
- 替换
##客户名称##为实际客户名称 - 将图片转为素材库资源
- 调用
Work::sendWelcome()发送
内部知识：
- 事件：
work.welcome→WelcomeSendListener - 欢迎码有效期：20秒（企业微信限制）
- 欢迎语优先级：渠道码欢迎语 > 成员专属欢迎语 > 通用欢迎语
代码来源：app/listener/work/WelcomeSendListener.php:41
欢迎语变量
欢迎语支持以下变量：
| 变量 | 说明 | 替换内容 |
|---|---|---|
##客户名称## | 客户名称 | 客户的实际名称 |
代码来源：app/listener/work/WelcomeSendListener.php:41
欢迎语管理
| 操作 | 说明 | 方法 |
|---|---|---|
| 查看列表 | 查看所有欢迎语 | index |
| 查看详情 | 查看欢迎语详细信息 | read |
| 新建欢迎语 | 创建新的欢迎语 | save |
| 修改欢迎语 | 修改欢迎语内容 | update |
| 删除欢迎语 | 删除不需要的欢迎语 | delete |
代码来源：app/controller/admin/v1/work/Welcome.php:43-134
渠道码欢迎语
渠道码可以设置专属欢迎语，覆盖成员的默认欢迎语：
- 创建渠道码时，设置欢迎语内容（
welcome_words[]） - 客户扫码添加好友后，系统优先使用渠道码欢迎语
- 如果渠道码未设置欢迎语，使用成员的默认欢迎语
内部知识：
- 渠道码欢迎语存储在渠道码配置中
- 欢迎语内容支持文字、图片、小程序
- 替换变量后发送
代码来源：app/controller/admin/v1/work/ChannelCode.php:72
常见问题
Q: 欢迎语发送失败怎么办？
A: 欢迎语发送失败可能是以下原因：
- 欢迎码已过期（20秒限制）
- 消息内容格式错误
- 企业微信接口异常
检查错误日志，确认具体原因后重新配置。
Q: 如何设置不同成员的专属欢迎语？
A: 创建欢迎语时：
- 选择"指定成员"类型
- 选择要关联的成员
- 设置欢迎语内容
系统会根据成员自动匹配对应的欢迎语。
Q: 欢迎语中的 ##客户名称## 不生效怎么办？
A: 确认变量格式正确（##客户名称##），系统会在发送前自动替换。如果仍不生效，检查客户是否有名称信息。
Q: 渠道码欢迎语和默认欢迎语有什么区别？
A:
- 渠道码欢迎语：特定渠道码专属，客户扫码后使用
- 默认欢迎语：成员通用，无渠道码或渠道码无欢迎语时使用
优先级：渠道码欢迎语 > 成员专属欢迎语 > 通用欢迎语