发送用户激活邀请节点

功能说明

「发送用户激活邀请」是云身份连接器分类下的动作节点，用于向尚未激活的单个 IDaaS 用户发送短信或邮件激活邀请。

节点名称：发送用户激活邀请；所属分类：云身份连接器；节点类型：动作节点。

💡

核心能力：按单个 IDaaS 用户名和指定渠道发送激活邀请，返回明确的已受理、已跳过或失败结果，便于后续节点分支处理。

准备工作

当前账号具备连接流编辑权限；连接流发布需要具备发布权限

上游步骤已能取得本次要激活的 IDaaS 用户名；节点单次只处理一个用户

目标租户已配置所选渠道对应的激活模板：短信渠道需要可用的激活短信模板，邮件渠道需要可用的激活邮件模板

目标用户在 IDaaS 中已存在，且处于未激活状态

所选渠道的联系方式已准备：短信渠道需要有效手机号，邮件渠道需要有效邮箱

发送前请确认幂等与审计要求

节点在生成邀请时会更新用户临时密码并创建发送任务。同一次执行重复触发会返回原邀请结果，同一用户在同一渠道的 60 秒内重复邀请会被跳过。请在流程中保留足够的日志与权限控制，便于事后追溯发送对象与时间。

添加节点

步骤 1：在画布中添加节点

进入 集成平台 > 连接中心 > AI 连接流 打开目标连接流，在画布中添加一个动作节点，节点名称选择 发送用户激活邀请，并确认所属分类为 云身份连接器。

在节点面板中按名称搜索即可定位该节点，其所属分类为「云身份连接器」：

节点选择面板搜索激活邀请，结果中显示云身份连接器分类下的 IDAAS-发送用户激活邀请节点

推荐链路：通讯录新增用户事件 → 创建 IDaaS 用户 → 条件分支判断渠道 → 发送用户激活邀请。

配置节点

节点配置面板只保留两个业务字段：IDAS 用户名（必填，字符串或脚本）与邀请渠道（必填，下拉选择）。用户联系方式、激活模板、临时密码和幂等标识均由系统读取或生成，不允许流程搭建者手工指定。

发送用户激活邀请节点的参数配置面板，包含必填的 IDAS 用户名与邀请渠道字段，邀请渠道默认可选短信

步骤 2：配置 IDaaS 用户名

在 IDaaS 用户名（字段标识 idaas_user_name）中填写本次需要发送激活邀请的 IDaaS 用户。

属性	说明
类型	字符串
是否必填	是
配置规则	不提供默认值；单次只能传入一个用户名

建议：引用上游创建用户步骤返回的用户名字段，而不是手工输入固定值。

步骤 3：选择邀请渠道

在 邀请渠道（字段标识 invite_channel）中选择发送方式。

属性	说明
类型	枚举
是否必填	是
可选值	`SMS`（短信）、`EMAIL`（邮件）
配置规则	不提供默认值

说明：该字段决定节点读取手机号还是邮箱，并选择对应的激活模板与发送服务。国内外用户的差异应由上游条件分支判断后分别配置渠道。

节点不识别用户归属地，也不会在运行时切换渠道。任一必填字段未配置时，节点无法通过保存或发布校验；传入的用户名不是单个字符串值（例如数组或用户对象）时同样不会通过校验。

执行与返回结果

步骤 4：触发并读取返回字段

通过上游事件、定时调度或手动运行触发连接流，在节点输出中读取返回字段，并据此配置后续分支。

返回字段	类型	返回条件	说明
`status`	枚举	始终返回	执行结果，取值为 `ACCEPTED`（已受理）、`SKIPPED`（已跳过）、`FAILED`（失败）
`idaas_user_name`	字符串	输入可解析时返回	本次处理的 IDaaS 用户名，供后续节点关联用户
`invite_channel`	枚举	渠道合法时返回	本次实际执行的渠道，取值为 `SMS` 或 `EMAIL`
`reason_code`	字符串	已跳过或失败时返回	供后续条件节点稳定判断跳过或失败原因
`reason_message`	字符串	已跳过或失败时返回	面向流程搭建者说明具体原因与处理建议
`accepted_at`	日期时间	已受理或幂等重放时返回	平台首次可靠受理本次邀请的时间

ACCEPTED 不等于用户已收到

ACCEPTED 表示平台已受理并创建了邀请任务，不代表渠道已发送，也不代表用户已收到。渠道发送结果以消息日志为准。

执行边界与结果

