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
Service Catalogue Strategy
Service Catalogue Setup: Choose Your Path
Why a Small Service Catalogue Works Better
Service Groups Explained: Controlling What Contacts See
Quick Setup: Service Groups for Teams With Limited Time
Advanced Catalogue Model: Proactive, Reactive and Automated
Build a Small, High-Value Service Catalogue
Capture Requests the Catalogue Misses With Inline Forms
Use AI Categorisation Instead of Setup-Only Service Types
Monthly Service Catalogue Review Checklist
Automate Service Group Creation for Each Contact or Account
Contact Groups: Shared Tickets for Teams
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
- Service Catalogue Strategy
- Advanced Catalogue Model: Proactive, Reactive and Automated
Advanced Catalogue Model: Proactive, Reactive and Automated
Updated
by Helpdocs Admin
The advanced model combines three parts: a small catalogue for your most common requests, AI-attached forms for rare requests, and AI categorisation for everything else. Together they help contacts create tickets quickly while your team still gets the information it needs.
This approach takes more effort than the Quick Setup. It suits teams that have time to review the catalogue every month.
The short version
- Proactive: a small catalogue of 5 to 10 high-value service types.
- Reactive: AI attaches a form after the ticket is created, only when needed.
- Automated: AI sorts every ticket, so service types don't have to.
- Review: a monthly check keeps all three parts working.
Who this is for
This model works best when you have:
- A person dedicated to customer success, not just in name.
- Time each month to review form results, tickets and hours.
- Someone able to set up webhooks or events, AI prompts and automation.
If you don't have these yet, start with the Quick Setup. You can move to this model later.
The three parts
1. Proactive: a small, high-value catalogue
You choose the few service types that bring the most value. These are the requests that are submitted often, or that make a big difference when handled well. Keep them at the root level and keep their forms short.
Because the list is short, contacts can scan it quickly, even when they are in a hurry.
Read more: Build a Small, High-Value Service Catalogue
2. Reactive: capture what the catalogue misses
Some requests are useful but rare. Instead of creating a service type for each one, let the contact create the ticket first. Then AI reads the ticket and attaches a form only if one is needed. The contact answers a few questions after they know their request was received.
AI has two options:
- Predefined form. AI searches your forms by name, description and tag, using MCP, and attaches the best match.
- Disposable form. If nothing fits, AI drafts a short form for that one ticket. Disposable forms are for ad-hoc cases.
Read more: Capture Requests the Catalogue Misses With Inline Forms
3. Automated: let AI sort every ticket
Some service types exist only to set a tag, queue, status, category or priority. AI can do this after the ticket is created, based on what the contact wrote and who they are, such as their account, role or VIP flag. It can also assign a tier 1 agent, which replaces much of the dispatcher's work.
You can then remove those service types and shorten the catalogue.
Read more: Use AI Categorisation Instead of Setup-Only Service Types
How the parts work together
Stage | What happens | Part |
Before the ticket | The contact sees a short list and picks one. Forms are short. | Proactive |
Ticket created | The contact knows the request was received. A webhook or event is triggered. | |
Right after | AI sets tags, queue, status, category, priority and agent. | Automated |
Right after | AI attaches a form if more details are needed. | Reactive |
Each month | You review what was submitted and adjust. | Review |
The monthly review connects everything
The review is how you learn what to change. Use it to:
- Remove service types and forms nobody uses.
- Merge near-duplicate forms.
- Find tags that appear often and may deserve a service type.
- Find disposable forms that keep repeating, and turn them into predefined forms or service types.
- Check where your team's hours go.
- Check a sample of AI results for mistakes.
For custom reports, you can use the API and export your data to Power BI or a data lake.
Read more: Monthly Service Catalogue Review Checklist
What it costs
Be clear about the costs before you start:
- Setup effort. You need to set up webhooks or events, write AI prompts, and describe and tag your forms.
- Ongoing effort. A monthly review takes time and attention.
- AI usage cost. Each ticket is read by AI. Compare this with the cost of manual sorting and dispatch.
- Mistakes. AI will sometimes choose the wrong tag, priority or form. People make mistakes too. Review a sample each month and adjust.
- Less guaranteed routing. A service type routes a ticket correctly only when the contact picks the right one. AI sorts every ticket, whatever route it came from.
Suggested order
You don't need to start everything at once.
- Build your small catalogue and review it monthly.
- Add AI categorisation, then retire setup-only service types.
- Add inline forms for rare but useful requests.