配置短信发送功能

通过应用与云的消息通知服务SMN（Simple Message Notification）对接，实现短信发送功能。

场景描述

给Lily发送条短信，短信内容为：“【test】：Hi Lily!”。

前提条件

已在云的消息通知服务SMN注册账号并获取关键信息。获取方法如下：

1. 在浏览器地址栏输入https://auth.huaweicloud.com/authui/login.action?locale=en-us#/login，进入云的消息通知服务SMN登录页面。
2. （可选，若需要进行账号注册，则执行该步骤）单击“Free Registration”，按照提示申请账号，并绑定邮箱。

3. 使用账号登录SMN，单击页面右上角用户名，选择“My Account”。

   图 1 选择“My Account”
   

4. 单击“Authenticate”，选择“Enterprise”按照提示进行企业实名认证。

   注意：
   为防止个人用户发送垃圾短信，SMN服务暂只向通过认证的企业用户提供短信功能。

   图 2 进行实名认证
   

   成功认证后会有认证通过的提示信息。

5. 在左侧菜单栏选择“Account Info”，在右侧“Account Info”页面单击“Manage”，获取关键信息。

   图 3 单击“Manage”
   

   1. 请获取“Username”、“Account Name”、“Project List”页签下“Project”、“Project ID”取值。

      图 4 获取关键信息
      

   2. 请在“Access Keys”页签下单击“Add Access Key”，在弹出框中填写密码和验证码，单击“OK”，在生成的“credentials.csv”文件中获取“Access Key ID”和“Secret Access Key”取值。

      图 5 单击“Add Access Key”
      

      图 6 获取关键信息
      

1. 创建签发ID，用于在短信内容中携带签发内容“test”。

   1. 在云首页选择“Simple Message Notification”。

      

   2. 选择“Text Message > SMS Message Signature”，单击“+ Create SMS Message Signature”。

      如图7所示，出现配置页面。

      图 7 “Create SMS Message Signature”页面
      

   3. 配置签名内容。配置后单击“OK”。出现创建好的SMS Message Signature。获取“Signature ID”取值。

      

配置Connector操作步骤

1. 在APP开发界面左侧列表单击，选择“连接 > 连接器”。

2. 在Connectors配置界面中单击“SMS短信服务”图标，打开Connector列表。

3. 单击“新建”。

4. 在页面中输入与云的消息通知服务SMN对接的参数，单击“保存”。

   有如下两种认证方式。

   • 选择“密钥模式”，表示用“Access Key ID”和“Secret Access Key”验证。
   • 选择“用户名密码模式”，表示用户名、密码验证。

   不同的认证方式，Connector参数配置有会有所不同。

   图 8 密钥模式新建Connector
   

   图 9 用户名密码模式新建Connector
   

   表 1 密钥模式新建Connector页面参数说明

   参数	说明
   名称	Connector的名称。在Flow中选用Connector时的一个标识。 示例： SendMessageAK
   访问密钥	当认证方式为“密钥模式”时，需要配置用户的访问密钥 ID（Access Key ID）。请与前提条件5中获取的“Access Key ID”取值保持一致。
   密钥	当认证方式为“密钥模式”时，需要配置用户的秘密访问密钥（Secret Access Key）。请与前提条件5中获取的“Secret Access Key”取值保持一致。
   项目ID	为项目的唯一标识。请与前提条件5中获取的“Project ID”取值保持一致。
   描述	可选，Connector的描述信息。

   表 2 用户名密码模式新建Connector页面参数说明

   参数	说明
   名称	Connector的名称。在Flow中选用Connector时的一个标识。 示例： SendMessage
   账号名	登录云的消息通知服务SMN的账号名。请与前提条件5中获取的“Account Name”取值保持一致。
   项目名	该SMN用户所属的项目名。请与前提条件5中获取的“Project”取值保持一致。
   用户名	使用云的消息通知服务SMN的用户名。请与前提条件5中获取的“Username”取值保持一致。
   密码	登录云的消息通知服务SMN的用户密码。
   项目ID	项目的唯一标识。请与前提条件5中获取的“Project ID”取值保持一致。
   用户类型	用户类型。 个人用户：只测试可用。实际场景中只有企业用户才可以发短信。 企业用户。
   签发ID	企业分配给企业用户的签发ID。当“用户类型”为“企业用户”时，该参数可见且需要配置。 请与前提条件6中获取的“Signature ID”取值保持一致。 不填默认为云企业用户。
   描述	可选，Connector的描述信息。

