📢 Broadcasts

Send bulk messages to users, schedule broadcasts for later, and track how your messages are performing. You can also view detailed information for failed messages to quickly identify and resolve issues.

• Navigate to Broadcasts
• Click 'Create Broadcast'

✏️ Fields

• Broadcast Type
  Choose the type of broadcast:

  • Broadcast - Send a standard message to your audience
  • Engagement - This allows you to attach a bot flow that is triggered when users interact with the message

• Schedule Broadcast (Optional)
  Schedule your broadcast to send at a specific date and time.
  👉 Learn more

• Broadcast Name
  Give your broadcast a clear and recognizable name for easy identification.

• Select Channel
  Choose the phone number (channel) you want to send the broadcast from.

• Select Template
  Select the message template that will be sent with this broadcast.

  • what are templates?

• Upload File
  Upload your audience file (CSV or Excel).
  👉 Learn more

• 🚀 Send Broadcast
  Click 'Send Broadcast'

⬆️ Upload File

• Make sure the first row contains column headers (e.g. external_id, media_url).
  • external_id should start with country code eg 27XXXXXXXXX
• You can edit your file using Excel or Google Sheets. CSV and Excel files are both supported.
• In the media_url column, only use supported file types:
  • Images: .jpeg, .png
  • Videos: .mp4
  • Documents: .pdf
• 👥 You can send up to 100k users per broadcast.

Optional Variables

If your template includes variables, you can add them to your CSV file.

• Variables must follow the naming convention: var1, var2, var3, etc.
• Max of 3 variabels can be added
• They should be added as additional columns in your CSV.
• Only include variables that are defined in your template.

Example

external_id	media_url	var1
27234567891	https://example.com/image.jpeg	John Doe
27346789111	https://example.com/image.jpeg	Jane Doe

• 👉 Download example CSV file

Test Your Broadcast

Before sending your broadcast, create a test to make sure everything works as expected.

• Check that your file follows the correct format
• Remove any unusual or unexpected characters
• Use test data from your team or internal users

⚠️ Media Limitations

Since broadcasts are sent via WhatsApp, the following limitations apply:

• Images: Up to 5 MB
• Videos: Up to 16 MB
• Documents: Up to 100 MB
• The media_url must be publicly accessible via URL
• Unsupported formats or oversized files may fail to send
• For full details, see the official Meta documentation:
  👉 https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media

🗓️ Schedule Broadcasts

Set your broadcasts ahead of time and let them send automatically at the perfect moment.

• Check 'schedule this broadcast?'
• Input your date and time

📊 Gather Insights

Insights give you a clear overview of how your broadcast messages are performing. It helps you track delivery status, identify issues, and export reports for further analysis.

Each broadcast includes detailed delivery metrics so you can quickly understand its effectiveness:

• ✅ Read – Messages that have been opened by recipients
• 📤 Sent – Messages sent but not delivered
• 📬 Delivered – Messages successfully delivered to users
• ❌ Failed – Messages that could not be delivered

Actions

Click the dropdown to access the following options:

• 👀 Preview Broadcast - View message details and see why some messages failed. Filter by Failed to quickly find issues.
  • Failed messages are usually linked to error codes provided by Meta. You can refer to their documentation to learn more about each error and how to resolve it.
    • 👉 learn more
• 📥 Download Data - Download a full report of your broadcast anytime for further analysis.