微信模板消息通知插件

1. 简介

1.1 插件简介

该插件支持在表单数据新增、修改时，向指定用户(微信OpenID/标签)推送服务号模板消息。支持除分割线、图片、附件、子表单、查询、关联数据、手写签名外的字段。

1.2 应用场景

常用于向外部用户反馈业务处理进度、营销推广等场景。如合同到期通知、订单发货通知、活动到期提醒、问题反馈处理通知、节日/生日祝福等。

1.3 预期效果

开启微信模板消息通知插件，在「订单发货通知」表单中输入信息提交后，自动向指定用户发送微信模板消息。效果如下所示：

1.4 使用说明

1）该插件包含四种执行事件：

2）该插件为付费插件。插件购买流程如下所示：

2. 微信平台配置

2.1 获取AppID和AppSecret

登录 微信开发者平台，在「微信开发者平台 - 我的业务 - 服务号-基础信息」中，获取 AppID 和 AppSecret。

2.2 配置IP白名单

AppSecret 启用后，在「基础信息-开发密钥」处，配置 API IP 白名单。插件固定 IP 为：47.97.99.12

2.3 设置模板消息

1）需要先认证服务号，再在「管理后台左侧工具栏 >> 新的功能 >> 广告与服务」中开通模板消息，方可查看。

2）管理员登录微信服务号管理后台，在「广告与服务 >> 模板消息 >> 我的模板 >> 类目模板」中，查看模板 ID，可先在模板库中添加对应的模板消息到我的模板中，再查看对应的模板ID。

3）点击详情，可查看微信模板消息格式：

3. 插件安装及配置

3.1 安装插件

1）直接安装

2）插件市场安装

在简道云「插件市场」处，安装「微信模板消息通知」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

3.2 配置插件

1）在插件管理中，点击「调整插件配置」按钮，配置「微信 APPID」「微信 APPSECRET」，点击保存。

3.3 启用插件

在插件管理中，打开「微信模板消息通知」插件右侧开关，启用插件。

4. 表单搭建

以订单发货通知为例，新建「订单发货通知」表单，字段设置如下所示：

5. 智能助手配置

该插件支持在 前端事件、智能助手 Pro 和 插件节点 中调用触发。本文以智能助手Pro触发为例，进行插件的调用配置。以使用 OpenID 群发消息函数为例，设置如下：

5.1 添加智能助手

设计完表单后，在「扩展功能」处添加「智能助手Pro」，并修改智能助手名称为「推送微信模板消息」，同时设置触发方式为「表单触发」，并选择表单为「订单发货通知」表

5.2 设置触发动作

当订单发货通知提交后，触发智能助手，故「触发动作」选择「新增数据」。

5.3 配置插件节点

添加插件节点，进行如下设置：

5.4 效果演示

效果参见本文【1.3 预期效果】。

6. 注意事项

6.1 关于外链自动获取到的微信OpenID能否使用的说明

由于微信 OpenID 是基于某个服务号生成的，不同模式下的账号，生成方式不同，详情如下：

6.2 多个用户OpenID配置说明

1）当多个用户的 OpenID 字段在子表中时：

因传递给插件的信息只能使用主表字段，因此需设置主表接收消息用户微信 OpenID 字段=子表 OpenID 字段取出多个用户的 OpenID，此时每个 OpenID 之间会自动以英文逗号隔开；

2）当多个用户的 OpenID 字段在主表中时：

在智能助手中配置「接收消息用户微信 OpenID」时，分别插入多个字段，每个字段以英文逗号隔开即可；

6.3 字段内容要求说明

字段内容中可以插入特殊符号，但内容中不能换行，特别是存在多行文本字段的信息时，一定注意内容不能换行。

6.4 模版消息链接说明

插件支持填写模板消息链接，填写后收到模板消息的用户点击消息可跳调转到对应的地址，若不放链接，则不填写，若需放链接，则：

6.5 数据工厂输出数据消息推送说明

当需要使用数据工厂加工后的数据来推送消息时，可以将数据工厂输出到表单，再进行消息推送，需注意以下几点：

6.6 模板消息页面标题配置说明

因当模板消息有链接时，进入链接的页面标题自动取用的表单的数据标题，因此需在表单扩展功能-数据协作-数据标题中进行配置；因自定义标题至少需添加一个表单字段，此时若需定义个性化的标题，可以在表单添加辅助字段，设置默认值为想要使用的标题，再从自定义标题中插入该字段即可。

7. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：