Getting Started with DeskDirector
DeskDirector Portals
Browser Support
What is the DeskDirector Admin Portal?
What is the DeskDirector Tech Portal
What is the DeskDirector Client Portal?
Desktop Portal
Managing Your Account
Admin Essentials
DeskDirector Features Overview
Logging in to DeskDirector
User Profiles & Profile Pictures
Managing Tickets with DeskDirector
Office Hours
Getting Started with the Solution Library
How Searching Works
Embedding Help Page Media
Get started with the DeskDirector Power Automate Connector
Features
Portal Customization
Forms
Service Catalogue
Communication
Email Connectors
Notifications
Email Notifications
Actionable Messages for Emails
Real-Time Chats
Email Template Engine
Surveys
Broadcasts
Generative AI
DeskDirector with Generative AI
Ticket Summary for TECH Portal
Setting up AI Service Providers
Microsoft Foundry for DeskDirector
Knowledge Bases for AI Assistants
Custom Tools for AI Assistants
AI Assistants in DeskDirector
Advanced
Login & Authentication
Contact Groups
Custom Domains
File Storage
Dashboard
Accounts
Contacts
Approvals
Tags
Task Lists
The Learning Center
Portal Deep Linking
Auditing & Analytics
Microsoft Power Automate
Actions
Solutions
Featured Solution: Teams Ticket Discussion
Power Automate Template Gallery
Featured Solution: Ticket Briefing
Power Automate Administration
DeskDirector Power Platform Connector Reference
Power Automate Connector - Setting up your first flow
Microsoft Teams App
Introducing the DeskDirector for Microsoft Team App
Installing the Microsoft Teams App (Client Mode)
Installing the Microsoft Teams App (TECH Mode)
Setting up Tags for Teams Discussions (TECH Portal)
Branding the DeskDirector Teams App
DeskDirector Teams App Notifications
Contact Groups Integration with Microsoft Teams
Setting up Content Security Policy (CSP)
Advanced topic: Setting up Tech & Client Mode in the same tenancy
Integrating Microsoft Teams with DeskDirector Tech Portal
Smart Alerts for TECH Users
Integrations
Developer Resources
Getting Started
What is the Toki Iti API
API Versions & Routes
Roles & Scopes
Authorization Options
Querying the API
How to Change an Entity Through the API
API Key Authorization
OAuth Fundamentals
Understanding OAuth for Tokity Integrations: Key Concepts
OAuth Authorization Code Flow: How an App Gets Access to Tokity
OAuth App Registration
How to Register an OAuth App to Integrate with Tokity
Choosing an OAuth App Type: Confidential vs. Public Apps and Client Secrets
OAuth Personal Secrets: What They Are and When to Use Them
OAuth Administration
Configuring OAuth Settings in Tokity
Managing OAuth Authorized Sessions and User Consent
Granting OAuth Admin Consent at the Root Level
API Response Control
Uploading Attachments (Ticket API)
The Prefer Header — Overview
Controlling Returned Data (Ticket API)
Controlling Returned Data (Form Result API)
Controlling Returned Data (Workspace API)
Workspace Ordering
How Workspace Ordering Works
Creating and Reordering Workspace Groups
Adding and Reordering Tickets in a Workspace Group
Data Sync & Notifications
Delta API: Tracking Changes Over Time
Webhooks vs. Events — Differences, When to Use Which
Verifying Webhook and Event Payloads (HMAC Signature)
Ticket Widgets
Ticket Widget: Overview
How the Widget Is Requested
Ticket Widget Anatomy and Styling
Ticket Widget Actions: Leading, Secondary and Primary
Ticket Widget: Progress Type
Ticket Widget: List Type
Ticket Widget: Description Type
Ticket Widget: Form Type
Ticket Widget: Control When a Widget Refreshes
Ticket Widget: Form Results and State Across Steps
Ticket Widget: Error Responses and Debugging
Ticket Widget: Building a Multi-Step Request
Glossary
Security
Troubleshooting
Troubleshooting via Web Developer Tools
Permissions & Access - Common Issues
Contact DeskDirector Support
Troubleshooting DeskDirector Connection Issues
Desktop Portal - Common Issues
Contact Impersonation
Approvals - Common Issues
Microsoft Teams App - Common Issues
Email & Email Delivery - Common Issues
Login & Authentication - Common Issues
DeskDirector Desktop App - Installation Issues
Table of Contents
- All Categories
- Features
- Communication
- Notifications
Notifications
Updated
by Niamh Ferns
Notifications Overview
The notification feature allows users to receive alerts on their desktops for certain events on their desktop and will automatically close after 10 seconds if not dismissed by the user. An end user will be notified when:
- A ticket status is changed
- Notes or time entries have been added
- A company broadcast is made
Portal Notification settings are global, so once enabled, all of your clients will see them. Unless you add contacts/accounts to the advanced filters listed in this document.
Enabling Notifications
To enable notifications, follow the steps below
- Log in to your Admin Portal
- Navigate to
Client Portal>Notifications
- Enable notifications via the toggle switch:
Enable Notification - Select which notification events you want end users to receive
- Add your preferred queuesNote: not adding any queues will mean that users do not receive notifications!
- Optionally, limit which companies or contacts receive notifications via Receivers under the Advanced tab. We recommend limiting this feature to individual clients as you update each one.
- Optionally, limit notifications by ticket status by adding them to the Status Triggers in the Advanced tab.

