UCal
  • Welcome
  • 🚀Getting Started
    • Quick Start
      • What is IS-Messenger?
      • Setting Up an Account
      • Connecting Channels
      • Inviting Your Teammates
      • Getting Contacts to Message You
      • Automated Welcome and Away Messages
      • Responding to Messages
      • Glossary of Terms
    • Connecting a Channel
    • Invite your teammates
    • Getting Contacts to Message You
    • Automated Welcome and Away Messages
    • Responding to messages
    • Glossary of Terms
    • Creating a Chatbot
  • ⚙️Workspace Modules
    • Dashboard
    • Inbox
      • Inbox Overview
      • Assignment and closing a conversations
      • Custom Inboxes
      • Interacting with Respond AI Prompts
      • Using AI Assist
    • Contacts
      • Contact Details
      • Contacts Overview
      • Merge Suggestions
      • Contact Activity
      • Contact Channels
      • Contact Import
      • Segments
    • Broadcast
      • Broadcast Overview
      • Managing Broadcasts
    • Workflow
      • Triggers
      • Workflow Step
        • Step: Send a Message
        • Step: Ask a Question
        • Step: Assign To
        • Step: Branch
        • Step: Update Contact Tag
        • Step: Update Contact Field
        • Step: Open Conversation
        • Step: Close Conversation
        • Step: Add Comment
        • Step: Jump To
        • Step: Wait
        • Step: Date & Time
        • Step: HTTP Request
        • Step: Trigger Another Workflow
        • Step: Add Google Sheets Row
        • Step: AI Agent
      • Workflow Templates
    • Reports
      • Reports: Conversations
      • Reports: Responses
      • Reports: Resolutions
      • Reports: Messages
      • Reports: Contacts
      • Reports: Assignments
      • Reports: Leaderboard
      • Reports: Users
      • Reports: Broadcasts
  • ⚙️Workspace Setting
    • Managing a Workspace
    • General
    • Users
      • Access Levels
    • Teams
    • Channels
      • Chat Menus
    • Contact Fields
    • Growth Widgets
      • Website Chat Widget Quick Start
      • Website Chat Widget Overview
      • Workspace Settings: Growth Widgets
      • Install Website Chat Widget on Squarespace
      • Install Website Chat Widget on Joomla
      • Install Website Chat Widget on Wix
      • Install Website Chat Widget on Shopify
      • Install Website Chat Widget on WordPress
      • How to Track Conversation Source from Multiple Websites
    • Respond AI
    • Integrations
      • Dialogflow
        • Dialogflow: Connecting to Dialogflow
        • Dialogflow: Creating a Chatbot
        • Dialogflow : Managing Intents
        • Dialogflow: Parameters
        • Dialogflow: Events
        • Dialogflow: Response Templates
        • Dialogflow: Custom Payloads
        • Dialogflow: Fulfillment Webhook Request
      • E-Commerce & CRM Integrations
        • E-Commerce Integration: Shopify
        • E-Commerce Integration: BigCommerce
        • E-Commerce Integration: WooCommerce
        • E-Commerce Integration: Magento
        • CRM Integration: HubSpot
        • CRM Integration: Salesforce
        • CRM Integration: Pipedrive
        • CRM Integration: ActiveCampaign
      • Zapier
      • Developer API
      • Webhooks
      • Make (formerly Integromat)
    • Closing Notes
    • Snippets
    • Files
    • Data Export
    • Data Import
  • ⚙️User Account
  • Profile
  • User Activity Status
  • Notifications
  • Resetting your Passwords
  • 👨‍👧‍👦CONTACT AND MESSAGES
    • Dynamic Variables
      • Dynamic Variables Overview
      • How to Use Dynamic Variables
    • Contact Search and Custom Inbox
    • Conversations
  • ⚙️MESSAGING CHANNELS
    • Channel Overview
    • Facebook Messenger
      • Facebook Messenger Quick Start
      • Facebook Chat Plugin
      • Private Replies
      • Message Tag
    • Instagram
      • Instagram Overview
      • Instagram Quick Start
    • WhatsApp
      • WhatsApp Business API Quick Start
      • Getting Ready for Inbound Conversations
      • Getting Ready for Promotional Messaging
      • WhatsApp Official Business Account (Green Tick)
      • Grow your WhatsApp Audience by Maximizing Entry Points
      • Get WhatsApp API Account for Government Agencies
      • Meta Business Verification
      • WhatsApp Message Templates
      • WhatsApp Pricing
      • WhatsApp Business Platform (API) Channel Configuration
      • WhatsApp Messaging Limits
      • Meta Product Catalog
      • Change Your WhatsApp Business Display Name
      • Phone Number Migration to IS-Messenger WhatsApp Business API
      • Turn-off WhatsApp Number Two-Step Verification
      • WhatsApp Cloud API
        • Migrating from On-Premises API to Cloud API
        • Migrating from Cloud API to On-Premises API
        • Set up the WhatsApp Echo Bot
        • Load Testing on Cloud API
        • Experiments
        • Webhooks Setup
      • 360Dialog WhatsApp
      • Twillio WhatsApp
      • MessageBird WhatsApp
      • Vonage WhatsApp
      • Phone Number Migration to WhatsApp Cloud API
    • Website Chat Widget
      • Install on WordPress
      • Install on Shopify
      • Install on Wix
      • Install on Squarespace
      • Install Website Chat Widget on Joomla
    • LINE
      • LINE Overview
      • LINE Quick Start
    • Telegram
      • Telegram Overview
      • Telegram Quick Start
    • Viber
      • Viber Overview
      • Viber Quick Start
    • SMS Overview
      • Twilio SMS Quick Start
        • Importing Contacts to Twilio SMS
      • MessageBird SMS Quick Start
      • Vonage SMS Quick Start
    • Twitter Overview
      • Twitter Quick Start
    • WeChat
      • WeChat Overview
      • WeChat Quick Start
    • Google Business Message
    • Email
      • Google Workspace Quick Start
      • Other Email
    • Custom Channel
      • Custom Channel Overview
      • Custom Channel Quick Start
  • New Release Update
  • Support Use Cases
    • How to Identify Contacts by Email and Phone NumberI
    • How to Enrich Customer Data from a CRM or other Business Software
    • How to Route Customers to the Right Team Automatically
    • How to Auto-Assign Customers to a Team or Dedicated Agent
    • How to Send Outbound Support Messages
    • Support: Closing Conversations
    • How to Supervise Your Support Agents
    • How to Analyze Reports for Support
    • How to Send CSAT to Customer and Save Data in Google Sheets or CRMs
  • Handling Inbound Conversations
    • Managing Spam
    • Create Automated Welcome and Away Messages
    • Get Contacts’ Consent for Personal Data Collection
    • Create Automated Chat Menus
    • Collect Contacts’ Emails and Phone Numbers
    • Route Contacts by Shifts
    • Route Contacts by Team Functions
    • Route New & Returning Contacts
    • Route VIP Contacts
    • Assignment Strategy: Automatic Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
  • Capture Conversations
    • How to Streamline Meeting Scheduling via CTC Ads
    • How to Automate Product Info Sharing in Conversations Initiated via CTC Ads
    • How to Track Conversation Source from Multiple Websites
    • How to Route Contacts from CTC Ads to Agents
  • Automate Conversations
    • How to Maximize Customer Service Potential with AI Agent
    • How to Automate Contact Information Collection with AI
    • How to Route Contacts to Preferred AI Agent
    • How to Automatically Qualify Contacts Based on Budget Using AI Agent
    • How to Route Contacts by their Preferred Language
    • How to Create Automated Chat Menus
    • Assignment Strategy: How to Automate Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
    • How to Create Automated Welcome and Away Messages
    • How to Block Contacts and Manage Spam
    • How to Route New and Returning Contacts
    • How to Collect Contacts’ Emails and Phone Numbers
    • How to Route New and Returning Contacts
    • How to Route Contacts by Team Functions
    • How to Route Contacts by Shifts
    • How to Get Contacts’ Consent for Personal Data Collection
    • How to Route VIP Contacts
  • How to Promptly Transfer Conversation Between Agents
  • How to Guide Customers from Exploration to Purchase with Engaging Menus
  • How to Optimize Customer Onboarding with Automated & Customized Welcome Messages
  • Converse with Customers
    • How to Get a Complete View of the Customers
    • How to Simplify Customer Escalation with Automation
    • How to Transfer Contacts to the Next Shift Automatically
    • How to Optimize Agents’ Productivity in the Messages Module
    • How to Align AI Conversations with Your Brand Voice
    • How to Draft Customer Replies with AI
    • How to Convert Image to Text Using AI
    • How Automate Calculations Using AI
  • Broadcasts Use Cases
    • How to Sending a Simple Broadcast
    • How to Start a Workflow Based on Broadcast Response
    • How to Import to Broadcast via WhatsApp
    • How to Troubleshoot a Failed Broadcast
  • Sales Use Cases
    • How to Collect Leads' Email and Phone Number
    • How to Enrich Contact Data and Qualify Leads
    • How to Route Leads
    • How to Auto-Assign Leads to Sales Agents
    • How to Send Outbound Sales Messages
    • How to Track Productivity by Closing Conversations
    • How to Supervise Sales Agents
    • How to Analyze Reports for Sales
  • Accessing Help Menu
