# 短信自有通道配置说明

来源快照：`result_data_new_260518.json`

- 来源 ID：`1196647441522057218`
- 模块：短信
- 目录：未分组
- space ID：`1162093089454735415`
- 原文链接：未提供
- 产品基线：未提供

## 正文

## 一、概述

**E10****云端租户或私有部署客户均可以通过接入用户自有的短信通道进行短信发送，此文档需要您对****ESB****中心****- >****动作流相关基本概念及使用方法有所了解，如果不清楚可以通过**[**< <泛微ESB中心帮助文档>>**](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159161082873389264&freepass_doc=1&space_id=1157961794811633670 "<<泛微ESB中心帮助文档>>")**进行了解**

** **

##  二、前置条件

自有通道发送是依赖动作流引擎实现的，所以必须采购动作流

发送短信涉及到费用，需客户自行购买短信通道，然后集成到e10常见短信通道商：如：梦网科技、移动MAS、腾讯云、阿里云

创建短信签名，签名一般为公司或产品简称，需要找客户确认一下（注：客户购买短信通道商服务后都会要求进行签名报备，e10中的签名要与报备的一致）。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523189145605&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

登陆注册模块相关的短信提醒，如：登陆验证码、找回密码等，如果需要对接这部分，需要以主租户管理员登陆后设置下（云端环境忽略此步即可），如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523029147658&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 三、集成步骤：

### 1：新建动作流

菜单路径：后台管理中心->平台引擎->ESB中心->动作流

### 2：选择触发事件

触发事件：系统应用事件触发->短信->自有通道触发

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523016876037&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3：配置短信发送通道

根据用户的实际情况选择对应的执行组件来实现发送接口的集成。

动作流《常用通道发送》组件目前集成了20多种国内常用的短信通道商

如：腾讯云、阿里云、梦网科技、移动MAS等，可以通过该组件的发送通道下拉框进行搜索查看已支持通道，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514435330069&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

如果用户的通道包含在其中，那么配置相关的通道参数即可。

如果未包含其中，则可以根据实际情况通过动作流的相关功能进行集成，比如动作流的连接器、serverLess、DML操作等。

大多数短信接口都是http协议接口，是的话建议通过postman对应着客户提供的短信发送接口文档进行调试，调通后用postman导出配置自动创建动作流连接器及其接口，用这个接口代替《常用通道发送》组件的发送功能。

