用途:诊断并修复 Meta 应用的 Webhook 投递问题,例如收不到事件、数据错误或特定主题异常。
主要能力:列出全部活跃订阅与可用主题进行对比;发送测试负载验证回调端点是否可达并返回 200;对比已订阅字段与预期字段,增删字段;识别同一主题上的重复订阅与潜在冲突;输出问题严重级别、根因分析与修复建议。
使用方式:先调用 devtools_skill_invocation(action start,skill_name debug-webhooks),后续每个 devtools_* 调用都带上该 skill_name。向用户确认应用名称或 ID(名称可用 devtools_app_list 的 action list 解析,多个匹配时让用户选择)以及具体故障现象。并行执行 devtools_webhook_list 的 action list_subscriptions 与 action list_topics。诊断后对相关订阅调用 devtools_webhook_test 的 action test_send 测试投递。字段调整用 devtools_webhook_manage 的 action update_fields,通过 add_fields 或 remove_fields 增删。注意:update_fields 没有 callback_url 参数,传入会被静默忽略;要改回调 URL 需对主题重新执行 subscribe(带新 URL 与 verify token),它是 upsert,会原地覆盖,无需先取消订阅。完成后调用 devtools_skill_invocation(action end)。
适用场景:无订阅、回调返回非 200、应用缺少页面或账号级订阅、字段缺失导致事件不完整、同主题多订阅导致重复投递、测试成功但真实事件不到达等。
限制:资料未提供具体平台支持范围、权限要求、配额或收费信息;测试成功但真实事件缺失时,问题可能位于应用侧权限或页面订阅,需另行检查。