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
- Getting Started with DeskDirector
- Managing Tickets with DeskDirector
Managing Tickets with DeskDirector
Updated
by Niamh Ferns
Overview
To see how to manage tickets via the legacy approach, see What is the DeskDirector TECH Portal?
Upcoming Features
We are currently building out a completely new and improved ticket management UI. This new ticket management UI will give you a new ticket list, where you can cleanly and effectively filter for tickets, and a ticket UI where you can work on your tickets in a more user-friendly manner. Below, we provide an overview of the new ticket UI
Ticket List
With the new ticket list, you can create tickets, filter for specific tickets, and browse for tickets that need your attention.

To create a new ticket, select New ticket and then fill in ticket details as you normally would:

Filtering for Tickets
Below, you can see all the interactive elements for the new ticket list UI:

There is a set of filters that you can use for:
- Ticket State
- Ticket Owner (Contact)
- Ticket Assignee (Agent)
- Ticket Tags
- Decide which filter to order by and whether they're ascending or descending
- Refresh your ticket list for updates
- Select whether you're looking for open or closed tickets
- Select your primary filter (by default, this will filter by Queue):
Within the main ticket list portion of the screen, you can:
- Quick filter for the ticket assignee
- Switch between pages
- Quick filter for the ticket contact
- Quick filter for the ticket company
Multiple Filters
For agents that need to function across multiple queues, contacts, and more, we've added the ability to select multiple primary filters! For most users, this will be useful in filtering by multiple queues.
To get started, select a queue that you'd like to start with and then hold control and click on the other queues/statuses you want to filter for:

Working on Tickets
To start working on a ticket, select the ticket you're interested in, and you will be presented with the new ticket interface:

Here, you can:
- Add time and notes
- Update the ticket's details
- Assign members and contacts
- Perform ticket actions like closing, reopening, and requesting further information
Adding Time & Notes
To add time to a ticket, make sure your ticket is not marked as an internal note, then add your details. You then select the Log Time checkbox and add your start time, end time, and any time that should be deducted.

If needed, you can preview your note and then submit.
If you don't need to log time, you can uncheck the Log Time checkbox and optionally select the Internal note checkbox if your entry contains sensitive information.
If this is the final note on a ticket, you can select the Close ticket button instead to add your note and close the ticket immediately.
Updating Ticket Details
On the right-hand side, you can further update the ticket as needed:

- Assignees: assign agents to work on a ticket
- Tasks: add tasks to your ticket
- Supplementary Forms: submit additional, inline forms for your client to respond to
- Queue: update the queue/board
- Status: update the status
- Priority: update the priority
- Categories: update the ticket category
- Source: update the ticket's source
- Contact Group: assign the ticket to a contact group
- Edit the ticket title
Additionally, you can select the contact to:

- Change to another to other contact for the account
- Change to any contact in your DeskDirector instance
- View the contact details
- View the account details
If you scroll down, you can add additional contacts to a ticket as well:
