...
| 信息 | ||
|---|---|---|
| ||
配置消息通知后，对 Issue 进行相关操作，即可针对对应的配置事件推送企业微信消息给用户。消息通知分为两大类文本消息、卡片消息。 其中卡片消息又分为：普通卡片、交互式卡片 |
一 卡片样式
1）普通卡片：
...
注：
其中卡片消息又分为：普通卡片、交互式卡片。 |
一、交互式卡片：
通过交互式卡片可以在企业微信端一目了然的看到待处理、已处理的 Issue 以及是否已阅读，提高用户在移动端办公效率。
1）卡片展现方式
1.1. 默认交互式卡片：用户收到卡片消息后，显示未读状态。
当用户查看了该 Issue 后当前卡片会变更为已读。
→ 
1.
...
1.进行完以下配置后，我们将接收到template_card 类型的卡片消息。详见用户操作手册中的通知卡片说明。
2.初始情况下，回调配置的开关是关闭的，此时发送的卡片的卡片类型是 textcard。WeChat Work for Jira 1.6.0 版本提供了 template_card 类型的卡片消息，若是要发送这种卡片消息，先将回调配置开关打开，其次在企业微信后台进行回调配置。
(1)首先将回调配置开关打开，我们会默认提供 Token 与 EncodingAESKey（您也可根据需求自行修改，通过企业微信端获取。第(2)点）。然后进入企业微信后台，点击应用管理，选择公司使用的 Jira 自建应用，点击“设置API接收”。
(2)这里的 Token 与 EncodingAESKey 可以使用我们提供的，也可以在这里随机获取，但在点击这里的“保存”按钮之前，需要先将这里的 Token 与 EncodingAESKey 复制粘贴到我们全局配置的 Token 与 EncodingAESKey 输入框中并保存，使两边的 Token 与 EncodingAESKey 保持一致。这样可以使企业微信这边保存时验证能够通过。
2. 配置卡片审批流程后发送的审批流程卡片：
用户收到的卡片消息初始状态为工作流的状态（或者自定义），当用户对该Issue 审批后会变更为当前审批的动作名（或者自定义）。
→ 
| 锚 | ||||
|---|---|---|---|---|
|
使用交互式卡片需要在企业微信端进行配置自建应用的回调配置功能、配置插件端的回调配置。
2.1. 插件端的回调配置
必须先在插件端配置 token 、EncodingAESKey 通过插件的【全局配置】-【卡片配置】-【回调配置】设置。
（默认已生成，如需更改根据企业微信API接收配置规则生成即可）
2.2. 自建应用的回调配置
通过企业微信后台管理界面登录后进入【应用管理】-【应用】点击对应的应用进入应用详情，在【功能】-【接收消息】-【设置API接收】中配置URL 、token 、EncodingAESKey选择默认事件即可。
注：
- URL需配置如下格式。例
...
- : http://【Jira BaseUrl】/rest/weChat-jira/2/wechatMessage/receivedMessage/
- Token 、EncodingAESKey 必须在插件端和企业微信端保持一致，并且先配置插件端才可正常配置。
如图：
3）卡片消息
...
3.
...
1.
...
...
测试卡片消息
回调配置成功之后，点击“测试卡片消息”，显示“发送成功”，并且当前操作用户会收到一条卡片消息，这时用户就可以使用交互式卡片消息了。
注：
- 当企业微信后台没有回调配置时，请将回调配置开关关闭，这时会发送普通消息。当企业微信后台回调配置成功后，测试卡片消息发送成功后，可以将回调配置开关开启，这时将发送交互式卡片消息。
- 若回调配置没有成功，开关开启，将接收不到卡片消息。