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
- Troubleshooting
- Microsoft Teams App - Common Issues
Microsoft Teams App - Common Issues
Updated
by Niamh Ferns
Microsoft Teams App Troubleshooting
"When I try to open the Teams app, it says that it hasn't been assigned to a Chat."
This is a common issue that requires a fix in two parts. The second part is under the heading: "When I try to access the settings page, it won't load."
Please do the following:
- Uninstall the DeskDirector Teams app from your Teams instance and remove it from all channels (if any) that it is associated with
- Head to your Teams Admin Center and ensure that you have allowed access to the DeskDirector Teams app
- Reinstall the DeskDirector Teams app in TECH Mode and associate it with a single chat
After this, please proceed to the steps for "When I try to access the settings page, it won't load".
"When I try to access the settings page, it won't load."
DeskDirector no longer provides support for old OAuth. You can find information on how to move here.
This is often caused by issues with the DeskDirector service principal in your Microsoft tenant. To resolve this, please:
- Open Entra and search for any DeskDirector enterprise applications. You should see at least one: "DeskDirector". You may also see "DeskDirector Teams". Please delete both of these
- Open your DeskDirector Admin Portal and head to System > Authentication
- Under the "Tech Portal" section, regrant admin consent for DeskDirector:

- Now, under the same menu, regrant admin consent for Teams:

- Back in Entra, confirm that both of your service principals for Teams and DeskDirector are showing as active
- Restart Teams fully, and you should now be able to access the settings page again
"I'm getting an error saying 'No Service Provider Found'."
When initialising the DD Teams app, you may encounter the following message: "No Service Provider Found". This error prompts you to contact your service provider to enable Microsoft Teams' integration feature for you. This issue usually arises when attempting to set up the Client Portal mode for your clients' teams, and their Azure Active Directory (AAD/Entra) tenancy hasn't been linked to one of the companies in DeskDirector in the TECH mode.
To resolve this issue, follow this documentation.
"I'm running into a loop when trying to install the Teams App"
You may be experiencing an installation loop issue with the DeskDirector Teams app. That is, despite trying to install, you are repeatedly prompted to install the portal app.

The issue may occur if the bot has not been installed before setting up the integration. The bot's installation is a prerequisite for successful integration setup:
- Uninstall and Reinstall the DeskDirector Teams app: Navigate to the team where the app is being installed. Go to Manage team under the ... menu to the right of the Team's name. Under the Apps tab, find the DeskDirector app and uninstall it.
- Install the DeskDirector Teams app to a team: Reinstall the app to a team's channel. Make sure to install both the tab and bot. The default install button should include both components. Do not install the tab without the bot.
- Check for Bot Installation: After reinstalling, the bot should be set up automatically in the background. Upon successful bot installation, you should receive a welcome message.
- Set Up the Integration: Once the bot is installed, proceed with the integration setup.
Please refer to the installation guide screenshot for a visual reference: Installation Guide.
If the issue persists after following these steps, please contact our support team for further assistance.