Skip to main content

Understanding Message Failures

Troubleshooting Delivery Issues

Written by Rudy Wetou

Visual Breakdown of Message Failures

The image above provides a visual representation of message delivery failures with the following components:

  • 1. Carrier Block: Displays the percentage of messages blocked by recipient carriers

  • 2. No Campaign Found: Shows instances where the message couldn't be associated with an active campaign

  • 3. Number Not in Service: Illustrates the proportion of messages sent to inactive phone numbers

  • 4. International Forbidden Number: Highlights attempts to send to international numbers when not permitted

  • 5. Invalid "From" Number: Indicates messages with incorrect sender information

  • 6. Pie Chart: A graphical representation showing the proportional distribution of different failure reasons

  • 7-11. Detailed Breakdown block: Each failure category with its corresponding percentage and exact count of occurrences

Understanding these metrics is crucial as they provide valuable insights into why messages aren't reaching recipients. By analyzing these failure patterns, you can identify specific issues—whether they're carrier-related, configuration problems, or data quality concerns—and implement targeted corrective actions to improve your overall delivery rates.


How to Access Undelivered Details

To analyze undelivered messages:

  1. Locate the filter above the grid chart

  2. Select "Undelivered Details"

  3. Review the presented chart

  4. Scroll down to see the detailed breakdown of reasons for undelivered SMS, including the pie chart visualization

This analysis tool helps you identify patterns in message failures, allowing you to make data-driven decisions to improve delivery rates. By understanding why messages fail to reach recipients, you can address specific issues with your contact lists, message configuration, or carrier relationships, ultimately optimizing your communication strategy.


Did this answer your question?