SMAX发送企业微信通知

Posted 2021-10-11 gnzhutan

1. 创建企业微信群聊机器人

如下，在企业微信中创建对应的群聊后，点击添加群机器人：

​​​​

如下图，生成对应的SMAX 机器人此处

​​​​

记录并保存该Webhook地址，如:

​​https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=16dcc203-bd76-422f-b48a-1111111110bb1​​

2. 安装并配置OPB

需要首先安装OPB, SMAX OPB Agent安装,可以参见如下文档说明：

​​https://blog.51cto.com/gnzhutan/4141704​​

1) 在OPB 端点凭据管理器中创建凭据

选择新建 Rest Executor Domain,并创建对应的用户名及密码.

注：此处用户名及密码，并无实际价值，但是为必选项，但为必选项，必须输入。

​​​​

2) 在SMAX端点管理器中创建EndPoint

需要在端点管理器中，创建对应的端点，此处需要填写：

1. Url前缀，来自Teams Incoming webhook，此处为：

https://qyapi.weixin.qq.com

2. 选择在OPB中创建的Credential,此处为：

wechat_Integration

​​​​

3. 配置事件工作流规则

在工作室中选择事件实体，点击分类阶段，然后选择应用变更后，添加如下Execute Rest规则，重点维护：

​​​​

1. 表达式： ${current_update.MajorIncident.IsChanged && entity.MajorIncident == true}.

2. OPB Agent Id: 选择对应的OPB AgentID.

3. OPB Endpoint Id: 选择对应的OPB EndPoint.

4. Web Method: 选择 POST.

5. Credentials Id: 选择Teams_Integration

6. Uri 后缀: 此处为/cgi-bin/webhook/send?key=16dcc203-bd76-422f-b48a-1111111110bb1

7. Payload 类型: 选择JSON.

8. Body如下:

${concat(\'{"msgtype":"markdown","markdown":{"content": "\',\'<font color=\\\'warning\\\'>\',entity.Id,\': \', escape(entity.DisplayLabel), \'</font>\\n><font color=\\\'comment\\\'>详细信息:\', escape(to_plain_text(entity.Description)), \'</font>\\n用户:<font color=\\\'comment\\\'>\',escape(entity.RequestedByPerson.Name),\'</font>\',\'"}}\')}

​​​​

4. 验证Teams集成效果

在SMAX 中创建事件，并选中Major Incident

​​​​

通过点击EndPoints, 查看Restful Call 调用记录,如下：

显示调用成功

​​​​

在企业微信中，查看对应的消息通知如下：

​​​​

至此，验证对应的企业微信集成成功.

5. 引用

对应的企业微信机器人配置说明，详见企业微信API文档：

​​https://open.work.weixin.qq.com/api/doc/90000/90136/91770​​