---
description: Learn about the reasons broadcasts may fail to be sent and how to resend broadcasts to Contacts who did not receive them.
title: How to Troubleshoot a Failed Broadcast
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Broadcasts Use Cases >](/help/broadcasts)
3. How to Troubleshoot a Failed Broadcast

# How to Troubleshoot a Failed Broadcast

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg)

Joshua Lim

· 21 Jul 2025

4 min read

> In this article, you'll learn how to effectively identify and troubleshoot the causes of broadcast failures.

## Identify the Cause of Broadcast Failure

If you suspect that a broadcast has failed, here are a few ways to investigate and identify it.

* Check the Failed Message Log in Reports module
* View error message in Failed Status
* Check the number of Completed Recipients

### Check the Failed Message Log in Reports module

Sometimes, broadcasts are completed, but some Contacts fail to receive the messages. This could happen because the broadcast exceeded or violated the Channel limitations.

To view messages that failed to be delivered for a specific broadcast:

**Step 1:** Go to _Reports_ module > _Messages_ \> _Failed Message Log_.

**Step 2:** You can filter the messages:

* by _Broadcast Name_: Select the broadcast(s) to view only messages for the selected broadcast(s).
* by _Date_: Select the date the broadcast was sent.
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/501KCbUXw9EoFKy1fi2Bew/115017d3f138874be69375455c1cff8b/troubleshooting-a-failed-broadcast-check-the-failed.png?fm=jpg&q=80&w=640) 

**View the errors** by scrolling all the way to the right in the Failed Message Log report. In this example, the majority of errors were caused by Contacts blocking the business on the Channel.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3fVzhXPRiixVYiYsGpsEWq/053cbad2ecec6892015f89a97afee66a/failed-broadcasts-4.png?fm=jpg&q=80&w=640) 

> If you find errors in the Failed Message Log, check the limitations of the channel the broadcast was sent on.

### View error message in Failed Status

In the _Broadcast_ module, select _Failed_ status > choose your broadcast. The error message will appear in the Broadcast Details Drawer.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/0sEOrYg8TxvW41Cx5O5uZ/fc00f08df862ac4d09eac5faa886ac4d/screenshot-2023-03-17-at-2-02-21-pm.png?fm=jpg&q=80&w=418) 

Here is a list of reasons for failed broadcasts:

| Error Message                                                                                                     | Failed Reason                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Contact Segment not found                                                                                         | The Contact Segment could not be found.                                                                                                    |
| Limit Reached: The maximum number of Segments in a Workspace is 500\. Delete a Segment before creating a new one. | You have reached the maximum number of Segments allowed in the Workspace. You will need to delete a Segment before creating a new one.     |
| Contact Segment name must be unique.                                                                              | The Segment name is duplicated. You need to create a unique name for each Segment.                                                         |
| Broadcast Failed: Broadcast messages allowed in plan exceeded.                                                    | The Broadcast failed because the limit in the current plan has been exceeded. The broadcast message limits can be found here.              |
| Broadcast Failed: No Contacts in the Target Segment                                                               | The Broadcast failed because there are no recipients in the Target Segment selected. Ensure that there are Contacts in the Target Segment. |
| Broadcast Failed: Target Segment not found.                                                                       | The Broadcast failed because the Target Segment was not found.                                                                             |

### Check the number of Completed Recipients

