qoderwake需通过webhook与github等系统集成：一、在qoderwake配置接收端，获取唯一url和仅显示一次的hmac-sha256密钥；二、在github等外部系统注册该url并填入密钥以启用签名校验；三、启用权限沙盒与审计日志确保操作可追溯；四、配置调试与自动重试机制保障可靠性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake数字员工能与GitHub、Slack、Notion、CRM等外部系统实时交互并自动响应事件，则需通过Webhook机制建立稳定、安全的双向通信通道。以下是实现该集成的具体操作路径：
一、配置Webhook接收端（QoderWake侧）
QoderWake通过内置Connector框架支持标准HTTP Webhook接收，需在管理后台启用对应服务并获取唯一签名密钥，用于验证请求来源合法性，防止伪造事件注入。
1、登录QoderWake企业控制台，进入【集成中心】→【Webhook管理】。
2、点击【新建接收端】，选择目标系统类型（如GitHub或自定义HTTP服务）。
3、系统自动生成唯一Webhook URL与HMAC-SHA256签名密钥，请立即复制并安全保存密钥，该密钥仅显示一次。
4、在【事件订阅】中勾选需触发的数字员工行为，例如“push事件”“issue创建”“告警触发”等。
二、在外部系统注册Webhook（以GitHub为例）
外部系统需将指定事件推送至QoderWake提供的URL，推送内容须包含有效载荷及签名头，QoderWake将依据密钥校验其真实性，确保仅受信源可激活数字员工执行动作。
1、进入GitHub仓库Settings → Webhooks → Add webhook。
2、在Payload URL栏粘贴QoderWake生成的Webhook URL。
3、Content type选择application/json。
4、Secret字段填入上一步复制的HMAC-SHA256密钥，此项为强制校验项，缺失将导致QoderWake拒绝处理所有请求。
5、勾选需要触发的事件类型，如Pushes、Pull requests、Issues等，点击Add webhook完成注册。
三、启用权限沙盒与审计日志联动
Webhook触发的操作默认运行于独立权限沙盒内，所有调用动作、参数、返回值均写入不可篡改的审计日志，确保每一步联动行为可追溯、可复盘，满足生产环境合规要求。
1、在QoderWake控制台【安全策略】→【沙盒配置】中确认“Webhook触发任务”已启用隔离执行模式。
2、进入【审计中心】→【Webhook事件流】，查看实时流入的原始请求与数字员工响应记录。
3、对任意一条记录点击详情，可展开完整HTTP头、载荷体、签名验证结果及执行耗时，验证失败的请求将标注为红色并附带具体错误码。
四、调试与重试机制配置
网络抖动或临时故障可能导致Webhook投递失败，QoderWake提供内置重试队列与手动触发调试功能，支持开发者快速定位集成链路中的异常节点。
1、在【Webhook管理】列表中，找到目标接收端，点击右侧【调试】按钮。
2、选择预设测试事件模板（如模拟GitHub push payload），系统自动填充标准字段并发起带签名的本地回环请求。
3、在【重试策略】设置中，配置最大重试次数（默认3次）与指数退避间隔（初始1秒，每次×2）。
4、当外部系统返回非2xx状态码时，QoderWake自动加入重试队列，并在【失败事件】页签中高亮显示，所有重试尝试均保留完整上下文，不丢失原始事件ID与时间戳。
