# 消息通知

消息通知是在流程流转过程中给予相关活动参与者进行提醒的一种机制。

支持的消息提醒渠道包括站内信、邮件、钉钉、企业微信、飞书、短信。消息渠道可扩展，参考消息扩展开发说明

触发提醒的时机支持任务到达、催办、抄送、转交、协办、协办完成、拒绝、重做、加签、撤回、回退、超时前、超时后、流程结束、流程终止。

其中流程结束、流程终止为流程级别消息通知特有触发时机

特殊注意：当需要配置超时前、超时后消息通知时，bps应用配置文件application-bps.properties中需要配置afc模拟登陆配置信息。参考如下配置

#clientId为应用租户id/应用code  例：sys_tenant/AFCENTER
afc.simulate.login.clientId=
afc.simulate.login.sercet=

# 配置级别

消息通知分活动消息通知、流程消息通知、应用消息通知和平台消息通知。消息发送具体解析哪一层级通知配置，根据触发提醒的时机动作和是否开启默认配置有关。

触发时机为活动工作项动作（如任务到达、催办等）时，通知配置信息解析步骤如下：

1、解析活动中消息通知触发时机对应的配置信息，未开启默认配置时，则按当前活动消息配置为准，若开启默认配置，则向上找流程级消息通知配置信息。

2、活动消息通知默认时，解析流程中消息通知配置信息。未开启默认配置时，则以当前流程消息配置为准。

3、流程消息通知默认时，解析应用中消息通知配置信息。未开启默认配置时，则以应用消息配置为准。

4、应用消息通知默认时，解析平台中消息通知配置信息。平台消息通知后最终配置信息。

触发时机为流程动作（如流程结束、流程终止、流程级超时前等）时，通知配置信息解析步骤如下：

1、解析流程中消息通知配置信息。未开启默认配置时，则以当前流程消息配置为准。

2、流程消息通知默认时，解析应用中消息通知配置信息。未开启默认配置时，则以应用消息配置为准。

3、应用消息通知默认时，解析平台中消息通知配置信息。平台消息通知后最终配置信息。

消息通知配置分为消息配置和接收人配置。

a、消息配置指对具体消息触发时机配置渠道开关和渠道对应的消息模板，消息模板参考消息配置。。如下图

b、接受人配置指对具体消息触发时机配置消息接收人，未配置时，各触发时机有提示默认消息接收人。注意每个触发时机默认消息接收人并非一致，需根据提示信息来判断。

特殊提示：超时前、超时后触发时机接收人配置和其他触发时机接受人配置不同。超时前后配置接受人时，需要指定时段，即可以指定多个时段发消息，每个时段消息接收人为对应配置接收人。如下图以超时前为例，超时后也如此配置。

以下用任务到达和超时前触发时机为例，举例说明消息配置和接收人配置信息。活动消息通知默认配置下，解析上级配置的过程。

以下以站内信渠道消息为例

1、当活动消息通知配置任务到达触发时机时，打开自定义，并打开站内信开关绑定消息模板。如下图所示，此配置表示当前环节启动创建工作项时会对工作项参与者发送站内信通知。

2、接收人配置，以任务到达中接收人配置为例，当未配置任何接收人时，消息通知默认给流程当前环节参与者发送消息，下图示例中配置非环节参与者为接收人。

参与者配置为流程启动者

3、发起流程实例，启动到人工活动1后登录活动配置参与者和消息通知接收人配置的参与者查看站内信消息。以admin账号测试流程发起

登录admin发起流程实例后查询站内信如下图

登录xifanzhou查看站内信如下图

活动消息通知配置默认后则向上找配置，即先找流程级消息通知配置再逐步向上找平台级。具体默认消息通知解析参考配置级别

以下步骤以活动级消息通知配置为默认，向上找流程级消息通知为例。

1、配置活动消息通知中消息配置和接收人配置为默认配置

2、流程属性中消息通知配置任务到达消息配置和接收人配置为自定义，且配置对应模板和参与者信息

3、发起流程实例，启动到人工活动1后登录活动配置参与者和流程级消息通知接收人配置的参与者查看站内信消息。以admin账号测试流程发起

登录admin发起流程实例后查询站内信如下图

登录xifanzhou查看站内信如下图

超时前触发时机配置默认时，配置信息解析和任务到达逻辑一致，这里只做配置自定义示例

1、配置时间限制中启用时间限制。只有开启并设置时间限制，消息通知中超时前后配置才能生效。并配置时间策略，以下为例设置超时时间为2分钟

2、当活动消息通知配置超时前触发时机时，打开自定义，并打开站内信开关绑定消息模板。如下图所示

3、配置超时前接收人配置信息，该信息中包含超时前时间段和时间段对应的参与者。当开启超时前消息配置，但未配置接收人配置中时间段时，不发送超时消息。如下图配置时间段和对应参与者，注意：这里除了给配置的参与者发消息外还会给当前环节参与者发送。

如下图示例中设置超时前1分钟发送超时消息。

4、发起流程，并当人工活动超时前1分钟后，查看消息接收参与者站内信。（此处消息接收参与者包含活动参与者和接收人配置中时间段对应的参与者）