Broadcast

Broadcast lets you send an approved WhatsApp template to many contacts in one action. Open the Broadcast page from the sidebar. There are two ways to work: save reusable groups, or compose a one-off broadcast and target an audience on the fly.

​

Contact groups

A contact group is a named, reusable audience. Choose New group, name it, and pick contacts (search by name, email, or phone). Each group card shows its size and how many members are reachable on WhatsApp, with a quick Send template action.

​

New broadcast

Choose New broadcast to compose a send in three steps:

1. Template — pick an approved WhatsApp template.
2. Audience — choose how to target contacts:
   • Group — one of your saved groups.
   • Contacts — hand-pick contacts.
   • Filters — target by attributes (see below).
   • Import — upload a spreadsheet of recipients.
3. Variables — fill the template’s {{1}}, {{2}} values (the same for everyone, unless you import a personalized sheet).

The composer shows the live reach — how many contacts the audience hits on WhatsApp — before you send.

​

Filters

Build an audience from contact and conversation attributes. Filters combine together (AND):

• Tags — labels you apply to contacts (see Tags)
• Country — derived from the contact’s phone number
• Last agent assignee — the agent last assigned to the contact’s chat
• Last team assignee — any agent on the chosen team(s)
• Status — open and/or closed chats
• Unread — contacts with unread incoming messages
• Language — the contact’s language
• Last activity — a date range of last conversation activity

​

Import a list (Excel)

To send to a list with per-recipient values, use the Import tab:

1. Pick your template first, then choose Download sheet. You’ll get an .xlsx with a phone column plus one column per template variable.
2. Fill one row per recipient and save.
3. Choose Upload filled sheet. Phones are matched to existing WhatsApp contacts; each recipient receives the template with their own variable values. Numbers with no WhatsApp conversation are reported as unreachable.

CSV files work too.

​

Tags

Tags are labels you apply to contacts to build audiences. On the Contacts page, use the tag control on any row to apply existing tags or create a new one on the fly. Then target a tag from the broadcast Filters.

​

Language

Set a contact’s language on the Contacts page. Use it to broadcast in the right language — for example, send the Arabic version of a template only to Arabic-speaking contacts.

​

History

Each send is recorded under Recent broadcasts with its audience, template, and result: completed (all delivered), partial (some failed), or failed (none delivered).

​

API

Manage groups and send broadcasts from your own systems:

• GET /api/v1/contact-groups — list groups and their members
• POST /api/v1/contact-groups — create a group from contact IDs
• POST /api/v1/contact-groups/{groupId}/broadcasts — send a template to a group
• POST /api/v1/broadcasts — send a template to an audience (group, contacts, filter, or imported recipients)

See the API reference for details.