Messenger Platform

Webhook Debugger

The Instagram Messaging Webhook Debugger can be used to check if your app has the correct subscriptions and permissions for pages that your app is connected to as part of your IG Messaging API integrations. It can be accessed from Developer app dashboard → Messenger → Instagram Settings and is only available for users who have an Administrator role on your app.

Requirements

  • Tool is only accessible to users with Administrator role on your app.
  • Tool only works for pages/handle that are connected to your app.
  • Ensure that you have an instagram account and it is linked to your Facebook account (needed so that the debug webhook will be sent with your details rather than a random user)
  • Please do not use tool run random checks as it will add to your API call rates. Only use it to debug if you have an actual issue.

How to use the debugger

Step 1: Check subscriptions and setup

  1. Go to the Apps panel and select your app to load it into the App Dashboard.
  2. Navigate to App dashboard → Messenger → Instagram Settings and scroll to the botton to see the Webhook debugger section
  3. Enter Page Id of page(connected to the IG account) that you want to check subscriptions and setup for and click submit
  4. Details like webhook subscriptions, connected IG account, Messaging toggle status etc will be shown.
  5. If any of them is wrong or missing, it will be shown in red with detail links to fix those.

Step 2: Send Debug Webhook(only use if above step shows everything setup correctly and your app is still not receiving webhooks)

  1. Navigate to the Send Debug Webhook section and enter the Page Id(connected to the IG account) for which you are not receiving webhooks.
  2. Click Submit.
  3. If all setup is correct then a sample messages webhook will be sent to your app.
  4. A TraceID will also be shown like in the screenshot below
  5. If your app still does not receive the sample webhook, please share the TraceID in a ticket via our support platform, detailing the steps you followed and any additional context.