一、操作场景
注意:说明:
注意:Webhook 不是独立的 Channel 接入类型,而是在创建定时任务时配置的“结果投递”方式之一。Channel 仅支持接入飞书、企业微信、钉钉三种 IM 机器人,用于双向对话;Webhook 仅用于定时任务执行结果的单向推送,无法用于 IM 对话。
二、前提条件
·已创建 TencentDB Agent 实例,且实例处于运行中状态。
·当前操作账号为该 TencentDB Agent 实例的 Owner。
·已准备一个可公网访问、支持接收 HTTP POST 请求的 Webhook 地址。
三、配置方式
Webhook 结果投递在创建或编辑定时任务时配置,操作入口与完整步骤请参见 管理定时任务。核心配置如下:
1. 在定时任务配置的“结果投递”中,选择 Webhook。
2. 填写接收执行结果的 Webhook 地址。
3. 保存时,系统自动校验地址格式并发送连通性探测请求,校验通过后方可保存成功。
四、消息体格式
系统会根据 Webhook 地址自动识别目标平台类型,并按该平台的标准格式构造消息体:
·企业微信:识别到 qyapi.weixin.qq.com 域名后,按企业微信群机器人格式推送。
·飞书:识别到 open.feishu.cn 域名后,按飞书群机器人格式推送。
·钉钉:识别到 oapi.dingtalk.com 域名后,按钉钉群机器人格式推送。
·自定义:未识别到已知平台时,按通用 JSON 格式推送。
各平台默认消息体格式预览请参见 管理定时任务。
五、自定义消息体模板
如需自定义推送内容,可在配置时提供消息体模板。模板支持 ${summary} 占位符,实际推送时将被替换为 Agent 生成的执行结果内容;未配置模板时,系统使用默认格式推送。
六、连通性校验
保存配置时,系统会对 Webhook 地址执行以下校验:
·地址格式校验:地址必须以 http:// 或 https:// 开头。
·安全防护:系统使用安全网络组件对目标地址执行 SSRF 防护,拦截内网、回环及元数据地址,避免被恶意地址利用。
·连通性探测:系统向目标地址发送一次探测请求。对已识别的平台(企业微信、飞书等)会进一步校验响应中的业务返回码;对自定义地址仅校验网络可达性。
·模板校验:若配置了自定义消息体模板,探测时使用替换占位符后的真实请求体。
七、相关操作
·管理定时任务
·接入 Channel 功能简介
·管理 Channel