卡片详情

配置消息通知后,对 Issue 进行相关操作,即可针对对应的配置事件推送企业微信消息给用户。消息通知分为两大类文本消息、卡片消息。

注:

  • 该功能目前仅支持 WeChat Work for Jira 1.6.0 及以后的版本
  • 必须先插件端【卡片配置】-【回调配置】然后进行企业微信自建应用的【设置API接收】,否则自建应用的API接收功能无法成功保存。

其中卡片消息又分为:普通卡片、交互式卡片。

一、交互式卡片:

通过交互式卡片可以在企业微信端一目了然的看到待处理、已处理的 Issue 以及是否已阅读,提高用户在移动端办公效率。

1)卡片展现方式

1.1. 默认交互式卡片:用户收到卡片消息后,显示未读状态。

当用户查看了该 Issue 后当前卡片会变更为已读

1.2. 配置卡片审批流程后发送的审批流程卡片:

用户收到的卡片消息初始状态为工作流的状态(或者自定义),当用户对该Issue 审批后会变更为当前审批的动作名(或者自定义)。

2交互式卡片配置

使用交互式卡片需要在企业微信端进行配置自建应用的回调配置功能、配置插件端的回调配置。

2.1. 插件端的回调配置

必须先在插件端配置 token 、EncodingAESKey 通过插件的【全局配置】-【卡片配置】-【回调配置】设置。

(默认已生成,如需更改根据企业微信API接收配置规则生成即可)

2.2. 自建应用的回调配置

通过企业微信后台管理界面登录后进入【应用管理】-【应用】点击对应的应用进入应用详情,在【功能】-【接收消息】-【设置API接收】中配置URL 、token 、EncodingAESKey选择默认事件即可。

注:

如图:

3)卡片消息

3.1. 测试卡片消息

回调配置成功之后,点击“测试卡片消息”,显示“发送成功”,并且当前操作用户会收到一条卡片消息,这时用户就可以使用交互式卡片消息了。


注:

  • 当企业微信后台没有回调配置时,请将回调配置开关关闭,这时会发送普通消息。当企业微信后台回调配置成功后,测试卡片消息发送成功后,可以将回调配置开关开启,这时将发送交互式卡片消息。
  • 若回调配置没有成功,开关开启,将接收不到卡片消息。
  • No labels