Skip to content

功能说明 ​

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 秒内可下发)。

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心