---
title: "Broadcasts"
description: "Send one message to a whole segment, or to everyone."
url: "https://docs.goomzo.africa/docs/help/broadcasts"
docs_index: /llms.txt
lastUpdated: 2026-11-14
section: "Engagement"
related:
  - /docs/help/messages
  - /docs/help/templates
  - /docs/help/placeholders
  - /docs/help/sender-ids
  - /docs/help/sms-bundles
---

> For an index of all documentation, see [/llms.txt](https://docs.goomzo.africa/llms.txt). Any page is also available as Markdown by adding .md to its URL.

# Broadcasts

> Send one message to a whole segment, or to everyone.

A broadcast sends the same message to everyone in a [segment](https://docs.goomzo.africa/docs/help/segments?utm_source=llms&utm_medium=ai), or to all your customers, by SMS
or WhatsApp. Each customer gets their own copy. The organization's owner and admins can send broadcasts, and so can an
[API key](https://docs.goomzo.africa/docs/developers/authentication?utm_source=llms&utm_medium=ai) with `broadcasts.send`.

<Callout title="Before you start">
  A broadcast by SMS uses SMS for every customer it reaches. Check you have enough in
  **Engagement → Subscriptions**, or [buy an SMS bundle](https://docs.goomzo.africa/docs/help/sms-bundles?utm_source=llms&utm_medium=ai).
</Callout>

## Send a broadcast

1. In **Engagement → Broadcasts**, select **New broadcast**.
2. Give it a name you'll recognize, such as **December offer**.
3. Choose who it's **To**: any of your segments and numbers you paste, one per line, or **All customers**.
4. Choose the channel, who it's from, and write your message, as for a [message](https://docs.goomzo.africa/docs/help/messages?utm_source=llms&utm_medium=ai#send-a-message).
   A WhatsApp broadcast goes as an approved [template](https://docs.goomzo.africa/docs/help/messages?utm_source=llms&utm_medium=ai#whatsapp-templates), its blanks filled for
   each person. It reaches at most as many people as your number can write to in a day; Goomzo shows the limit.
5. Send it now, or schedule it for later.

## Write to each person

Put `{{name}}` in the message and each customer gets their own name in its place. `{{attributes.plan}}` works the
same way for any of their details. To say something when someone doesn't have it, add it after `|`:
`Hi {{name|there}}` reads "Hi there" for them. Each text is counted as it will be sent, so the estimate shows what
everyone's texts use together.

## Send to numbers and several segments

A broadcast can go to up to 20 segments and up to 10,000 phone numbers together, here or
through the [API](https://docs.goomzo.africa/docs/developers?utm_source=llms&utm_medium=ai#make-your-first-request). Each person gets it once, even when they're in two segments
or their number is pasted too. Numbers that belong to your customers show in their history; the others are sent
under the number itself, and no customers are added.

## Who receives it

Goomzo picks the customers when the broadcast starts sending, so customers added to the segment before then are
included. An [automatic segment](https://docs.goomzo.africa/docs/help/segments?utm_source=llms&utm_medium=ai#automatic-segments) reaches whoever matches its rules at that
moment. Only customers who can be reached on its channel get it: those with a phone number. A broadcast can reach up to 50,000 customers.

## See who opens your links

Turn on **Track link clicks** in **Engagement → Settings**. Every message with a link is then tracked: each
customer's activity shows **Link clicked** with the broadcast's name when they open one.

## Track a broadcast

The list shows how many customers each broadcast was sent to, how many received it, and its status: Scheduled,
Sending, Sent, Failed or Canceled. You can cancel a broadcast until it starts sending.

We let you know, in Goomzo and by email, when your broadcast has been sent, with how many were sent, or if it
was not sent, and why.

---

For an index of all available documentation, see [/llms.txt](https://docs.goomzo.africa/llms.txt)
