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
- Microsoft Teams App
- Setting up Tags for Teams Discussions (TECH Portal)
Setting up Tags for Teams Discussions (TECH Portal)
Updated
by Niamh Ferns
Start a conversation in Teams from a DeskDirector Ticket
We can start a discussion in a Teams channel by adding a custom tag to a ticket.
This feature allows ticket agents to initiate an internal conversation within Microsoft Teams for specific tickets in the DeskDirector Tech portal. This feature provides a streamlined and efficient way for ticket agents to communicate and collaborate on resolving customer issues, allowing them to resolve issues more quickly and effectively.
Key Benefits
- Centralised Communication: Links DeskDirector tickets to dedicated Teams conversations
- Real-Time Collaboration: Team members can discuss tickets internally while maintaining customer service quality
- Streamlined Workflow with AI: Generate, review, and send customer replies directly from Teams with your AI Assistant
Setup
Here's a step-through on how to set up this feature:
- Browse to a Teams Channel with DeskDirector installed in TECH Mode
- From the menu items of the Team Channel, select your DeskDirector application, followed by Tag to chat

- Select from the available teams channels:

- Enter your preferred tag, followed by enabling the Use Tag to chat slider:

- The tag cannot be edited while the feature is enabled, to update the tag, you must first disable the feature
- Optionally, enable the Mentions feature

How to Create a New Conversation
- Open the Ticket in DeskDirector TECH Portal
- Navigate to the ticket you want to discuss internally
- Add the Configured Tag

- Add the pre-configured "Tag to Chat" tag during your setup to the ticket
- Automatic Teams Conversation Creation

- The DeskDirector Teams app automatically creates a new conversation in the configured Teams channel
- The conversation is linked to the specific ticket
- Team Collaboration
- Channel members can now chat internally about the ticket
- All internal discussions remain separate from customer-facing communications
- Automatic Updates
- New messages added to the original ticket are automatically posted to the Teams conversation
- Team members stay informed of ticket updates in real-time

How to Generate AI-Assisted Replies
The AI Copilot feature analyses both ticket messages and internal Teams discussions, providing more informed suggestions based on your team's insights and expertise.
- Access the Copilot
- In the Teams conversation, click the "Reply to ticket" button on the first message
- This opens the AI Copilot interface
- Grant Permissions (First-time or Limited Access)
- If prompted, provide consent for accessing Teams messages:
- "Allow Once" - Grant permission for this session only
- "Always Allow" - Grant permanent access for all team members and future use
- If prompted, provide consent for accessing Teams messages:
- AI Analysis and Suggestion Generation
- The configured AI assistant for the ticket queue processes the request
- If no queue-specific assistant is configured, the default AI assistant is used
- The AI analyses:
- Complete ticket message history
- Internal Teams discussion messages
- Available knowledge base articles and tools
- Review and Refine
- Review the AI-generated reply suggestion and add any additional context or instructions
- Click "Request a New Suggestion" to get an updated response
- Send the Reply
- Review and edit the final suggested reply
- Click "Send Reply to Ticket" to post the response to the customer in the DeskDirector ticket
- Follow Up
- Click "View Ticket" once the reply has been sent to the ticket to open the embedded Tech Portal