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
- Service IP Addresses
- Troubleshooting Custom Domains
- Step 1: Confirm your .deskdirector.com domain resolves correctly
- Step 2: Confirm your .deskdirector.com URL loads the login page
- Step 3: Confirm DNS propagation
- Step 4: Confirm you can sign in successfully
- Step 5: If you use a custom domain, confirm it resolves to your DeskDirector domain
- Step 6: If you use a custom domain, confirm the site loads and SSL is valid
- All Categories
- Troubleshooting
- Troubleshooting DeskDirector Connection Issues
Troubleshooting DeskDirector Connection Issues
Updated
by Niamh Ferns
- Service IP Addresses
- Troubleshooting Custom Domains
- Step 1: Confirm your .deskdirector.com domain resolves correctly
- Step 2: Confirm your .deskdirector.com URL loads the login page
- Step 3: Confirm DNS propagation
- Step 4: Confirm you can sign in successfully
- Step 5: If you use a custom domain, confirm it resolves to your DeskDirector domain
- Step 6: If you use a custom domain, confirm the site loads and SSL is valid
Service IP Addresses
Connection issues from DeskDirector to your various services can be caused by firewall restrictions in your environment or an incorrectly configured proxy. Depending on your location, we would have built your instance on a server close to where you operate.
To figure out which you are on, you can open a console and use the following command:
ping <your subdomain here>.deskdirector.com
You will see an output that looks something like this:
C:\Users\Jane.Doe>ping customer.deskdirector.com
Pinging dd-au-1.deskdirector.com [4.191.174.158] with 32 bytes of data:
Please make sure you have whitelisted this IP in your company's firewall. This IP address can change from time to time, so if you notice a drop in connectivity, please confirm whether you have whitelisted the correct IP.
Troubleshooting Custom Domains
Step 1: Confirm your .deskdirector.com domain resolves correctly
DeskDirector instances are hosted on regional infrastructure. Your .deskdirector.com domain should resolve to a DeskDirector-managed target (commonly a server CNAME or front-door endpoint).
Run a DNS lookup for your DeskDirector subdomain:
Windows (Command Prompt): nslookup yourcompany.deskdirector.com
macOS/Linux (Terminal): dig yourcompany.deskdirector.com
What to record
- What record type you see (CNAME/A record)
- The target it resolves to (e.g. a
dd-xx-x.deskdirector.comhostname or a front-door style endpoint)
Step 2: Confirm your .deskdirector.com URL loads the login page
Open your .deskdirector.com URL in an incognito/private window:
- Example:
https://yourcompany.deskdirector.com
You should reach the DeskDirector login page (either directly or via your custom domain redirect if configured).
What to record
- The exact URL you entered
- The final page you land on
- Any error message (e.g. DNS_PROBE_FINISHED_NXDOMAIN, 404, 502/503, This site can’t be reached)
Step 3: Confirm DNS propagation
Even if DNS looks correct from your location, DNS changes (or resolver issues) can affect some regions and not others. A propagation checker helps confirm whether failures are widespread or localized.
What to do
Use a public propagation tool such as: dnschecker.org
In the tool:
- Enter your domain (start with
yourcompany.deskdirector.com) - Select the record type you care about (commonly CNAME or A, depending on what you expect)
- Review results across multiple locations
If you use a custom domain, repeat the same test for support.yourcompany.com.
Step 4: Confirm you can sign in successfully
Attempt to sign in from your .deskdirector.com domain first.
Typical sign-in options vary by configuration, but commonly include:
- Sign in with Microsoft
- Email token / magic link (if enabled)
What to record
- How far you get in the login process
- Whether you reach the Admin Portal successfully
- Any error text (copy/paste) or screenshots
Step 5: If you use a custom domain, confirm it resolves to your DeskDirector domain
DeskDirector custom domains typically require your custom domain to resolve to your .deskdirector.com domain (commonly via CNAME). This supports SSL certificate provisioning (e.g. Let’s Encrypt) and correct routing.
What to do
Run a DNS lookup on your custom domain: nslookup support.yourcompany.com
The custom domain should resolve (directly or indirectly) to your .deskdirector.com domain.
Step 6: If you use a custom domain, confirm the site loads and SSL is valid
Open your custom domain in a browser
- Example:
https://support.yourcompany.com - Does it load the DeskDirector login page?
- Is the SSL certificate valid (no browser warning)?
Provide as much supporting evidence from the above steps to the DeskDirector support team.