If you find that your Completed Recipient number is different from your [Targeted Recipient](https://respond.io/help/broadcasts/sending-a-simple-broadcast#check%5Ftarget%5Faudience%5Ffor%5Fa%5Fbroadcast) number, it could be due to several reasons.

#### The behavior of dynamic Segments

Segments are updated whenever [a Contact enters or exits the Segment](https://respond.io/help/contacts/segments#how%5Fdoes%5Fa%5Fcontact%5Fautomatically%5Fenter%5For%5Fexit%5Fa%5Fsegment). There may be cases where Contacts enter or exit the Segment during the duration between scheduling and sending of a broadcast message. This is an expected behavior due to the dynamic nature of Segments.

**Example:** Suppose a broadcast is scheduled to send in 2 days to 100 Contacts in a Segment. During the 2-day period, 5 new Contacts that fit that criterion are automatically added to the Segment. When the broadcast is sent out, it will be delivered to 105 Contacts. The targeted recipient number is 100, while the completed recipient number is 105.

#### The Segment includes duplicated Contacts

A broadcast is sent to one Contact, while any duplicate Contacts are excluded from the number of recipients, which will reduce the original Targeted recipient number. The platform will not attempt to send the broadcast message to duplicate Contacts.

To avoid having duplicate Contacts, we recommend the following best practices:

* [Merging Contacts](https://respond.io/help/contacts/merge-suggestions) in the Dashboard.
* Selecting _Add & Update Contact_ option when [importing Contacts](https://respond.io/help/workspace-settings/data-import).

In some cases, a Broadcast may fail if a Segment contains Contacts with no assigned Channel (often caused by improper imports). To resolve this:

1. **Identify and remove Contacts without a Channel:**  
   1. Go to the affected Segment.  
   2. Apply the filter: Channel > does not exist.  
   3. Save the filter  
   4. Select all Contacts > Delete
2. **Reimport the List:**  
   1. Use the original list of Contacts for the segment.  
   2. Set the phone number as the identifier.  
   3. Import using the **Add + Update Contacts** method.  
   4. Assign a new Tag to distinguish this updated segment.

#### The format of the identifier is incorrect

If a Channel using a phone number as an identifier (e.g. WhatsApp, SMS) has an invalid format, it will be excluded from the recipient count and the platform will not attempt to send the broadcast message to those Contacts. Here’s a [guide for the recommended formats](https://respond.io/help/contacts/contact-import).

## Channel Limitations for Broadcasts

> The following channels do NOT support broadcasts: Instagram, Website Chat, WeChat, Gmail or other email.

To avoid broadcast failure, take note of the limitations of each channel. See the following for specific channel limitations and policies on broadcasts:

* [WhatsApp](https://respond.io/help/whatsapp/whatsapp-overview#broadcast%5Fcapabilities)
* [Viber](https://respond.io/help/viber/viber-overview#broadcasts)
* [Facebook Messenger](https://respond.io/help/facebook-messenger/facebook-messenger-overview#broadcasts)
* [Telegram](https://respond.io/help/telegram/telegram-overview#broadcasts)
* [LINE](https://respond.io/help/line/line-overview#broadcasts)
* [SMS Twilio, Vonage and MessageBird](https://respond.io/help/sms/sms-overview#broadcasts)
* [Custom Channel](https://respond.io/help/custom-channel/custom-channel-overview#broadcasts)

> If the Send Rate limit is higher than the Channel-allowed rate limit, there will be an error displayed by the Channel and it will be counted towards the Broadcast Messages quota usage.

## Resending Failed Broadcast Messages

When broadcasts cannot be fully sent due to Channel limitations, they are delivered partially.

**Example:** A business that belongs to WhatsApp's standard tier can only send out 1,000 messages in a 24-hour period. If the business sends out a broadcast with 1,500 messages, only 1,000 messages will be delivered and the other 500 will fail.

In such cases, you might want to identify the recipients who have not received the message and resend it to them.

**There are two methods to resend failed broadcast messages:**

* Download Failed Messages using Data Export, reimport to add tags in bulk, create a Segment, and resend (recommended).
* View the Failed Message Log from the Reports Module, manually add tags, create a Segment, and resend.

### Download Failed Messages using Data Export, reimport to add tags in bulk and resend

> **Tip:** Learn more about [Data Export here](https://respond.io/help/workspace-settings/data-export).

> We recommend using this method because it provides you with the Contact ID, which makes resending messages in bulk easier.

**Step 1:** Go to _Settings_ \> _Data Export_ \> Select _Failed Messages_ from the dropdown > Set the date range for the date when the broadcast was sent > Click _Export Data_ and download the CSV.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4PckwfcUaDE9Q0uohTP9Wl/011e3d09d4a1ee98ca7735b2e43ea2a0/failed-broadcasts-5.png?fm=jpg&q=80&w=640) 

The CSV provides the following information: Date & Time, Sender ID, Sender Type, Contact ID, Message ID, Content Type, Content, Channel ID, Type, Sub-type and Error.

Filter the CSV by Channel ID to show only the failed messages from the Channel the broadcast was sent on.

#### How to find your Channel ID

To find your Channel ID number, go to Settings > Channels. The Channel ID is under the Channel name in the list.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1JVIL5yy76xNlBxAL8LaY7/aadf75b32fad8d97b30a42c208003c29/failed-broadcasts-6.png?fm=jpg&q=80&w=640) 

**Step 2:** Go to _Import Contacts_ \> add the CSV file > select _Update existing contacts only_ \> select _Contact ID_ for the identifier.

> **Tip:** Learn more about [Contact Import here](https://respond.io/help/contacts/contact-import).

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1EmURl7vQ7iaFOFMewmt28/bfc11e6527c4dcb9eb3d18b74ae7d3eb/failed-broadcasts-7.png?fm=jpg&q=80&w=640) 

Add a tag, e.g., _failed broadcast 110122_ to identify these as the Contacts that did not receive the broadcast and import.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/26djnJYJYWvT1ac9XSd7DB/70d2c01a2b5538afcd25c61cd8bdee08/failed-broadcasts-8.png?fm=jpg&q=80&w=640) 

**Step 3:** Create a Segment that contains the failed messages by filtering with the following criteria: _Contact Tag_ \> _has any of_ \> _Tag_.

**Step 4:** Resend the broadcast to these Contacts using the Segment.

### View the Failed Message Log from the Reports module, manually add tags and resend

> **Tip:** Learn more about the [Failed Message Log here](https://respond.io/help/dashboard-reporting/reports-messages#failed%5Fmessage%5Flog).

**Step 1:** Follow the steps to [check the Failed Message Log](https://respond.io/help/broadcasts/dealing-with-failed-broadcasts#check%5Fthe%5Ffailed%5Fmessage%5Flog%5Fin%5Freports%5Fmodule) and identify the Contacts who did not receive the broadcast.

**Step 2:** Go to each contact’s profile on the list who did not receive the broadcast and add a tag, e.g., _failed broadcast 110122_.

> **Tip:** Learn more about [Contact Tags here](https://respond.io/help/contacts/contact-details#tags).

**Step 3:** Create a Segment that contains the failed messages by filtering with the following criteria: _Contact Tag_ \> _has any of_ \> _Tag_.

**Step 4:** Resend the broadcast to Contacts with the new Segment.

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/broadcasts/dealing-with-failed-broadcasts)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/broadcasts/dealing-with-failed-broadcasts)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/broadcasts/dealing-with-failed-broadcasts)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/broadcasts/dealing-with-failed-broadcasts)

## 

Related articles 👩‍💻

* [How to Import to Broadcast via WhatsAppLearn how to send a broadcast message to a large number of Contacts with whom you have never started a conversation. ](/help/broadcasts/import-to-broadcast)
* [How to Start a Workflow Based on Broadcast ResponseSend a broadcast with multiple choice questions and automatically handle Contacts’ responses. ](/help/broadcasts/workflow-based-on-broadcast-response)
* [How to Send a Simple BroadcastLearn how to send a simple broadcast to a group of Contacts on supported Channels. ](/help/broadcasts/sending-a-simple-broadcast)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:12.736Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Learn about the reasons broadcasts may fail to be sent and how to resend broadcasts to Contacts who did not receive them.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/author"},"dateCreated":"2024-12-23T08:09:18.000Z","dateModified":"2025-07-21T02:27:14.196Z","datePublished":"2024-12-23T08:09:18.000Z","headline":"How to Troubleshoot a Failed Broadcast","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/501KCbUXw9EoFKy1fi2Bew/115017d3f138874be69375455c1cff8b/troubleshooting-a-failed-broadcast-check-the-failed.png","mainEntityOfPage":"https://respond.io/help/broadcasts","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/501KCbUXw9EoFKy1fi2Bew/115017d3f138874be69375455c1cff8b/troubleshooting-a-failed-broadcast-check-the-failed.png","url":"https://respond.io/help/broadcasts/dealing-with-failed-broadcasts"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Broadcasts Use Cases","item":"https://respond.io/help/broadcasts","position":2},{"@type":"ListItem","name":"How to Troubleshoot a Failed Broadcast","item":"https://respond.io/help/broadcasts/dealing-with-failed-broadcasts","position":3}]}]
```
