Broadcast Announcements

Purpose - Allows a sender to deliver a single message to a very large group of users, such as every employee, every school, every student, or all users belonging to a specific service or region. Broadcasts are processed in batches so they remain reliable even for large audiences. 

Who Can Use It 

Users who are authorized to send announcements at scale, typically: 

• Organization users 
• Authority users 
• School Admins or Department Admins (depending on the target audience). 

Key Capabilities

• Broadcast an existing message to a wide audience, or create and broadcast a new message in a single step. 
• Choose a broad scope such as ALL, SCHOOL, EMPLOYEE, or STUDENT, or specify a service-based target such as employee, student, parent, or school. 
• Provide an estimated recipient count and optional batch size to guide delivery. Provide an optional idempotency key to prevent duplicate broadcasts if the request is retried. 
• Receive a job identifier and batch count so the broadcast can be tracked.  

How to Use It

• Open the messaging area and choose Broadcast Message (or similar).
• Either select an existing message you have already created, or compose a new inline message with subject, body, and sender details. 
• Choose the audience: 
• A simple scope, for example ALL or SCHOOL. 
• Or a structured target, for example the "employee" service. 
• Optionally review the estimated count and batch size. 
• Confirm the broadcast. The system accepts the request and starts processing it in the background. 
• Track the broadcast using the returned job identifier. 

Rules & Restrictions 

• Either an existing message ID or an inline message must be provided — not both.
• A scope or target must always be provided; broadcasts without an audience are rejected.
• When creating an inline message for a broadcast, the subject is required.
• Default estimated counts are applied when none is provided:
• ALL: 1,000,000 recipients 
• EMPLOYEE variants: 100,000 recipients 
• STUDENT: 500,000 recipients 
• SCHOOL: 50,000 recipients 
• The system splits the audience into batches (default 10,000 per batch) for reliable delivery. 
• Broadcast delivery is asynchronous. The platform confirms acceptance and processes delivery in the background.