# Chat Announcements

## Overview

**Chat Announcements** acts as a primary tool for organizational messaging. It enables administrators to compose and broadcast real-time updates to the entire workforce or specific groups.

#### Capabilities

* **Targeted Messaging**: Send updates to specific channels to ensure only relevant users or departments receive the notification.
* **Priority Levels**: Assign one of the three priority levels - **General**, **Important**, or **Emergency** - to control how the notification behaves on the user's device.
* **Real-Time Delivery**: Push updates instantly to all users logged into BlueFletch Launcher and Chat application as soon as a broadcast is sent from the Portal. 

## User Guide: Chat Manager Tab

#### Create and  Sending Announcements

These are the steps to broadcast a new announcement from the Portal.

1. Navigate to **Portal > Chat Manager** and select the **Announcements** tab from the right navigation bar.

<figure><img src="/files/dGkp9CoVXNKdp0sD5nVT" alt=""><figcaption></figcaption></figure>

2. Click the "**New Announcement**" button located at the top right of the dashboard. This will open the announcement configuration form.

<figure><img src="/files/xVQjAm55WlpkxUjj8J7f" alt=""><figcaption></figcaption></figure>

3. Complete the following fields to define your announcement’s target audience, priority, and content:

<figure><img src="/files/MIzCzln4VOZx3O4ZR9Ae" alt=""><figcaption></figcaption></figure>

* **Channels:** Select the specific communication channel from the dropdown menu where the announcement will be broadcast.

<figure><img src="/files/0lMom0NuHBMyl6fWytpV" alt="" width="524"><figcaption></figcaption></figure>

* **Sites:** Choose one or more sites to target specific channels. If you want to broadcast to all channels instead of selecting individual ones, leave the field blank.&#x20;

<figure><img src="/files/QwwM5GDdrUQ7RXtfNRmk" alt="" width="563"><figcaption></figcaption></figure>

* **Urgency Level:** Select the priority tier to determine device behavior:
  * **General**: Displays a standard notification that auto-dismisses.
  * **Important**: Displays a persistent notification requiring a manual swipe or click to clear.
  * **Emergency**: Displays a high-priority blocking dialog that requires the user to click "OK" to proceed.

<figure><img src="/files/HBAkphR9G4bU9gdOgNTs" alt="" width="563"><figcaption></figcaption></figure>

* **Announcement Expiration:** Set an expiration date and time. The announcement automatically disappears from the user's Chat history once the expiry date passes.

<figure><img src="/files/xLhJFDOuWA2iy2cHLtJe" alt="" width="563"><figcaption></figcaption></figure>

* **Message:** Compose your announcement. The editor supports **Rich Text Formatting (RTF)**.

<figure><img src="/files/v45vBjurpdP485hKPnEM" alt="" width="563"><figcaption></figcaption></figure>

* **Attachments:** You may include supporting documentation such as images or PDF files.&#x20;
  * Supported file size is limited to a maximum of 25 MB.

<figure><img src="/files/8zfyuQiLMlrELfentu8X" alt="" width="563"><figcaption></figcaption></figure>

#### Field Reference

| **Field**   | **Requirement**      | **Description**                                             |
| ----------- | -------------------- | ----------------------------------------------------------- |
| Channels    | Required             | Targets a specific channel.                                 |
| Sites       | Required             | Filters the broadcast by site.                              |
| Urgency     | Required             | Defines the notification behavior on the Chat app receiver. |
| Expiration  | Optional/Pre-defined | Sets the expiry of the message visibility.                  |
| Attachments | Optional             | Supports files (PDF, JPG, PNG) up to 25 MB.                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/portal/chat-manager/chat-announcements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.