请参考文档[ _《_ _postman_ _导出配置生成连接器及接口》_](https://eteams.cn/community/help/1973882691037859628)

 

 

#### 3.1：非模板短信

非模板短信是指e10将需要发送的短信直接拼装好提交给第三方短信通道，如：【泛微网络】您的采购流程已归档，请及时审批。给接口的短信内容是一个完整的短信，支持非模板短信的通道无需进行模板映射就可以发送，所以集成和维护成本都比较低。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514410950664&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 3.2：模板短信

模板短信是指短信内容由固定文本加变量的形式组成，比如阿里云、腾讯云就仅支持发送模板短信，通道商强制要求先在阿里云或腾讯云管理系统中创建模板且人工审核通过，然后再与E10对应的模板进行映射才可以发送短信

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518768349189&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

**组件关键字段配置说明：**

模板标识：选择触发组件上下文的”业务ID（大陆）“

模板变量：选择触发组件上下文的变量信息，注意：如果选中后显示“变量信息[0]”，需手动把0叉掉，变成“变量信息[全部]”

阿里云通道参数中sysDomain为固定值：dysmsapi.aliyuncs.com

腾讯云通道参数中endpoint为固定值：sms.tencentcloudapi.com

通道参数中的短信签名取触发组件上下文的”签名名称“即可，如下图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518822572033&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

##### 3.2.1：模板报备

以阿里云为例：登入到阿里云管理系统中，报备对应的短信模板，具体操作请参考阿里云短信服务官方说明或者咨询阿里云客服

具体操作建议：阿里云接口要求变量名和变量个数必须与报备的一致，所以我们需先明确具体哪个业务场景需要短信提醒，然后找到对应的模板，确定内容后再去阿里云系统里报备。如：登陆时的验证码短信提醒场景，对应的模板为下图：

菜单路径-> 短信->设置->系统设置->系统模板设置（右上角高级搜索支持按业务模块过滤）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518767734786&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

这里我们看到模板内容为：您的验证码为#[code] ，为了您的账号安全性，请尽快完成验证。

然后拿着这个内容去阿里云系统里进行报备。变量名称和个数都需相同，e10变量占位符为#[]，阿里云好像是{}，在阿里或腾讯备案时，按其要求调整下即可。（腾讯云的变量是按顺序映射的，变量名称不需要一致）

##### 3.2.2：模板映射

找到对应的模板鼠标移动到卡片上会显示映射按钮，看上图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514456604672&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

##### 3.2.3：审批提醒

因审批提醒类型目前没有拆分，所以针对流程审批提醒这块需特殊处理下

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523017662473&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

阿里云或腾讯云审批提醒(单变量方案)模板报备内容示例：

阿里：您有一个审批({content})，请及时处理。

腾讯：您有一个审批({1})，请及时处理。

其中content与e10流程自定义提醒模板中的变量content对应，content的实际内容可以通过流程模板自定义设置进行控制（如下图），阿里云单个变量不能超过25个字符（具体请以阿里云或腾讯云系统要求为准），注意控制下变量值的长度

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523017662466&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

以上流程审批提醒为临时解决方案，已经在推进解决流程提醒类型拆分映射的问题，还需要一段时间。如果该方案不能满足客户需求可联系（程新和李晓龙）一起沟通看下是否有其他变通方案

### 4：配置发送结果回传

配置这一步的目的是将短信的发送接口执行结果通知到短信服务，更新短信发送状态，如果不配置虽然不影响发送，但在短信服务统计分析等页面看到的发送状态始终都是“接收中”，会影响统计功能

下图是接续上面的短信发送执行组件（如常用通道发送组件）的后面，条件1的设置取决于具体的执行组件的实际返回结果，如果使用的是常用通道发送组件，那么按下图配置即可

 

发送标识来自于触发组件上下文，请按下图进行配置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514456604675&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 5：关联动作流

菜单路径：后台管理中心->应用中心->短信->系统设置->基础设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518822572037&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 四、常见问题

1.

### 短信签名重复

原因：有的短信通道商会在下发手机端时拼接短信签名，e10也会拼接短信签名所以会出现这种情况。

 

解决：开启不携带签名配置去掉e10的短信签名。

菜单路径->短信->设置->基础设置

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647527475109888&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

2.

### 签名长度不够

解决：调整签名最大长度配置，菜单路径->短信->设置->基础设置

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647523029147663&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

3.

### 没有短信菜单或租户设置没有系统短信选项

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518768349195&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

4.

### 手机收不到短信

解决：请先参考[《E10短信未收到问题自助排查手册》](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1162163226282852377&freepass_doc=1&space_id=1162093089454735415 "《E10短信未收到问题自助排查手册》")自助排查下。![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514456604678&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

5.

### 梦网webservice接口url参数填什么？

解决：[ _http://ws.montnets.com:9002/MWGate/wmgw.asmx_](http://ws.montnets.com:9002/MWGate/wmgw.asmx)

 

 

6.

### 短信模块的短信发送记录能否删除？

解决：只能库里删除, sms_task,sms_task_detail,sms_task_result，3张表

 

 

7.

### 由于运营商要求，短信内容不能包含某某字段？

解决：在租户管理平台-短信审核里检查一下有无设置敏感词：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647514472767489&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在系统后台管理中心-数据安全中检查是否设置了敏感词：

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1196647518823358470&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)
