腾讯云语音

FlashCat 支持使用腾讯云语音渠道进行告警通知，下面就介绍如何配置对接腾讯云语音。

配置字段说明

夜莺模版参数	腾讯云	解释说明
TcSecretId	SecretId	云API密钥是构建腾讯云 API 请求的重要凭证。用于调用腾讯云API时生成签名。仅支持在创建时查看，请及时保存SecretKey。
TcSecretKey	SecretKey	同上
TcSdkAppId	SDK AppID	语音应用的唯一标识，调用语音API接口时，需要提供该参数。
TcTplId	语音模板 ID	控制台审核通过的模板 ID
TcEndpoint	腾讯语音就近地域接入域名”vms.tencentcloudapi.com”	指定地域接入参考服务地址。
TcRegion	Region	地域参数，用来标识希望操作哪个地域的数据。接口 Region 字段的可选值如下：华北地区（北京）ap-beijing;华南地区（广州）ap-guangzhou;

使用配置示例

1.创建 SecretId & SecretKey

在腾讯云控制台 API 密钥管理中新建密钥

注意：新建的密钥只在创建时提供SecretKey，后续不可再进行查询，请保存好SecretKey。

2.创建 SDK AppID

腾讯云控制台应用管理—>应用列表—>创建应用，创建好后就可以看到 SDKAppID 。

3.创建语音模板获取语音模板 ID

腾讯云控制台应用管理—>语音模版—>创建语音模版。

注意：

● 选择对应应用再创建语音模版。

● 语音模版中不支持任何变量。

● 创建完成语音模版需要等待腾讯云审核，腾讯云审核规范。

填写模版内容就是你要语音播报的内容。

常规模版(无变量使用)

变量语音模版

在创建语音模板时，模板内容使用变量{1},这样在告警通知时，会把{1}替换为tx-voice通知模板内容。

创建完成后就可以在页面看到语音模版 ID ，在语音模版状态是审核已通过才能使用。

4. FlashCat 填写腾讯云语音配置

根据上面在腾讯云获得的参数值填写到对应字段中即可。

注意：

TcEndpoint ：vms.tencentcloudapi.com是腾讯语音就近地域接入域名，如指定地域接入参考服务地址。

TcRegion ：地域参数，可选值 ap-beijing 或 ap-guangzhou ；

5.配置通知模版

在系统设置通知模版—>选择 tx-voice 模版，在 tx-voice 模版中可以自定义告警展示信息。上面在创建语音模版使用变量，那么{1}会替换为下面模板中S{{.Severity}}{{if .IsRecovered}}Recovered{{else}}Triggered{{end}}{{.RuleName}}的变量内容。通知模板编写可以参考此文档 https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v6/faq/go-template/

6.配置腾讯云语音

通知媒介中勾选tx-voice
选择告警接收组 (组内成员必须填写正确手机联系方式才能接收到短信通知)

在人员组织—>用户管理 配置用户手机号码

日志排错

如果无法正常发送消息，可以在 FlashCat 的 ERROR.log 中查看相关报错信息进行排查，过滤关键词sender。