Skip to content

Broadcasts

The dashboard supports manual, one-time scheduled, daily, and weekly announcements over the existing WAHA connection. Broadcasts are limited to individual members with recorded consent. WAHA is unofficial and these controls do not guarantee protection against account restrictions.

An incoming private message containing DAFTAR PENGUMUMAN or /SUBSCRIBE records consent for the sender’s current phone number. STOP, STOP PENGUMUMAN, BERHENTI PENGUMUMAN, and /STOP withdraw consent. The preference is committed before queueing its helpdesk acknowledgement, so a full queue does not undo an unsubscribe. A replayed webhook cannot reverse a later consent event.

Administrators can record consent or withdrawal under Broadcasts, Persetujuan penerima, with the source and time in the evidence note. A first helpdesk contact does not automatically enrol anyone. A phone change makes the previous phone’s consent ineligible.

Choose Buat broadcast, enter the message, select a schedule, and choose up to 50 consenting recipients. Saving creates an inactive draft. The preview includes the recipient list and an unsubscribe footer. An administrator must acknowledge the WAHA risk and confirm activation.

The approval digest includes the campaign version and consent snapshot. Changed consent requires refreshing the preview. Recurring schedules require an end date within 90 days. The selected audience is fixed for the campaign. Later opt-outs and phone changes are checked again before each delivery.

Initial operating limits are 09.00–18.00 WIB, at least 30 seconds between attempts, 100 attempts accepted or unconfirmed per WIB day, and one accepted or unconfirmed announcement per phone per WIB day. These are application workload limits, not WhatsApp-approved safe volumes. Human-owned conversations are deferred. Helpdesk replies and AI tests take queue priority over broadcasts.

Missed recurring occurrences are coalesced into one current run. A run expires after 24 hours or at the campaign end, whichever comes first. Undelivered expired entries are skipped. Campaigns can be paused or cancelled. Continuing a paused campaign requires a fresh preview and confirmation.

The outbox commits its claim before contacting WAHA. An uncertain outcome pauses the campaign and is not automatically retried. An orphaned sending claim becomes unconfirmed after two minutes. API-originated WhatsApp IDs are recorded through the existing send helper to protect human-takeover detection. Broadcast delivery does not count as a human helpdesk reply.

Accepted by WAHA is not proof of delivery or reading. The dashboard displays the available state and up to 200 recent delivery records per campaign.

tests/test_broadcasts.py covers approval, consent changes, daily limits, pacing, recurring schedules, cancellation, disconnection, human handoff, replayed consent events, and uncertain sends. scripts/check_broadcasts_browser.py uses mock data and makes no WhatsApp or model calls.