SuperAPI AI 工具集

webhook-setup

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:为 Meta 应用从零配置 Webhook,覆盖发现可用主题、订阅字段、验证回调地址到发送测试负载的完整流程。

主要能力:列出所有可用 Webhook 主题(如 page、user、instagram、whatsapp_business_account);查看已有订阅;展示每个主题下可订阅字段;执行订阅;发送测试负载验证投递;支持更新已有订阅字段。

使用方式:先调用 devtools_skill_invocation(action start,skill_name webhook-setup)开始跟踪,后续每个 devtools_* 调用都需带上 skill_name webhook-setup。确认应用:向用户询问应用名称或 ID,若为名称则调用 devtools_app_list(action list)按名称不区分大小写匹配 app_id,多个匹配时列出候选(名称、ID、查看者角色)让用户选择,数字 ID 可直接使用。检查现状:并行调用 devtools_webhook_list(action list_topics)与 devtools_webhook_list(action list_subscriptions)。收集订阅信息:主题、该主题下的字段、回调 URL(须为可公开访问且能通过 Meta 验证挑战的 HTTPS 端点)、验证令牌。订阅:调用 devtools_webhook_manage(action subscribe),传入 topic、fields、callback_url、verify_token。验证:调用 devtools_webhook_test(action test_send)对已订阅字段发送测试负载并确认投递结果。最后汇总主题、字段、回调 URL 与测试结果,并调用 devtools_skill_invocation(action end)结束跟踪。

适用场景:需要为 Meta 应用接入或调整 Webhook 订阅的开发者与运维人员。

限制与提示:回调 URL 必须同时处理 GET 验证挑战与 POST 事件负载;订阅失败常见原因为回调不可达、验证令牌不匹配或字段名无效;订阅成功不代表负载能正确投递,务必执行测试验证;修改已有订阅应使用 devtools_webhook_manage 的 update_fields,而非先退订再重订。