客户点了获客链接，也顺利加上了成员，可原本准备好的那条欢迎语没有出现。成员看后台，客户确实在；看应用日志，发送接口也调过了。问题往往不在获客链接本身，而在欢迎语的发送凭证 welcome_code：它什么时候会给、能用多久、谁先用，企业微信开发文档都写了条件。下面按2026年11月13日（北京时间）核读的两篇企业微信开发者中心文档，把这些条件逐条拆开。

欢迎语靠的是添加客户事件里的 welcome_code

企业微信开发者中心的「发送新客户欢迎语」文档（页标最后更新2025/11/17）开头写道：企业微信在向企业推送添加外部联系人事件时，会额外返回一个 welcome_code，企业以此为凭据调用接口，即可通过成员向新添加的客户发送个性化的欢迎语。

客户联系回调的「事件格式」文档（页标最后更新2024/06/03）说明，配置了客户联系功能的成员添加外部联系人时，会回调「添加企业客户事件」，事件中包含 State 和 WelcomeCode。文档对 State 的说明是：添加此用户的「联系我」方式配置的 state 参数，或在获客链接中指定的 customer_channel 参数，可用于识别添加此用户的渠道。

这说明，经由获客链接添加的客户，与经由「联系我」添加的客户，走的是同一个添加企业客户事件；欢迎语能不能由应用发出去，取决于这次事件里有没有 welcome_code，以及应用能不能在规定条件下用上它。

条件一：管理端已配欢迎语，事件里就没有 welcome_code

「发送新客户欢迎语」文档的第二条说明是：如果企业已经在管理端为相关成员配置了可用的欢迎语，则推送添加外部联系人事件时不会返回 welcome_code。

这是最常见的「接口调了却发不出」的原因。管理端为成员配好的欢迎语会优先生效，应用拿不到凭证，也就无法再发自己的那一版。如果希望按获客链接或渠道发送不同的欢迎语，需要先厘清这位成员在管理端是否已有可用的欢迎语，两套做法只能选一套主导。

条件二：收到事件后20秒内调用，且只能调用一次

文档第一条说明：为了保证用户体验以及避免滥用，企业仅可在收到相关事件后20秒内调用，且只可调用一次。参数表里对 welcome_code 的描述同样写明有效期为20秒。

这对系统设计有直接影响。如果欢迎语内容要先查数据库、拼接渠道信息、上传图片素材，再去调用接口，整条链路必须控制在20秒内；把发送放进延迟较长的队列里，凭证可能已经过期。素材类附件建议提前准备好，而不是收到事件后才开始上传。

事件格式文档还提醒：如果外部联系人和成员已经开始聊天，或已通过「外部联系人免验证添加成员事件」得到的 welcome_code 发送了欢迎语，则不会继续返回 welcome_code。也就是说，免验证场景下可能先后收到两次事件，欢迎语只需要在拿到第一个凭证时发一次。

条件三：多个应用同时在场，只有最先调用的能成功

文档第五条写的是：每次添加新客户时，可能有多个企业自建应用或第三方应用收到带有 welcome_code 的回调事件；多个应用同时调用发送欢迎语接口时，仅最先调用接口的应用可以成功，其他应用返回41096（welcome msg is being distributed）。

两个返回码的含义要分清：41096 表示当前已有其他应用正在发送欢迎语，不代表欢迎语已经下发成功，存在下发失败的可能，调用方可以重试；41051（externaluser has started chatting）表示欢迎语已成功下发，无需重试。文档建议根据实际业务需求，合理配置应用的可见范围。

如果企业同时接入了几家服务商的工具，客户收到的欢迎语来自哪个应用，往往取决于谁先调用。想让获客链接对应的那一版生效，先盘点哪些应用会收到这类事件，必要时收窄其他应用的可见范围。

条件四：成员状态和应用权限

文档第四条：长期未登录企业微信的成员无法发送欢迎语。获客链接里配置的成员如果长期不登录，即便凭证和接口都正常，欢迎语也发不出去。

权限说明部分写明：企业需要使用配置到「可调用应用」列表中的自建应用 secret 获取的 access_token 来调用；第三方应用需要拥有「企业客户权限 - 客户联系 - 给客户发送欢迎语」权限；营销获客类应用需要拥有「客户联系权限 - 消息推送权限 - 给客户发送欢迎语」权限；企业成员需在应用的可见范围内。

内容层面也有限制：text 和 attachments 不能同时为空；文本最长4000字节；附件最多9个，类型可选图片、链接、小程序或视频；小程序附件的 appid 必须是关联到企业的小程序应用。

欢迎语没到时的核对顺序

- 这位成员在管理端是否已配置可用的欢迎语，导致事件里没有 welcome_code

- 应用收到事件到调用接口，是否超过20秒，是否重复调用

- 是否有其他应用同时收到事件并抢先发送，返回码是41096还是41051

- 免验证场景下，是否已经用第一次事件的凭证发过欢迎语

- 成员是否长期未登录企业微信，是否在应用可见范围内

- 应用是否具备对应的发送欢迎语权限，附件内容和小程序 appid 是否符合要求

获客链接负责把客户带到成员面前，欢迎语能否出现是另一套条件。把这几项和渠道参数分开核对，比反复重建获客链接更能找到原因。以上依据本轮核读的公开开发文档，未在企业后台实测，具体以企业配置与接口实际返回为准。

参考资料

[1] 企业微信开发者中心：发送新客户欢迎语 https://developer.work.weixin.qq.com/document/path/92137，页标最后更新2025/11/17，访问日期2026-11-13（北京时间）。引用范围：welcome_code 的来源与20秒有效期、只可调用一次；管理端已配置欢迎语时不返回 welcome_code；41051 与 41096 的含义；长期未登录成员无法发送；多应用先到先得与可见范围建议；权限说明；text 与附件的长度、数量、类型及小程序 appid 要求。

[2] 企业微信开发者中心：客户联系「事件格式」 https://developer.work.weixin.qq.com/document/path/92130，页标最后更新2024/06/03，访问日期2026-11-13（北京时间）。引用范围：添加企业客户事件的触发条件、State 可为获客链接中指定的 customer_channel 参数、WelcomeCode 字段；已开始聊天或已用免验证事件 welcome_code 发送后不再返回 welcome_code；外部联系人免验证添加成员事件。