Broadcasts

List the broadcasts in this organization, newest first. MARKETING broadcasts are bulk sends to segments or all contacts; TRANSACTIONAL broadcasts are single-recipient sends fired by triggers or the API.

Read a single broadcast in full: status, schedule, audience (segments or all contacts), channel templates and delivery counters (sent, delivered, opened, failed).

Create a broadcast as a DRAFT: a bulk marketing campaign (e.g. a WhatsApp template blast) to segments or all contacts, or a transactional single-recipient send.

Update a broadcast name, schedule time or audience. Audience and schedule can only change while the broadcast is editable (marketing: DRAFT, CANCELLED or FAILED; transactional: DRAFT, ACTIVE or PAUSED).

Copy a broadcast including its segments and channel templates. The copy is created as a DRAFT and does not send anything.

Permanently delete a broadcast and its delivery history. Marketing broadcasts cannot be deleted while scheduled or sending; transactional ones must be paused first.

Queue a MARKETING broadcast for delivery to its full audience. Sends immediately when the broadcast has no scheduled time, otherwise waits for it. This is the real mass send: confirm with the user before calling it. Requires DRAFT, CANCELLED or FAILED status and at least one channel template.

Cancel a MARKETING broadcast in SCHEDULED or SENDING status. Recipients already sent stay sent; the rest are skipped.

Activate a TRANSACTIONAL broadcast so it accepts triggers and starts sending to individual recipients. Allowed from DRAFT or PAUSED; requires at least one channel template.

Pause an ACTIVE transactional broadcast. Triggers are rejected until it is activated again; configuration is preserved.

Send a test of a broadcast to a single email address or phone number so its content can be reviewed before the real send. Only works while the broadcast is testable (marketing: DRAFT, CANCELLED or FAILED; transactional: DRAFT, ACTIVE or PAUSED).

Aggregated delivery and engagement stats per broadcast: totals, delivery rate and open rate, optionally limited to a date range.

List individual broadcast deliveries with their status (sent, delivered, opened, failed, bounced). Answers "did we send X to this contact": filter by broadcast, by contact, or search by name, email or phone across all broadcasts.