执行场景	`status`	`reason_code`	是否修改密码	是否创建发送任务
必填字段为空、类型错误或渠道值非法	`FAILED`	`INVALID_INPUT`	否	否
用户名对应用户不存在	`FAILED`	`USER_NOT_FOUND`	否	否
用户不是未激活状态	`SKIPPED`	`USER_ALREADY_ACTIVE`	否	否
短信渠道缺手机号或号码格式无效	`FAILED`	`PHONE_MISSING` / `PHONE_INVALID`	否	否
邮件渠道缺邮箱或邮箱格式无效	`FAILED`	`EMAIL_MISSING` / `EMAIL_INVALID`	否	否
短信激活模板不可用	`FAILED`	`SMS_TEMPLATE_UNAVAILABLE`	否	否
邮件激活模板不可用	`FAILED`	`EMAIL_TEMPLATE_UNAVAILABLE`	否	否
短信网关或邮件服务不可用	`FAILED`	`CHANNEL_UNAVAILABLE`	否	否
同一用户同一渠道处于 60 秒重复保护期	`SKIPPED`	`DUPLICATE_INVITATION`	否	否
密码更新、邀请任务或待发送消息任一步骤保存失败	`FAILED`	`INVITATION_CREATE_FAILED`	已执行部分整体回滚	已执行部分整体回滚
邀请任务与待发送消息已保存	`ACCEPTED`	空	是	是

渠道联系方式缺失时节点不会改用另一渠道，需要在流程中显式配置分支与补数据步骤。

追踪消息发送结果

步骤 5：在消息日志中确认发送结果

打开消息日志，按本次邀请任务或用户定位对应记录，查看渠道实际发送结果。

如果平台受理后渠道发送失败，消息日志会更新为发送失败，节点历史结果仍保持 ACCEPTED，不会被改写为发送成功。如需确认用户确实收到邀请，请在流程中加入对消息日志结果的后续核对。

能力边界

节点单次只处理一个 IDaaS 用户名，不支持批量用户选择或组织范围发送；多用户场景需结合循环节点逐个执行。

单次只按一个渠道发送，不支持邮件和短信同时发送，也不支持渠道自动降级。

节点内部不判断国内或国外，也不在运行时切换渠道。

不支持自定义收件地址与自定义模板正文。

不返回临时密码，不提供一次性激活链接。

不保证最终收件箱或手机送达。

不在激活邀请节点内监听钉钉事件，也不扫描历史未激活用户。

验证结果

对未激活用户执行短信渠道邀请，节点返回 ACCEPTED、invite_channel 为 SMS，消息日志出现对应发送记录。

对同一用户在同一渠道的 60 秒内二次触发，节点返回 SKIPPED 与 DUPLICATE_INVITATION，没有产生新的密码修改与发送任务。

对已激活用户执行邀请，节点返回 SKIPPED 与 USER_ALREADY_ACTIVE，流程可按该原因编码继续分支。

传入不存在的用户名，节点返回 FAILED 与 USER_NOT_FOUND，没有模糊匹配或误发。

传入空用户名或非法渠道值，节点返回 FAILED 与 INVALID_INPUT。

对缺少手机号的用户使用短信渠道邀请，节点返回 FAILED 与 PHONE_MISSING，且没有改用邮件发送。

必填配置缺失时，节点无法通过保存或发布校验。

常见问题

节点返回 ACCEPTED，但用户没有收到短信或邮件怎么办？

先查看消息日志中的渠道发送结果。ACCEPTED 只表示平台已受理并创建发送任务，渠道发送是异步的，失败会记录在消息日志中。

可以在一个节点里同时发短信和邮件吗？

本期不支持。节点单次只按一个渠道发送，需要双渠道时在流程中拆分两个节点或使用条件分支分别执行。

节点会判断用户在国内还是国外吗？

不会。节点按配置的渠道执行，不做归属地判断，也不在运行时切换渠道。请在节点之前用条件分支决定渠道。

用户手机号缺失时，节点会改用邮箱发送吗？

不会。联系方式缺失或格式无效时节点返回失败，需要流程显式处理补数据或更改渠道。

可以批量发送给多个用户吗？

本期不支持批量用户选择和组织范围发送。节点单次处理一个 IDaaS 用户名，多用户场景请结合循环节点逐个执行。

界面参考

待补图

节点在画布中的入口、节点配置面板、执行结果与消息日志将在授权测试环境补充截图。

功能说明#

准备工作#

添加节点#

配置节点#

执行与返回结果#

执行边界与结果#

追踪消息发送结果#

能力边界#

验证结果#

常见问题#

界面参考#