Debug Webhooks

Diagnose and fix webhook delivery issues for a Meta app.

Workflow

1. Get context. Ask the user for:

   • The app name or ID — if they give a name (or aren't sure of the ID), resolve it to an app_id via devtools_app_list (action list); if several apps match or it's ambiguous, show the candidates (name, ID, viewer role) and ask the user to pick
   • What's going wrong (not receiving events? wrong data? specific topic?)

2. Inspect current state. Run in parallel:

   • devtools_webhook_list with action list_subscriptions — all active subscriptions
   • devtools_webhook_list with action list_topics — all available topics (for comparison)

3. Diagnose. Check for common issues:

   No subscriptions found

   • The topic the user expects events from has no active subscription
   • Suggest using /webhook-setup to create one