若第三方集成无法触发Webhook回调，需系统排查：一、验证回调URL公网可达且协议合规；二、检查接收脚本正确解析JSON并即时响应；三、通过Challenge握手验证；四、审查Web服务器路由与安全策略；五、确认平台特有配置（如KOOK禁用压缩、GitLab启用内网推送、云监控放行IP段）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成WorkBuddy安装，但第三方集成（如KOOK、PayPal、MinIO或云监控等）无法触发Webhook回调，则很可能是Webhook配置项或回调地址存在基础性错误。以下是系统性排查与修复步骤：
一、验证回调URL的公网可达性与协议合规性
第三方服务必须能通过标准HTTP/HTTPS协议直接访问您配置的回调地址，任何网络隔离、协议缺失或证书问题都会导致连接中断或拒绝。
1、确认回调URL以 https:// 开头，且域名已解析至公网IP；禁止使用 localhost、127.0.0.1 或内网地址（如 192.168.x.x、10.x.x.x）。
2、在服务器外部执行curl测试，模拟第三方请求： curl -I -X POST https://yourdomain.com/webhook.php ，检查返回状态码是否为200或405（表示路径可访问）。
3、若使用HTTPS，通过 openssl s_client -connect yourdomain.com:443 -servername yourdomain.com 验证SSL证书链完整、未过期，并由可信CA签发；自签名证书将被多数平台拒绝。
二、检查Webhook接收脚本的数据解析与响应逻辑
接收端脚本必须能正确读取原始POST载荷、解析JSON、并立即返回符合规范的HTTP响应，否则第三方服务将判定回调失败。
1、确保PHP脚本使用 file_get_contents('php://input') 获取原始请求体，禁用 $_POST ——后者无法处理非application/x-www-form-urlencoded格式数据。
2、添加强制JSON解码逻辑： $data = json_decode(file_get_contents('php://input'), true); if (json_last_error() !== JSON_ERROR_NONE) { http_response_code(400); exit; } 。
3、在完成数据接收后立即发送成功响应： http_response_code(200); echo 'OK'; exit; ，避免任何后续日志写入、数据库操作或远程调用阻塞响应流。
三、校验Challenge验证流程是否通过
部分平台（如KOOK）在启用Webhook前强制执行Challenge握手，若未原样返回challenge值或超时，回调将被永久禁用。
1、捕获请求头中 Content-Type: application/json 的请求体，判断是否存在 "channel_type":"WEBHOOK_CHALLENGE" 字段。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、提取JSON中的 challenge 值，构造纯JSON响应： {"challenge":"bkes654x09XY"} ，响应头需包含 Content-Type: application/json 。
3、整个Challenge响应必须在 1秒内完成 ，建议开头加入 ob_end_clean(); if (ob_get_level()) ob_end_flush(); 清除输出缓冲。
四、审查Web服务器路由与安全策略拦截
Nginx/Apache等中间件可能因重写规则、路径限制或安全模块（如ModSecurity）静默拦截Webhook请求，造成“请求无日志、无响应”现象。
1、检查Nginx配置中是否对 /webhook.php 路径设置了 deny all 或未显式允许POST方法。
2、在Apache中确认 .htaccess 文件未启用 LimitExcept 仅放行GET/HEAD请求。
3、临时关闭WAF或ModSecurity，执行 curl -v -X POST https://yourdomain.com/webhook.php -H "Content-Type: application/json" -d '{"test":1}' ，比对开启/关闭状态下的响应差异。
五、确认第三方平台侧配置完整性与环境一致性
同一套回调脚本在不同平台表现异常，往往源于平台特有约束未满足，例如压缩、加密、Token校验或网络策略限制。
1、针对KOOK平台，在Callback URL末尾添加 ?compress=0 显式禁用zlib压缩，避免因未解压导致JSON解析失败。
2、针对GitLab，管理员需登录后台进入 Admin Area > Settings > Network > Outbound requests，勾选 Allow requests to the local network from hooks and services 才能向内网服务推送。
3、针对阿里云云监控，将官方公布的全部IP段（如 106.11.225.0/24 等）加入服务器防火墙白名单，否则请求将在网络层被丢弃。