Powered by GitBook
On this page
  • Identify the Cause of Broadcast Failure
  • Check the Failed Message Log in Reports module
  • Check the number of Completed Recipients
  • Resending Failed Broadcast Messages
  • View the Failed Message Log from the Reports module, manually add tags and resend
  1. Broadcasts Use Cases

How to Troubleshoot a Failed Broadcast

PreviousHow to Import to Broadcast via WhatsAppNextSales Use Cases

Last updated 1 year ago

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.

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.

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.

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.

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

The behavior of dynamic Segments

Segments are updated whenever a Contact enters or exits the Segment. 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 in the Dashboard.

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.

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:

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

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.

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

Step 2: Go to Import Contacts > add the CSV file > select Update existing contacts only > select Contact ID for the identifier.To find your Channel ID number, go to Settings > Channels. The Channel ID is under the Channel name in the list.

Tip: Learn more about Contact Import here.

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

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

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.

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.

The Broadcast failed because the limit in the current plan has been exceeded. The broadcast message limits can be found .

If you find that your Completed Recipient number is different from your number, it could be due to several reasons.

Selecting Add & Update Contact option when .

Tip: Learn more about .

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

Tip: Learn more about the .

Step 1: Follow the steps to and identify the Contacts who did not receive the broadcast.

Targeted Recipient
importing Contacts
WhatsApp
Viber
Facebook Messenger
Telegram
LINE
Twitter
SMS Twilio
SMS Vonage
SMS MessageBird
Custom Channel
Data Export here
Failed Message Log here
check the Failed Message Log
here
screenshot of importing contacts by Contact ID
screenshot of errors in the failed messages log
screenshot of how to export failed messages data
screenshot of adding a tag to a contact import
Failed message log