功能说明

EBAOZU V4 支持在后台配置企业微信客户欢迎语。当客户通过扫码、微页面组件或客服渠道添加企业员工（或加入客户群）后，企业微信将自动向客户推送欢迎文本、商城链接或引导图文。

---

接入前置条件

1. 已开通客户联系功能：在企业微信管理后台开通“客户联系”功能，并确认员工处于“使用客户联系权限”的业务人员范围内。
2. 自建应用具备客户联系权限：在企业微信后台进入自建应用，在“权限集”中开启“客户联系”相关 API 接口权限。

---

后台无法添加欢迎语排查步骤

检查企业微信配置参数

1. 登录平台总后台 -> 【设置】 -> 【企业微信配置】。
2. 核对 CorpId（企业ID）、自建应用的 AgentId 与 Secret 是否填写无误。
3. 检查自建应用的可信 IP 白名单中是否已添加当前服务器的公网 IP。

---

排查企业微信后台冲突规则

• 原理：若在企业微信官方后台【客户联系】 -> 【加客户】中已经配置了员工级别或全局的默认欢迎语，通过第三方接口 API 下发的欢迎语可能会被企业微信官方规则覆盖或冲突拦截。
• 解决：在企业微信管理后台检查现有的欢迎语模板，避免多重设置冲突。

---

查看接口日志排查

在后台添加或同步欢迎语时若报错，请查看服务器日志 runtime/log/，搜索 send_welcome_msg 或 externalcontact：

• errcode: 84061：员工不在企业微信自建应用的可见范围或客户联系权限范围内。
• errcode: 40058：欢迎语参数格式错误（例如文本内容超长或链接格式不合法）。
• errcode: 41048：该客户添加时间已超过企业微信允许下发欢迎语的时间窗口（微信限制仅添加好友后 20 秒内可下发）。