# Notification

The Notification channel allows you to **send players messages that appear on their screen** during an exercise.

| Benefit                                                                                                                                                                                                                                               | Feature                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| <ul><li>Mimic desktop alerts</li><li>Provide essential updates, warnings or prompts that need immediate visibility</li><li>Ensure critical moments in the scenario are highlighted</li><li>Keep both participants and Facilitators informed</li></ul> | Send players simple, attention-grabbing messages that appear on the screen during an exercise |

## Running

<figure><img src="/files/zpCb7MAbXncvp79t1DEb" alt=""><figcaption><p>This is what notifications look like in the player view</p></figcaption></figure>

***

## Designing

### When to Use <a href="#when-to-use" id="when-to-use"></a>

* Provide **in-world alerts** like an SMS notification or **out-of-world instructions** to the facilitator
* Use for **quick updates** to notify participants of important milestones
* Highlight critical moments in a scenario that require **immediate attention**
* **Interrupt** player activity for essential prompts or decisions

### How to (Configuration) <a href="#how-to-set-it-up" id="how-to-set-it-up"></a>

To add or remove audio bleep, navigate to the `Configuration` tab in the exercise editor. Choose `Channels` and select `Notification`.

### How to (Inject)

All other setup is in the inject (i.e. in `Exercise`)

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FTFP0uOMw5It0cvuD00kI%252Fimage.png%3Falt%3Dmedia%26token%3Ddbd543ce-4afe-41a7-9fcc-cafd6592ae83&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=93266016&#x26;sv=2" alt=""><figcaption><p>Example notification with optional question</p></figcaption></figure>

#### Option Descriptions <a href="#option-descriptions" id="option-descriptions"></a>

| Option        | Description                                                          |
| ------------- | -------------------------------------------------------------------- |
| Sound         | Toggle sound alerts on or off for notifications. (in `Style`)        |
| Attach media  | Add image to make more realistic or appealing                        |
| Add timer     | Include a countdown that closes the notification (avoid if possible) |
| Add questions | Present the user with choices that cannot be skipped                 |

#### What the Player Sees <a href="#what-the-player-sees" id="what-the-player-sees"></a>

1. **Standard Notification**: Appears as a simple pop-up on the participant's screen:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FEzdcaJFvcJo2GNKCUtIR%252Fimage.png%3Falt%3Dmedia%26token%3Dba204158-746e-4d35-8cf5-09695796559c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=4a1aa27f&#x26;sv=2" alt=""><figcaption></figcaption></figure>

2. **Notification with Question**: Displays a choice of buttons that the user must click. Two buttons appear side-by-side, while more than two will stack vertically:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FLAzdd0XhtlPwVSAyjY3V%252Fimage.png%3Falt%3Dmedia%26token%3Ddd693464-91f5-4b7a-9a10-e29bd4ffd6d2&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7d50ff12&#x26;sv=2" alt=""><figcaption></figcaption></figure>

3. **Notifications with Timers:** Shows a timer countdown; once started, it cannot be skipped or sped up:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FbzfX9yQhN3r2oiwkcXFS%252Fimage.png%3Falt%3Dmedia%26token%3De3114a08-1b5e-41d4-9308-dc0c4d7492bc&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=3535f969&#x26;sv=2" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Note that timers and questions cannot be used simultaneously.
{% endhint %}

### ⭐Best practices <a href="#best-practices" id="best-practices"></a>

* Use media attachments to enhance the impact of your notifications
* Design clear, concise, and purposeful messages to ensure user engagement
* Avoid timer if possible or else set reasonable timers to allow participants adequate time to respond. But not too long because you're removing agency if the pop-up is just a message

### :zap:FAQs: <a href="#faqs" id="faqs"></a>

<details>

<summary>Can notifications be sent to specific people?</summary>

Yes, just like any other inject, you can decide to send it to all players, the EXCON team, roles or positions etc.

</details>

<details>

<summary>Can players dismiss or acknowledge notifications? </summary>

Notifications cannot be skipped, they will appear on screen and the player will have to close the notification to see their dashboard again.

</details>

<details>

<summary>Do notifications persist, or do they disappear after being viewed?</summary>

A "X" appears for the standard notification allowing players to close the notification.

Question notifications require players to select a choice in order for the notification to disappear.

With a timer notification, there is not choice for the player to close the notification. They have to wait for the timer to be up.

</details>

<details>

<summary>Is there a way to track whether a notification was seen or interacted with?</summary>

Only question notifications are tracked and the data can be found in the facilitator dashboard within the review tab and reports.

</details>

### Examples <a href="#examples" id="examples"></a>

The sharefile below has an example of each type of notification option:

* Standard (no button or timer)
* Choice
* Timer

{% file src="/files/lKXyijFwOKFgkiHfS5Jv" %}

In the above example, we move players in Groups depending on their choice.

* Group 1 is the default group that all players belong to at the start of all exercises.
* The player is prompted to make a choice of running the anti-virus scan or not. Those who do are added to Group 2 and those who delay are added to Group 3.
* After this choice no players will belong to Group 1. This means we can use Group 1 later for those of accept another chance to run the virus scan.
* You'll see that injects are sent to Group instead of to All and hence players see the consequence of their choice


---

# 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://helpdocs.conducttr.com/feature-documentation/designing-and-running/channels/pop-up-channels/notification.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.
