Messaging Health Monitoring provides greater visibility into the health of your messages and service using the following metrics: Total Unregistered Traffic, Total Carrier Rejections, and Total Bandwidth Rejections. These three major metrics show how much of your traffic is unregistered or being blocked due to spam, along with how these percentages relate to your overall traffic health. This data is updated every hour.

Note: If you don’t have access to the Messaging tab, please contact your Account Admin to enable the Messaging Insights role associated with your user on your account,

All three metrics are shown at the top of the page. You can easily identify the health of each metric and drill in where needed. To display a chart with a more detailed breakdown, select View Breakdown to see a more detailed chart.

By default, each chart displays the last 30 days of data and the volume of traffic overlaid with a line graph showing the health percentage’s rolling 30-day average and daily average. Threshold lines are also available to help you visualize the trend of those averages over time.

You can use the Date Range drop-down menu to filter the graph by date ranging from the last 7 days and up to 6 months, or click and drag across the graph to zoom in. To download the graph, click the menu to the right of the graph and your preferred file format (PNG, JPEG, CSV, XLS).

We strongly encourage you to follow the carrier requirements for handling 10DLC traffic. This means all 10DLC numbers that you plan to use to send messages should be registered within The Campaign Registry (TCR). For this reason, the percentage of outbound 10DLC messages sent with numbers not assigned to a campaign is an important metric that helps assess the health of the messaging traffic.

The donut chart at the top of the page displays your current health for unregistered traffic. This metric has the following thresholds:

*Although the perfect percentage is zero, we understand the complexity of the industry at this time. These thresholds provide the leeway needed to work with your customers to register campaigns and brands.

Message Logs is a helpful tool to explore which messages and corresponding numbers are not registered to a campaign. Once you’ve identified the numbers and confirmed they’re not registered in an existing campaign, you can download the messages and numbers to help you register them. There are a couple of options available for you to do this:

For more information about 10DLC or Local A2P traffic, check out our 10DLC FAQ or learn more about registering campaigns and brands.

Carriers can reject messages that are non-compliant or violate best practices. Bandwidth calculates the percentage of traffic rejected by carriers for spam or opt-out violations over the last 30 days to assess the health of messaging traffic related to compliance. This metric has the following thresholds:

Messages associated with the error code (4)770 have been rejected by carriers because they were identified as spam. Spam blocks can occur due to content, SHAFT violations (including specific keywords), or because the originating address has been flagged for repeated spam content. Messages that violate carrier codes of conduct, and/or CTIA guidelines will be rejected.

Please review the content and consent practices of the rejected messages to ensure they are compliant. To ensure the best delivery, all messages must align with messaging content policies, carrier codes of conduct, and/or CTIA guidelines.

Messages rejected with the error of (4)775 are opt-out errors. The carrier has rejected these messages because the end user has opted out and these messages don’t align with best practices for collecting and managing consent. You’ll need to remove these numbers from your sender lists and send a confirmation message to the end user that they’ve been opted out.

The link in the graph description takes you to the Message Logs and pre-filters the page to see specific messages rejected for (4)770 or (4)775. The link to the Delivery page allows you to view the top numbers associated with carrier rejections, along with the volume of messages rejected over time for each error. The additional filters on this page can help you investigate the messages and the corresponding numbers needed to address the carrier blocks and improve your messaging health.

Bandwidth will continue to add specific errors to the Carrier Rejection metrics as additional error codes related to compliance violations are identified.

The last metric on the Health page shows the percentage of traffic that has been filtered and blocked by Bandwidth for spam. Spam refers to unwanted or unsolicited text messages received by a consumer. Bandwidth leverages industry-sanctioned and industry-sourced spam filtering technologies to stop all forms of spam from reaching the text messaging ecosystem. Messages can be blocked for a variety of reasons, including but not limited to volumetric filtering, content blocking, and SHAFT violations. This metric has the following thresholds:

Messages associated with the error code (4)470 have been rejected by Bandwidth for spam. This error code encompasses several potential rejection reasons, most commonly, prohibited content or campaign type, snowshoeing, and/or improper use of URLs of natural language. For more information about improving rejections, messaging health, and delivery, visit our Messaging deliverability FAQ.

The best way to prevent your messages from being filtered is to avoid sending spam or fraudulent traffic and ensure that you're following the guidelines provided in the following resources:

Questions? Please open a ticket with your Bandwidth Support Team or call us at (855) 864-7776!