消息渠道介绍

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：3

消息渠道介绍

变更记录

产品版本	更新内容	更新日期
V6.0.1	消息渠道所属应用从系统服务云调整到基础服务云的公共设置	2023年10月23日

1 简介

1.1 功能介绍

苍穹平台默认内置了八个消息渠道，分别是云之家、邮件、短信、钉钉、企业微信、welink、生态云之家、云之家统一流程，用户可以根据自身需求修改这些渠道配置参数信息。其中，默认启用短信与云之家两种渠道。

可以对消息渠道进行禁用和启用（云之家、生态云之家、云之家统一流程不能同时启用）；

注意：禁用之后，苍穹的待办任务消息和普通消息都不会发送到相应的渠道。

每个消息渠道可以自定义自己的参数，在消息渠道初始化时加载并且解析；

渠道配置中”启用日志”开关默认关闭，消息中心默认只记录渠道失败消息，用户打开该开关之后，消息中心会记录该渠道下完整日志，方便用户在消息日志列表中查看分析。

1.2 系统路径

V5.0及以下：【系统服务云】→【系统管理】→【消息平台】→【消息渠道】

V6.0：【基础服务云】→【公共设置】→【消息设置】→【消息渠道】

2 各渠道配置参数

2.1 短信

系统使用的短信服务器由金蝶云平台提供，通过短信接口调用服务，达到发送短信的功能。且短信功能为付费特性，付费标准可以咨询实施交付人员。

短信渠道默认开启，在用户购买license的基础，无需修改即可正常使用。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

短信接口：云平台提供的短信API接口；

短信模板：云平台为苍穹定制的短信模板；

客户端ID&客户端秘钥：云平台定制短信服务的轻应用ID&秘钥；

在消息中心交付使用过程中，用户也可以使用其他平台提供的短信服务，只需要用户仿照SmsServiceHandler实现二开解析类，并在解析类中打通其他平台短信接口，替换保存即可，快捷方便。

2.2 电子邮件

针对电子邮件渠道，适用于拥有私有化部署邮箱服务器的用户，用户部署的邮箱服务器可以便于集成参数，方便调优。对于使用云邮箱服务的用户，可能使用过程问题不易解决打通渠道问题。所以，我们推荐使用私有化部署邮箱服务器，不建议使用市面上的大众性邮箱服务器。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

邮箱服务器地址：用户自行设置的邮件服务器域名或者IP；

邮箱服务端口：25 or 465(加密端口)，具体视邮箱服务器实际情况而定;

用户名：发送方邮箱账号用户名；

密码：发送方邮箱账号密码或者授权码；

发件人账号：发送方邮箱账号；

发件人名称：接收人邮件列表所显示的发件人名称；

服务器域名：部分客户邮箱服务器需要指定邮箱服务器域名，非必录；

使用TLS协议：默认开启状态，具体视邮箱服务器是否打开tls协议实际情况而定。

苍穹标准产品并未提供标准邮件服务器，用户需要根据目前使用邮箱服务器自行配置相关参数。

市场上大多数云服务提供商（比如：华为云、阿里云）提供的付费云邮箱服务器，为了防止垃圾邮件传播，一般会禁用25端口，需要注意，可能需要使用465端口。

2.3 云之家

云之家渠道默认开启状态，相关参数均已配置完整，用户可以无需修改即可正常使用。

云之家渠道出厂默认预置两种云之家公众号---消息助手&流程助手，用户可以根据自己的需求添加自建公众号，业务推送消息接口sendMessage中指定自建公众号编码即可。

用户使用该渠道之前，我们建议用户创建自建轻应用，替换标准产品中10036轻应用ID以及轻应用秘钥参数。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

公共号名称：公共号名称，该名称会影响云之家待办卡片中标题；

公共号标识：公众号标识，不可修改；

公众号ID：云之家为公众号分配的唯一性身份ID；

公众号Key：云之家为公众号分配的KEY值；

公众号接口：推送公众号消息的接口URL；

公众号图标：云之家显示公众号头像图标；

授权地址：推送消息接口使用的token获取URL；

轻应用ID：云之家为轻应用分配的唯一性身份ID；

轻应用秘钥：轻应用秘钥；

创建待办地址：云之家创建待办地址URL；

处理待办地址：云之家处理、删除待办地址URL；

校验待办地址：云之家校验待办处理状态地址URL。

其中轻应用、公众号相关配置参数信息可由云之家管理员在云之家管理后台获取。

在使用过程，需要注意系统库中人员表T_SEC_USER表中必须要存储有EID和OPENID数据，即已经将云之家人员信息同步至苍穹系统中。否则，该渠道消息不能正常抵达云之家接收人。

针对客户使用私有化部署云之家服务，云之家版本达到V2.0以上，公众号、待办等接口URL配置中只需要替换相应域名即可，url其他信息内容可以保持原厂不变。

注意：客户如果对移动端云之家有快捷同意的需求，允许客户根据单据性质自主选择是否允许该单据采用快捷同意模式进行审批。详见：云之家支持快捷审批。

2.4 钉钉

用户在使用钉钉渠道之前需要在钉钉企业中自建企业内部微应用，并开通应用的相关权限。通过该微应用，苍穹可以实现任务&消息的推送，同时，用户需要在苍穹系统管理-消息平台的钉钉渠道配置，进行相关参数设置。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

企业ID: 钉钉为客户分配的唯一的企业标识码；

应用ID:企业自建微应用ID；

应用秘钥: 企业自建微应用秘钥；

应用Key：企业自建微应用Key。

2.5 企业微信

用户在使用企业微信渠道之前，需要在企业微信端和苍穹端配置必要参数。用户需要创建应用，并开通相关权限，在该应用中接收苍穹推送的各类消息。此外，苍穹中还需要同步企业微信的人员信息，并配置单点登录的参数设置。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

企业ID：微信企业被分配的唯一性身份ID；

应用ID：企业微信为微应用分配的身份ID；

应用秘钥：微应用产生的秘钥。

2.6 WeLink

华为移动办公软件Welink，支持文本消息、连接消息、待办任务推送处理功能，用户在使用该渠道之前需要配置消息平台渠道、人员关系映射、MC参数配置、welink应用公共号权限四个方面。

启用日志：默认关闭，打开后，渠道消息完整日志将会被记录在消息日志中；

公众号ID：自建私密号ID。

2.7 生态云之家

生态云之家渠道默认禁用，参数需要用户自行配置。

生态云之家渠道实质上仍旧属于云之家，使用规则与云之家渠道大致相同。

生态云之家渠道的使用场景为：苍穹中存在外部人员，比如伙伴、供应商、经销商等人员时，该外部人员可能与苍穹主体人员不在同一个云之家工作圈中，二者由于工作圈的限制，任务待办、消息彼此隔离，连通性不高。使用该渠道，业务不在需要关心消息接收人的工作圈限制，联通多个工作圈之间，可以最大程度上方便苍穹用户与伙伴之间的消息共享。