sendcloud短信通知插件
1. 简介
1.1 功能简介
sendcloud 通知插件是指,通过 sendcloud 平台向指定手机号发送自定义内容的通知,支持短信和语音短信通知。
1.2 应用场景
当有外部成员在简道云提交数据或是参与流程时,可以将业务相关信息通过发送短信/语音的方式及时通知到对方。如,在订单配送业务中,客户通过简道云外链提交订单,待配送员进行配送时,可以通过短信通知插件告知客户订单进展,向客户展示企业订单服务的专业度。
1.3 预期效果
以短信通知为例,当流程流转到配送员配送时,订单状态被修改为「配送中」,此时将为客户发送一条订单配送的短信提醒。效果如下所示:
2. sendcloud 相关设置
2.1 注册认证
注册完成后,并提交企业信息进行企业认证审核,只有认证通过的账号,才能使用 sendcloud 的短信发送服务。
注:个人认证暂不支持短信发送服务。
2.2 短信模板设置
设置短信模板后,简道云中的短信通知将按照模板进行通知。
2.2.1 短信签名
短信签名是在短信内容后面或前面附加个性化签名,可以帮助用户快速识别短信来源,也可以为发送短信的企业树立品牌形象。
在 sencloud 后台「发送相关 >> 短信签名 >> 创建短信签名」。只有提前创建了签名,后面的短信模板中才可以选中签名进行模板设置。
如下图的【简道云】和【帆软软件】就是发送短信时的签名效果。
注:根据运营商的要求,短信签名是必须设置的。签名建议3~8个字符,设置时不用带【】,发送时会自动带上【】。
2.2.2 设置短信模板
1)设置了签名后,在模板管理中创建短信模板。
2)选择了模板类型后,填写模板内容,填写完毕后提交审核。填写的过程可以右侧预览效果。
注:模板设置后,需要 sendcloud 平台审核,审核通过后方可使用。sencloud 审核时间为工作日的工作时间每小时一次。
3)如果短信内容需要使用变量,则需要在编写内容时候,设置变量。变量名不可是中文,变量两侧用%隔开,且%和变量名均为英文格式符号。
如下图插入变量 %name%,变量 name 在简道云可以配置到对应的表单字段进行赋值,后文【2.4 节】会继续讲解。
2.3 参数记录
完成上述动作后,需要记录几个重要参数,参数为短信通知插件配置成功的关键因素。
2.3.1 SMS_USER 和 SMS_KEY
在 sendcloud 主页里找到 SMS_USER 和 SMS_KEY 这两个参数记录下来,短信通知插件需要配置这两个参数方可启用。
2.3.2 模板ID
短信模板审核通过后,复制短信模板 ID,在配置插件执行动作时需要使用。
注:模板的审核状态为「审核通过」方可使用该模板 ID。
2.3.3 模板变量
如果短信模板设置了变量,那么也需要将变量记录下来,在配置插件的时候需要给变量赋值。
3. 安装并配置插件
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:Sendcloud 短信通知插件安装。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「SendCloud短信通知」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
点击插件右侧的设置按钮,将【2.3.1节】中的参数配置好。
3.3 开启插件
配置好参数后,开启插件。
4. 表单搭建
插件使用体验可点击右侧链接:sendcloud 短信通知插件模板表单。本文将按照示例表单进行讲解。
4.1 创建表单
以订单配送通知为例为例,新建「订单配送通知」流程表单,字段设置如下所示:
字段名称 | 字段类型 | 字段设置 |
订单明细 | 子表单 | —— |
产品名称 | 子字段-单行文本 | |
数量 | 子字段-数字 | |
单价 | ||
小计 | 在「字段属性 >> 默认值」处设置为公式编辑,编辑公式为: 订单明细.数量*订单明细.单价 | |
订单总金额 | 数字 | 在「字段属性 >> 默认值」处设置为公式编辑,编辑公式为: sum(订单明细.小计) |
收件人 | 单行文本 | —— |
收件人手机号 | ||
收货地址 | 地址 | |
订单状态 | 单选按钮组 | 在「字段属性 >> 选项」处,设置选项分别为:
|
4.2 流程设定
流程表单配置完成后,切换至「流程设定」中,进行流程配置。
4.2.1 配置订单发起节点
点击流程发起节点,进行以下操作:
- 在「节点属性 >> 节点名称」处,修改节点名称为「订单发起节点」;
- 在「节点属性 >> 字段权限」处,勾选部分字段的「可见」、「可编辑」权限。
4.2.2 配置配送状态节点
点击审批节点审批节点,进行如下设置:
- 在「节点属性 >> 节点名称」处,修改节点名称为「配送状态」;
- 在「节点属性 >> 负责人」处,选择审批负责人;
- 在「节点属性 >> 字段权限」处,勾选部分字段的「可见」、「可编辑」权限。
4.2.3 启用流程
流程设定完成后,点击「保存」后,再点击「启用流程」,即可启用当前订单配送通知流程。
5. 智能助手配置
5.1 添加智能助手
设计完表单后,在「扩展功能 >> 智能助手」处点击「新建智能助手」,并修改智能助手名称为「订单配送提醒」,触发方式选择「表单触发 >> 订单配送通知 」。
4.2 设置触发动作
由于订单配送场景中,需要当订单状态变更为「配送中」时,给用户发送订单配送的提醒通知,而订单配送提醒为流程表,故触发动作设置如下:
- 触发动作:设置为「修改数据」时;
- 触发条件:设置为「订单状态等于配送中」时。
注:短信通知支持的触发动作:新增数据、修改数据、删除数据,其他动作暂不支持。
4.3 插件节点设置
添加插件节点,且插件节点设置如下:
- 执行插件:选择「SendCloud 短信通知」插件;
- 收件人手机号:设置为「字段值」,即「触发数据—收件人手机号」字段;
- 短信类型:设置为「自定义」,下拉框中选择「短信」;
- 短信模板 ID:设置为「自定义」填写【2.3.2 节】中复制的模板 ID,短信将按照此模板进行推送;
- 模板变量:设置名称为 name,值为「触发数据—收件人」。
注:
1)在收件人手机号处,若需要设置多个手机号,可使用逗号分隔后进行添加。
2)变量值支持选择的字段类型:单行文本、多行文本、数字、日期时间、单选按钮组、复选框组、下拉框、下拉复选框、地址、定位、成员单选、成员多选、部门单选、部门多选、流水号、手机号、提交人、提交时间;
3)变量值选择的字段只能是主表中的字段;
4)对于变量内容,发送短信时最多推送前 16 个字符,超出 16 个字符的部分将会调用失败报错,需用户自行调整。单个汉字、数字、英文算一个字符。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 发送规则说明
1)sendcloud 平台每次最多支持对 2000 个手机号发送短信通知,但由于智能助手一次最多执行 200 条数据,因此在简道云中,单次最多可以实现 200 个手机短信的发送服务。
2)短信发送条数需要在 sendcloud 平台购买,只有短信条数足够,才能成功发送短信消息。
3)优惠购买参考文档:简道云 X sendcloud 优惠政策。
5.2 插件执行动作说明
选择插件后,需要配置执行动作的具体内容如下:
执行动作内容 | 内容含义 | 填写规则 |
收件人手机号 | 需要接收短信的手机号 | 可以选择主表单中的「单行文本」和「手机字段」 |
短信模板 ID | 填写【2.3.2 节】中复制的模板 ID,短信将按照此模板进行推送 | 需要哪个业务,就填写哪个模板 ID |
模板变量 | 名称填写【2.3.3 节】中设置的模板变量,短信发送时将根据名称对应推送;根据变量值的不同,短信中的变量内容也将不同 | 1)多个变量需要一一赋值,变量值可以是自定义值,也可以选择表单字段; 2)变量名称需要与短信模板中的变量名称一一对应; 3)变量名称为短信模板中去掉%后的内容,即模板中写了 %name%,这里仅需写 name。 |
5.3 发送结果查询
短信发送结果可以在 sendcloud 短信服务的 数据中心 查询。