微信模板消息通知插件
1. 简介
1.1 插件简介
该插件支持在表单数据新增、修改时,向指定用户(微信OpenID/标签)推送公众号模板消息。支持除分割线、图片、附件、子表单、查询、关联数据、手写签名外所有的字段。
1.2 应用场景
常用于向外部用户反馈业务处理进度、营销推广等场景。如合同到期通知、订单发货通知、活动到期提醒、问题反馈处理通知、节日/生日祝福等。
1.3 预期效果
开启微信模板消息通知插件,在「订单发货通知」表单中输入信息提交后,自动向指定用户发送微信模板消息。效果如下所示:
注:微信模板消息通知,企业需使用自身的微信公众号进行通知,非简道云公众号。
1.4 使用说明
1)该插件包含四种执行事件:
- OpenID 群发消息
- 标签群发消息
- 获取用户标签
- 获取模板内容
注:可以以 OpenID、用户标签两种方式来推送消息,且 OpenID 和标签都可以设置多个;后两个函数作为推送消息的辅助功能,可以获取标签到复选框字段和获取模板内容到多行文本字段,以方便大家进行标签和模板内容的设置。
2)该插件为付费插件,请联系我们增购。插件购买流程如下所示:
注:插件购买期限需要和简道云版本期限保持一致。
2. 插件安装及配置
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:微信模板消息通知安装链接。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场安装
在简道云「插件市场」处,安装「微信模板消息通知」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
1)在插件管理中,点击「调整插件配置」按钮,配置「微信 APPID」「微信 APPSECRET」,点击保存。
2)微信管理员可登录微信公众号管理后台,在「设置与开发 >> 基本配置」中,查看「微信 APPID」和「微信 APPSECRET」:
注:需在「基本配置 >> IP 白名单」中添加 IP 白名单,插件固定 IP 为 47.97.99.12。
2.3 启用插件
在插件管理中,打开「微信模板消息通知」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:微信模板消息通知插件模板表单。本文将按照示例表单进行讲解。
以订单发货通知为例,新建「订单发货通知」表单,字段设置如下所示:
字段名称 | 字段类型 |
用户微信 OpenID | 单行文本 |
消息标题 | |
订单编号 | |
发货时间 | 日期时间 |
物流公司 | 单行文本 |
快递单号 | |
收件信息 | |
备注 |
4. 智能助手配置
以使用 OpenID 群发消息为例,设置如下:
4.1 添加智能助手
设计完表单后,在「扩展功能」处添加「智能助手」,并修改智能助手名称为「订单发货通知」。
4.2 设置触发动作
由于当订单发货通知提交后,触发智能助手,故「触发动作」选择「新增数据」,「触发表单」选择「订单发货中通知」,设置完成后点击「完成」。
4.3 设置执行动作
1)订单发货通知提交后,触发「微信模板消息通知」插件,故执行动作在「插件」中选择「微信模板消息通知」。
2)根据企业信息,将「用户OpenID」、「模板ID」、「模板内容」、「模板链接」配置进去,配置完成后,依次点击「完成」和「保存」按钮,保存智能助手设置。
- 用户OpenID:【字段值】,选择表单中的微信 OpenID 字段值;
- 模板ID:【自定义】,填写微信公众号模板消息的ID;也可切换到【字段值】选择表单字段值带入模板 ID;
- 模板内容:【组合】,使用表单字段或者输入固定文本替换模板详细内容中的参数;(模板内容的格式可去公众号管理后台复制模板详细内容;也可通过获取模板内容函数获取内容后复制到这里;)
- 模板链接:【自定义】,可填写固定地址;也可切换到【字段值】选择表单字段值带入动态地址;
3)管理员登录微信公众号管理后台,在「广告与服务 >> 模板消息 >> 我的模板 >> 模板详情」中,查看模板 ID。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 关于外链自动获取到的微信OpenID能否使用的说明
由于微信 OpenID 是基于某个公众号生成的,不同模式下的账号,生成方式不同,详情如下:
- 微信服务号集成用户:外链获取到的微信 OpenID 就是基于所集成的服务号生成的,可以直接使用该微信 OpenID 在此服务号进行消息推送;
- 其他模式用户:外链获取到的微信 OpenID 是基于简道云服务号生成的,无法使用此 OpenID 通过自己的服务号进行消息推送,需要借助其他方式拿到用户在自己公众号下的OpenID,再使用这个新的 OpenID 进行消息推送。
思路探讨:其他模式用户,似乎可以再新注册一个简道云的账号,绑定到自己的服务号上,用于收集用户的 OpenID,此时就可以使用这个 OpenID 进行模板消息的推送了;
5.2 多个用户OpenID配置说明
1)当多个用户的 OpenID 字段在子表中时:
因传递给插件的信息只能使用主表字段,因此需设置主表接收消息用户微信 OpenID 字段=子表 OpenID 字段取出多个用户的 OpenID,此时每个 OpenID 之间会自动以英文逗号隔开;
2)当多个用户的 OpenID 字段在主表中时:
在智能助手中配置「接收消息用户微信 OpenID」时,分别插入多个字段,每个字段以英文逗号隔开即可;
5.3 字段内容要求说明
字段内容中可以插入特殊符号,但内容中不能换行,特别是存在多行文本字段的信息时,一定注意内容不能换行。
注:换行会出现报错。
5.4 模版消息链接说明
因目前「流程表单」不支持单条数据外链,只有「普通表单」可以使用单条数据外链,且可以设置外链可见字段;若不放链接,则不填写,若需放链接,则:
- 当业务表单为普通表单时:可以直接在此表进行消息推送;因这个单条数据外链无法自动获取到,需要手动处理这个外链地址,再作为参数传递到消息模版;
- 当业务表单为流程表单时:
- 若推送的消息需要使用单条数据链接:建议先把数据通过智能助手写入一个普通表单再进行消息推送;
- 若推送的消息使用的某个固定链接:则可以直接在此表进行消息推送。
5.5 数据工厂输出数据消息推送说明
当需要使用数据工厂加工后的数据来推送消息时,可以将数据工厂输出到表单,再进行消息推送,需注意以下几点:
- 数据工厂输出数据不能直接触发智能助手:可以将输出表更换为流程表单,设置一个虚拟审核节点,并配置节点限时自动提交;此时再设置智能助手触发条件为修改数据 and 流程状态=流转完成即可触发到智能助手;
- 模板消息链接说明:因上一步使用的是流程表单,若需使用消息链接,参考【5.4 进行配置】。
5.6 模板消息页面标题配置说明
因当模板消息有链接时,进入链接的页面标题自动取用的表单的数据标题,因此需在表单扩展功能-数据协作-数据标题中进行配置;因自定义标题至少需添加一个表单字段,此时若需定义个性化的标题,可以在表单添加辅助字段,设置默认值为想要使用的标题,再从自定义标题中插入该字段即可。
6. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)