# 微信公众号消息推送-连接器介绍与配置说明
# 连接器介绍
# 连接器简介
「微信公众号消息推送」连接器连通了七巧与微信公众号管理后台。通过「微信公众号消息推送」连接器，使用者在七巧上就能向指定人员推送公众号消息。
# 业务场景
微信服务号是当今一种重要的消息传递的渠道，除了常见的公众号推文，服务号还能构建一些简单的服务功能，并基于这些功能实现对应的消息提醒。
而微信服务号消息发送连接器正是“为此而生”的，例如：用户在公众号上发起服务后，通过七巧的接口将信息传递给企业内对应的员工，在处理完成业务后，就能主动向用户推送公众号服务完成的提醒。
# 连接器配置说明
# 配置入口
表单添加按钮/自定义按钮-执行后-连接器配置
流程-系统任务-执行事件-连接器配置
# 使用前提
该连接器对接微信服务号模板消息推送接口，需要事先在微信公众平台创建消息模板，获取该模板的模板id，并且同时获取appid appsecret，和推送用户的openid后才能正常使用。
以下是获取这些参数的步骤：
# 1. 注册微信服务号账号，登录微信公众平台
# 2.获取消息模板id
# ①点击左下角的菜单“新的功能”，开通模板消息功能 👇
注意事项：
● 如果在未开通的页面看到有模板消息代表未开通模板消息，需要点击模板消息的“去开通”按钮，按照引导开通；、
● 如果未开通中没有模板消息代表已开通。
● 只有已认证的企业服务号才会有模板消息功能，而订阅号没有。
# ②在模板消息的详情页面点击“查看功能”，查看当前已选择的模板
# ③ 从模板库中选择模板
注：
模板不支持自定义，必须要从模板库添加才可以，如果“我的模板”列表下没有内容代表没有添加过任何模板，需要点击“模板库”从库中添加对应的模板。发送消息使用的是“我的模板”内的模板列表。
而行业不同需要的模板也不同，根据公众号的服务行业选择两个行业，支持一个月修改一次，请根据本身的运营选择对应的行业；点击模板的“详情”，可以查看模板的具体内容以及添加模板。
# ④将选择的模板添加到我的模板中
具体模板的详情页面，可以点击下面的“添加”按钮，将选中的模板添加至我的模板中，后续可以通过调用模板消息接口就可以使用此模板发送消息。
# ⑤由此就能在【我的模板】处，获取到对应的模板消息id
注：在配置消息模板的时候要注意，按照设置好的消息模板格式来传参，如果类型不一致会导致发送失败
# 3. 获取appid appsecret
# 4.获取用户openid
# ① 绑定微信服务号
进入开发平台管理员后台-系统管理-其他-系统扩展-微信公众号集成，点击“立即授权”
进入微信服务号扫码授权页面，由微信服务号管理员扫码绑定即可
# ②通过外部单流程审批获取用户openid的方法如下：
新建一个外部表单→配置信息绑定字段（例：让用户填写姓名，手机号等字段，实现系统内用户信息的匹配或新增）→获取表单链接→将链接配置在微信公众号上，让用户填写外部单填写信息发起流程→最后利用提交后流程上的脚本，实现openid回调写入系统→通过这些步骤就能构建起一个用户信息和openid匹配的信息库，供后续推送消息使用。
有关脚本代码参考：
(function () {
//获取应用id
var applicationId = $.context.getCurrentApplicationId();
//从当前表单文档里面获取(外部单数据)
var currentDocument = $.context.getCurrentDocument();
//接收人微信openId
var wxOpenId = currentDocument.getAuthor();
//截取openId
wxOpenId = wxOpenId.slice(7);
//写入当前表单文档openid字段
currentDocument.addElement("openid", wxOpenId);
//保存当前表单文档
$.form.saveFormDocument(currentDocument, applicationId);
})()
# 连接器配置
# 1.请求事件配置
筛选条件属于必填项，可配置 id = id 的方式实现选择数据的一一对应。
# 2.接口请求配置
①将第二步在微信公众平台获取的参数 appid appsecret 模板id 填入
②配置需要与表单字段联动的参数 即配置接收人微信id（openid），点击消息跳转的链接以及消息内容，与本表字段联动
注意：消息内容参数可以根据消息模板的配置进行灵活调整，但是注意同时也要修改脚本内容
# 3.配置返回事件
微信公众平台提供了3个返回参数可供调用，用来提示消息是否发送成功.可根据自己的使用习惯来确定是否配置返回事件。
下面是一个使用案例：
当errcode=0；errmsg=ok时，即表示发送成功 并可以将消息的id（msgid）返回
# 使用案例
通过连接器传入表单字段：
效果展示