1. （可选）创建Connector后，您可进行简单的测试，测试是否能发送短信。

   1. 在该Connector详情页面单击“发送测试”。

   2. 输入接收者号码和短信内容，单击“发送”。

      接受者收到短信，表示测试成功。

调用Connector

您可以在业务Flow中调用Connector实现与云的消息通知服务SMN的对接，这里以新建一个Flow实现短信发送功能为例进行举例说明。

1. 鼠标放在APP下的Logic文件夹旁会出现加号，单击加号，选择“流”。
2. 系统弹出“添加流程”的对话框，选择“创建一个新的流”，填入Flow名称等信息，单击“添加”。

3. 在Flow编辑器页面左侧选择“连接器 > Huawei Cloud > SMS”，拖拽“SMS”图标至画布中，弹出“SMS”配置窗口。

   “SMS”是系统预置的与SMN对接的短信发送接口。

4. 在“基本信息”页面进行配置。

   参数说明如下。

   • 标签：该图元的展示名。
   • 名称：该图元的唯一标识，不能和其他图元相同。
   • 连接器：该Flow使用的Connector的名称。选择刚刚创建的“SendMessage”。

   

5. 设置调用“SMS”参数。

   图 10 配置“SMS”
   

   表 3 “SMS”参数说明

   参数	说明
   动作	设置为“Send SMS”，是系统预置的短信发送接口。
   输入参数	输入参数。取值说明如下： “目标”取值为“endPoint”时：请在“源”里配置短信接收者手机号，可定义为一个输入型变量“{!Phone}”。 “目标”取值为“message”时：请在“源”里配置短信内容，可定义为一个输入型变量“{!Message}”。 单击“新增行”可进行添加。
   输出参数	输出参数。“源”从下拉框选择为“result”，“目标”用于接收短信发送结果（是否成功发送），必须定义一个空实例的结构变量来进行接收。

6. 在左侧选择“逻辑 > 决策”，拖拽“决策”图标至画布中，弹出“决策”配置窗口，配置“决策”。

   决策是对当前条件进行判断，根据判断的结果决定执行何种操作，类似if语句的判断。

   当短信发送成功时，系统会将“resCode”赋值为“0”，这里创建Decision判断“resCode”是否为“0”，来输出发送是否成功的标识（例如“sendFlag”）从而进行后续操作。

   1. 增加“GetResultCode”公式变量，用于接收短信发送结果。

      图 11 配置“GetResultCode”公式变量
      

   2. 配置“决策”的成功分支。success表示“resCode”为“0”，短信发送成功分支。

      图 12 配置“决策”成功分支
      

   3. 配置“决策”的失败分支。error表示其他分支，即短信发送失败。

      图 13 配置“error”分支
      

1. 在左侧选择“逻辑 > 赋值”，拖拽“赋值”图标至画布中，弹出“赋值”配置窗口，进行配置。

   赋值是创建变量的图元，主要作用就是给变量赋值。这里增加符合“success”分支的操作，短信发送成功，输出成功标识。

   

2. 参考上一步配置符合“error”的赋值操作。

   

3. 如图14所示连接所有图元。

   图 14 连接元素
   

4. 单击Flow编辑器空白区域，选择，设置Flow入参和出参。

   

5. 单击，保存Flow。

6. 单击，运行Flow。

7. 单击“Run”，设置输入参数（接受者号码和短信内容），运行Flow。

   图 15 运行Flow
   

   如图16所示，表示发送成功。

   图 16 发送成功