Controlling Which Statuses Fire Notifications
You may have certain statuses that you don't need your clients to be notified for. We have functionality in place to configure just that.
Log in to the Admin Portal and navigate to Client Portal > Notifications, then open the Excluded Status List:

From here, you can enter the statuses you want to exclude from firing a notification. And that's it - any tickets with these statuses will no longer trigger notifications for your clients!
Client Portal Ticket Notifications
In the DeskDirector Client portal, the Notification page will show both active broadcasts and recent ticket updates.

Broadcasts
The top section of the notifications page is where all broadcasts appear. A client can not dismiss/remove any broadcast notifications. They can only be removed by Service Agents or will automatically disappear when reaching the end of their scheduled time.
Ticket Updates
As the name suggests, this is where notifications for updates to an end user's tickets appear:
- If the end user has submitted a ticket that requires approval, it will show whether the ticket has been declined/approved
- It will show ticket changes (i.e. status/priority changes, notes added, and other configured events).
- Any "internal" changes like techs assigning a resource, adding a CC, adding an internal note, changing ticket contact, et cetera, will not trigger a ticket update notification.
Example: If a ticket has its status changed, then a note is added, it will only show that a note has been added and not that it has changed status.
Push Notifications
Aside from the notifications page in the Client Portal, notifications are also pushed to clients from both the web and desktop portals. These will appear on your computer as a notification that you're usually used to seeing for your platform (whether it be Windows, MacOS, Android, or iOS).
Tech Portal Ticket Notifications
Notifications are a great way to keep track of any activity on a site Ticket Notifications make it easy to keep track of tickets that you have handled or assigned to you. All your notifications will be visible under the Notifications tabs in the DeskDirector Tech portal.

Opening the page will show all Unread notifications that you have. You can filter the notifications to show all or just unread. Selecting "All Notifications" will show all past notifications that are up to 7 days old. You are able to open the relevant ticket for each notification by clicking on the notification you're interested in.
You can mark notifications as read by clicking on the checkmark adjacent to them, or mark all unread notifications by clicking on the double check mark beside the unread notification count.
Frequently Asked Questions
"Why do I not see notifications from certain tickets?"
There are several settings for notifications that can be configured in the Admin portal. All these settings are under Portal > Notifications. Double-check whether the queue has notifications enabled, or if account or contact filters are used for notifications or if there are exceptions as to which ticket status triggers notifications.