Overview

WhatsApp Failure Analytics helps you understand why your WhatsApp campaign messages don't reach your audience. When a campaign shows a Not Sent or Undelivered count, you can now click that number to open a breakdown drawer. The drawer groups every failure by reason, shows the exact error code, and links you to Meta's official documentation for more context.

This feature removes the guesswork from campaign troubleshooting. You no longer need to raise a support ticket to find out why messages failed. You see the reason, the count, and the fix, all in one place.

Step-by-step guide

Follow the steps given below to view WhatsApp Failure Analytics.

1. Navigate to Engage > Campaigns and open the listing table for any WhatsApp campaign.
2. Locate the Not Sent or Undelivered column for that campaign.

   📘

   Note

   • A count in blue, underlined text is clickable. It opens the failure breakdown drawer.

   • A count of 0, null, or NA appears in plain black text. It's not clickable because there's nothing to break down.

3. Click the count if the link is clickable.
4. The breakdown drawer opens on the right side of the screen.
5. The drawer header shows the WhatsApp channel icon and the campaign's status (Running, Paused, or Sent).
6. Review the overview card. It shows the total count and labels it as either "Not Sent Count" or "Undelivered Count", depending on which column you clicked.
7. Scroll through the accordion list. Each row represents a failure reason group, such as Recipient Issues or Delivery Policy.
8. Click a reason group to expand it. Each expanded row shows the error code, the reason text, and how many messages hit that reason.
9. Hover over the tooltip icon next to a row, if present, to read more detail about that specific reason.
10. Close the drawer when you're done. You can close it safely at any point, even while data is still loading.

Each expanded row includes:

• Error code: the numeric code Meta returns for that failure.
• Reason: a plain-language explanation of the failure.
• Count: how many messages in this campaign failed for this exact reason.

Some rows show a tooltip icon. Hover over it to see extra context that doesn't fit in the row.

There are two types of error categories:

1. Undelivered
2. Not Sent

Undelivered

Meta WhatsApp error code reference

Meta groups every WhatsApp Cloud API error into categories. Use this table as a quick reference. For the full, always-current list, always check Meta's documentation directly, since Meta updates codes and details over time.

Full reference: developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes

WhatsApp Error Codes Reference

Category 1: Recipient Issues

Category 2: Delivery Policy

Category 3: Media Errors

Category 4: Server / System Errors

Category 5: Template Errors

Category 6: Invalid Parameters

Category 7: Account / Auth Issues

Category 8: Registration Errors

Category 9: Flow Errors

Category 10: Miscellaneous

This category includes all failed-related errors that are not part of the mapped categories above.

Miscellaneous includes:

• Unmapped Meta errors.
• Remaining Meta “Other errors” received from provider/API responses.
• Netcore-generated/internal validation, processing, or campaign execution errors.

Every code above links back to the same source. When you're not sure which category a code you see in the drawer falls under, use the Learn more link inside the drawer, or go directly to Meta's error code reference.

Not Sent

Messages in this category failed to deliver due to one of two reasons:

1. Frequency Capping: The message was suppressed because the recipient reached their maximum communication limit.
2. Invalid Number: The phone number is incorrect, inactive, or formatted poorly.