> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osto.one/llms.txt
> Use this file to discover all available pages before exploring further.

# ITSM

> Reach every employee's desktop through the Osto app — send campaigns, answer support requests, and control exactly what employees see.

**ITSM (IT Service Management)** is where you talk to your employees through the Osto app on their computers. From one place in the panel you can reach every desktop, hear back from every employee, and shape the app they use every day.

> **Path:** ITSM → Campaigns · Support requests · Settings

![The Osto app on an employee's desktop showing Connected to Osto, Secure access, an Inbox message and the Tip of the day](https://mintcdn.com/osto/lbK1ZB_l0ZwTotqQ/images/itsm/app-tray-light.png?fit=max\&auto=format\&n=lbK1ZB_l0ZwTotqQ\&q=85\&s=4809b9e94a9ffcf4217d86d01ca2f9a2)

> [card] [Send campaigns](#campaigns)
>
> Notices, polls, quizzes and links that pop up right on employee desktops.

> [card] [Handle support requests](#support-requests)
>
> Employees ask IT for help from the Osto app. You reply from the panel.

> [card] [Control what employees see](#settings)
>
> Your branding, the websites links may point to, and which app features show.

> [!NOTE]
>
> ITSM is part of your plan. If your plan doesn't include ITSM, the **ITSM** menu won't show in the panel.

## Finding your way around

In the panel's left sidebar, open **ITSM**. It has three pages:

| Page | What you do there |
| - | - |
| **Campaigns** | Create, track and manage everything you send to desktops. |
| **Support requests** | Read and answer help requests from employees. |
| **Settings** | Branding, allowed link domains and Osto app settings. |

> [!NOTE]
>
> With **read-only access** you can see everything, but you can't change or save anything.

> [!TIP]
>
> **New to ITSM?** Set up [Branding](#branding) and [Allowed link domains](#allowed-link-domains) first. Without allowed domains, no link campaign can be published.

***

## Campaigns

A campaign is anything you send to employee desktops. It appears as a pop-up on screen and is kept in the employee's **Inbox** in the Osto app.

![Osto app Inbox with tabs for All, Campaigns, Security and System, listing a security event and an acknowledged critical notice](https://mintcdn.com/osto/lbK1ZB_l0ZwTotqQ/images/itsm/app-inbox.png?fit=max\&auto=format\&n=lbK1ZB_l0ZwTotqQ\&q=85\&s=a4a7fa42986ccb2e204f54472dde260e)

The Inbox in the Osto app keeps every campaign and security event for the employee.

### Types of campaign

> [card] Notice
>
> A message employees read and acknowledge.
>
> **Kinds:** Information, Warning, Critical

> [card] Poll
>
> A survey with one or more questions.
>
> **Kinds:** CSAT, Tracking, Opinion, eNPS, General

> [card] Link
>
> A button that opens a web page or a file download.
>
> **Kinds:** Installer, PDF

> [card] Quiz
>
> Questions with right answers, a pass mark and a score.
>
> **Kinds:** Security awareness, General

### The Campaigns page

* The page lists every campaign with its **type**, **status** and **how many people responded**.
* Use the **filter chips** to show **All**, **Notices**, **Polls**, **Links** or **Quizzes**.
* Use the **search box** to find a campaign by its title.
* **Tiles** at the top give a quick summary, such as how many devices are online.

#### What each status means

```mermaid theme={null}
flowchart LR
    D[Draft] --> P[Publishing]
    P --> S[Scheduled]
    P --> L[Live]
    S --> L
    L --> C[Completed]
    L --> X[Stopped]
    S --> X
```

| Status | Meaning |
| - | - |
| **Draft** | Saved but not sent yet. |
| **Publishing** | Being sent right now. |
| **Scheduled** | Published, waiting for its start time. |
| **Live** | Showing on desktops now. |
| **Completed** | Its end time has passed. |
| **Stopped** | Someone stopped it by hand. |

### Creating a campaign

Click **Add campaign** and work through these sections.

**1. Type**

Choose **Notice**, **Poll**, **Link** or **Quiz**, then choose its kind.

**2. Content**

* **From (team):** who it comes from, for example *"IT Helpdesk"*.
* **Title:** plain text only.
* **Message:** you can use simple formatting such as **bold**, *italic*, lists and quotes.
* **Button text:** leave it empty to use the default.

**3. Questions (polls and quizzes only)**

Employees see **one question per screen**.

> [tab] Poll questions
>
> * Star rating
> * Yes / no
> * Single choice
> * Multiple choice
> * 0 to 10 scale
> * Agree / disagree scale
> * Free text
>
> Up to **20 questions** per poll.

> [tab] Quiz questions
>
> * Single choice
> * Multiple choice
> * Yes / no
>
> Mark the correct answers and set **points** for each question. Up to **50 questions** per quiz.

**Other options:**

* Make an answer **required**.
* Add a **hint** under the question.
* Add an optional **comment box** under a star rating.
* Mark an answer that must be **chosen alone**, such as *"None of these"*.
* Make a poll **Anonymous**, so answers are stored without who gave them.

**4. Quiz settings (quizzes only)**

| Setting | Range |
| - | - |
| **Time limit** | 30 to 3,600 seconds |
| **Pass mark** | 1% to 100% |
| **Retakes** | Let employees retake the quiz if they fail, and set how many attempts are allowed |
| **Show answers** | Show the correct answers after submitting |

> [!TIP]
>
> Correct answers stay on the server. Employees can't see them before they answer.

**5. Link (link campaigns only)**

* Enter the web address. It must start with `https://`, and its domain must be on your [allowed list](#allowed-link-domains).
* For a file download you can also add the **file name**, its **size** and its **SHA-256 checksum** (optional).
* The link opens in the employee's own browser.

**6. Audience — “Who should get this?”**

* **Who:** pick **Everyone in the organization**, or **Specific groups and people** (choose user groups or single users).
* **On which computers?** Pick **All operating systems**, or only some of **Windows**, **macOS** and **Linux**.
* **Also send to people and computers added later:** new employees or devices that join while the campaign runs get it too. The system checks for new ones about every 5 minutes.
* **Who needs to respond:**

> [accordion] Each person once, on any of their computers (default)
>
> When a person answers on one computer, it closes on their other computers.

> [accordion] Every computer separately
>
> Each computer needs its own answer.

**7. Behaviour**

* **Stays on screen until done (no close button):** the employee must complete it before it goes away. Critical notices and quizzes always stay.
* **Priority (0 to 100):** if several campaigns are waiting, the higher number shows first.
* **Employees may snooze it ("Remind me later"):** choose how many snoozes are allowed (1 to 10) and how long to wait before reminding again.

> [!NOTE]
>
> Snooze isn't available when **Stays on screen until done** is on.

**8. Schedule**

* **Start showing:** leave it empty to start as soon as you publish. It can't be in the past.
* **Stop showing:** leave it empty to run until every employee has done it or you stop it. It must be at least 1 minute after the start time.
* Times are in your own time zone.

**9. Preview, save or publish**

* A **live preview** shows how the campaign will look on the employee's desktop.
* Click **Save draft** to keep working on it later.
* Click **Publish** to send it. You'll be asked to confirm, and then you'll see how many devices it went to.

> [!WARNING]
>
> Publishing is refused if a link points to a domain that isn't on your allowed list.

### After publishing

Open a campaign from the list to see its details.

> [tab] Recipients
>
> You can see every device and where the campaign is on it:
>
> | Status | Meaning |
> | - | - |
> | **Pending** | The device hasn't picked it up yet. |
> | **Delivered** | It's on the device but hasn't been shown yet. |
> | **Displayed** | It's on screen, with no answer yet. |
> | **Completed** | The employee acknowledged it, answered it, opened the link or finished the quiz. |
> | **Dismissed** | It was closed without an answer. |
> | **Expired** | It closed because the campaign ended or was stopped. |

> [tab] Quiz results
>
> See who **passed**, who **didn't pass**, who is **still trying** and who **hasn't attempted** it.
>
> You also see the **pass rate**, the **first-try pass rate** and the **number of attempts**.

### What you can do with a campaign

| Action | What happens |
| - | - |
| **Edit draft** | Only drafts can be edited. |
| **Publish** | Sends a draft. |
| **Stop campaign** | The campaign closes on every device the next time the device checks in. Answers already given are kept. |

> [!WARNING]
>
> A stopped campaign can't be started again.

***

## Support requests

Employees ask IT for help straight from the Osto app, and you answer from the panel. The whole conversation stays in one place.

### How employees raise a request

**1. Open Support**

Open the Osto app and go to **Get help / Support**.

**2. Pick a category**

**Laptop or hardware**, **Software**, **Access or passwords**, **Network or Wi-Fi**, **Security concern**, or **Other**.

**3. Describe the problem**

A **subject** (one line, up to 120 characters) and a **description** (up to 4,000 characters).

**4. Attach files if needed**

Screenshots or videos — see the limits below.

**5. Share device details**

Choose whether to include computer name, system and Osto version. This helps IT.

**6. Submit**

Click **Submit request**. The employee gets a reference number, such as `SUP-123`.

![Osto app Support screen with category choices, subject, description, attach files and Submit request button](https://mintcdn.com/osto/lbK1ZB_l0ZwTotqQ/images/itsm/app-support-request.png?fit=max\&auto=format\&n=lbK1ZB_l0ZwTotqQ\&q=85\&s=3e421cf198ed53d37363fe099707e43b)

Get help in the Osto app.

| Attachment | Formats | Max size |
| - | - | - |
| **Images** | PNG, JPG, WebP | 10 MB each |
| **Videos** | MP4, WebM | 50 MB each |

Up to **5 files** per request.

> [accordion] A few more things about requests
>
> * If the computer is **offline**, the request is sent when it reconnects.
> * Each computer can send up to **10 requests a day**. Any more are queued for later.
> * Employees can follow their requests under **My requests** and reply to IT.
> * If an employee replies to a **resolved** request, it opens again.

### How admins handle requests

Go to **ITSM → Support requests**.

#### Browsing and searching

* Use the **status tabs**: All, Unresolved, Open, In progress, Resolved, Closed.
* Filter by **category**, by **date** (Today, Last 7, 30 or 90 days), or show **Unread only**.
* **Search** by subject, text, reference number or person.
* A tile at the top shows your **Average first response time**.

#### Working on a request

Open a request to see:

* the conversation;
* who sent it;
* their device details, if they shared them (computer, system, Osto version, hardware ID, last seen);
* any attachments.

#### Replying

* Write a reply of up to **4,000 characters**. You can attach up to **5 files**.
* If you attach files, you don't need to write any text.
* Press <kbd>Ctrl</kbd> + <kbd>Enter</kbd> to send.
* The employee sees your reply in the Osto app.

#### Changing the status

```mermaid theme={null}
stateDiagram-v2
    direction LR
    Open --> InProgress: Start working on it
    InProgress --> Open: Back to open
    Open --> Resolved: Mark resolved
    InProgress --> Resolved: Mark resolved
    Resolved --> Open: Reopen
    Open --> Closed: Close
    InProgress --> Closed: Close
    Resolved --> Closed: Close
    Closed --> Open: Reopen
    InProgress: In progress
```

| From | You can move it to |
| - | - |
| **Open** | Start working on it (In progress), Mark resolved, Close |
| **In progress** | Mark resolved, Back to open, Close |
| **Resolved** | Reopen, Close |
| **Closed** | Reopen |

***

## Settings

Go to **ITSM → Settings**. There are three tabs.

### Branding

This is how your company appears at the top of every campaign on employee desktops.

* **Company name:** leave it empty to use your organization's name in Osto.
* **Logo:** PNG or JPEG, square, at most **64 KB**. Without a logo, desktops show your company's initials.
* A **preview** shows how it will look.

### Allowed link domains

This is the list of websites that campaign links may point to, for example `example.com`, or `*.example.com` for all its subdomains.

* It applies to links in **link campaigns** and to links **inside messages**.
* Publishing refuses any `https` link to a domain that isn't on this list.
* You can add up to **100 domains**.

> [!WARNING]
>
> An empty list blocks all links.

### Osto app — "Show in the Osto app"

Choose what employees can see in the Osto app on their computers. **Everything is on by default** until you change it.

![Osto app Home showing Protected status and policies: Secure access, App control, Web control, Device control, Data protection, Disk encryption and Screen lock](https://mintcdn.com/osto/lbK1ZB_l0ZwTotqQ/images/itsm/app-home.png?fit=max\&auto=format\&n=lbK1ZB_l0ZwTotqQ\&q=85\&s=10fda96c6c5a05320c6565bbedfaa0ea)

The Osto app home screen — each protection feature can be shown or hidden.

> [accordion] Campaigns
>
> If you turn this off, campaigns stop reaching employees and nothing new can be published. You can still see past campaigns in the panel.

> [accordion] Support requests
>
> If you turn this off, employees can't send new requests or reply to existing ones from the app. You can still read and answer existing requests in the panel.

> [accordion] Tip of the day
>
> Shows a daily security tip in the app.

> [accordion] Protection features
>
> Choose which features employees can see in the app:
>
> * App control
> * Web control
> * Device control
> * Data protection
> * Disk encryption (not available on Linux)
> * Screen lock
> * Threat monitoring
> * Secure access
>
> ![Osto app Secure access screen showing Connected with download, upload, received and sent stats](https://mintcdn.com/osto/lbK1ZB_l0ZwTotqQ/images/itsm/app-secure-access.png?fit=max\&auto=format\&n=lbK1ZB_l0ZwTotqQ\&q=85\&s=9c4dd4a659ff8948f898037dd412fe63)
>
> Secure access as employees see it.

> [!NOTE]
>
> Hiding a feature only hides it from employees. **Your policies are still enforced.**

Changes are only applied when you click **Save**. The page also shows who last changed these settings and when.

> [!NOTE]
>
> If your plan doesn't include ITSM, you'll still find these Osto app settings under **Policies → Osto app**.

***

## Tips for getting the best out of ITSM

> [card] Set up the basics first
>
> Configure **Branding** and **Allowed link domains** before anything else. Without allowed domains, no link campaign can be published.

> [card] Use Critical notices sparingly
>
> They can't be dismissed or snoozed.

> [card] Respect people's focus
>
> Allow snooze on anything that isn't urgent, so you don't interrupt people's work.

> [card] Reach new joiners automatically
>
> Turn on **Also send to people added later** for long-running campaigns such as onboarding or policy notices.

> [card] Get honest feedback
>
> Use **anonymous polls** when you want people to speak freely.

> [card] Make quizzes teach
>
> Run security awareness quizzes with retakes and correct answers shown afterwards, so employees learn from their mistakes.

> [card] Ask for device details
>
> Device details in support requests make problems much faster to solve.

> [card] Stay on top of the queue
>
> Check the **Unresolved** tab daily and keep an eye on your average first response time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.