DeskDirector
DeskDirector automates and accelerates ticket-based workflows between Users and Techs working IT services. The DeskDirector connector is a deep and powerful integration into our rich ticketing platform. All phases of a ticket’s life cycle can be automated and enhanced for superior service experience.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | DeskDirector Support |
URL | https://support.deskdirector.com |
support@deskdirector.com |
Connector Metadata | |
---|---|
Publisher | DeskDirector Limited |
Website | https://www.deskdirector.com |
Privacy policy | https://www.deskdirector.com/privacy-policy |
Categories | IT Operations;Productivity |
DeskDirector is a user centered, cloud-based ticketing system for I.T. support and general service management. DeskDirector is extremely configurable out-of-the box. But when you want even more service options, you can extend DeskDirector’s great service functionality and service reach, with this extensively featured connector.
Prerequisites
You will need an active DeskDirector subscription with flow connector feature in order to use the DeskDirector Connector, you can read about our pricing here.
How to get credentials
When setting up a new connection, you will be asked to provide an API key, the key can be generated or retrived from your admin portal, see documentation here.
Get started with your connector
Read our step-by-step guide on getting started with the DeskDirector connector here.
FAQ
Read the FAQ from our knowledge base here.
Creating a connection
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Name | Type | Description | Required |
---|---|---|---|
Site Host | string | Root site URL (Example: support.deskdirector.com) | True |
API Key | securestring | DeskDirector API Key | True |
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Actions
Create a contact |
This operation creates a contact. |
Create a ticket |
This operation creates a ticket. |
Create an email from template |
This operation generates an HTML document from a dynamic email template. Dynamic email templates can be managed in your admin portal. |
Create ticket tasks |
This operation creates ticket tasks from templates or scratch. |
Find companies |
Find companies by keywords or filters. |
Find contacts |
Find contacts by keywords or filters. |
Find members |
Find members by keywords or filters. |
Find ticket task templates |
Find ticket task templates by keywords or filters. |
Find tickets |
Find tickets by keywords or filters. |
Find user groups |
Find user groups by keywords or filters. |
Get a chat session |
This operation return a chat session's details. |
Get a company |
This operation returns a company's details. |
Get a contact |
This operation returns a contact's details. |
Get a form result |
This operation returns the form entry by the form result ID. |
Get a form result V2 (Preview) |
This operation returns the form entry by the form result ID. |
Get a member |
This operation returns a member's details. |
Get a ticket |
This operation returns a ticket's details. |
Get ticket tasks |
This operation return all ticket task lists. |
Invite users to chat |
This operation invites users to a chat session. |
Respond to an Advanced Event |
Respond to an Advanced Event. |
Run an advanced action |
An advanced action is an Azure Function provides some extra functionalities for the connector. |
Send a notification to a contact |
This operation sends a notification to a contact in the client portal. |
Send a notification to a member |
This operation sends a notification to a member in the tech portal. |
Send a system message in chat |
This operation sends a system message in a chat session. |
Update a ticket |
This operation updates a ticket. |
Create a contact
This operation creates a contact.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Create a ticket
This operation creates a ticket.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Request Type
|
requestTypeId | True | integer |
Specify the request type. |
req
|
req | True | dynamic |
Returns
Create an email from template
This operation generates an HTML document from a dynamic email template. Dynamic email templates can be managed in your admin portal.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Template
|
emailTemplateId | True | string |
Specify the email template. |
req
|
req | True | dynamic |
Returns
Create ticket tasks
This operation creates ticket tasks from templates or scratch.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Ticket
|
ticketId | True | integer |
Specify the ID of the ticket. |
req
|
req | True | dynamic |
Returns
Find companies
Find companies by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Find contacts
Find contacts by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Find members
Find members by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Find ticket task templates
Find ticket task templates by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Find tickets
Find tickets by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Find user groups
Find user groups by keywords or filters.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic |
Returns
Get a chat session
This operation return a chat session's details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Session
|
sessionId | True | string |
Specify the chat session ID. |
Returns
Get a company
This operation returns a company's details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Company ID
|
companyId | True | integer |
Specify the company's ID. |
Returns
Get a contact
This operation returns a contact's details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contact ID
|
contactId | True | integer |
Specify the contact's ID. |
Returns
Get a form result
This operation returns the form entry by the form result ID.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Form
|
formId | True | integer |
Specify the form. |
Result
|
resultId | True | integer |
Specify the result ID. |
Returns
Get a form result V2 (Preview)
This operation returns the form entry by the form result ID.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Form
|
formId | True | integer |
Specify the form. |
Result
|
resultId | True | integer |
Specify the result ID. |
Returns
Get a member
This operation returns a member's details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Member ID
|
memberId | True | integer |
Specify the member's ID. |
Returns
Get a ticket
This operation returns a ticket's details.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Ticket
|
ticketId | True | integer |
Specify the ID of the ticket. |
Returns
Get ticket tasks
This operation return all ticket task lists.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Ticket
|
ticketId | True | integer |
Specify the ID of the ticket. |
Returns
Invite users to chat
This operation invites users to a chat session.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Session
|
sessionId | True | string |
Specify the chat session ID. |
req
|
req | True | dynamic |
Returns
- response
- object
Respond to an Advanced Event
Respond to an Advanced Event.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Category
|
category | True | string |
Select a event category from the list. |
Event
|
eventType | True | string |
Select an event from the list. |
Event ID
|
eventId | True | string |
Specify the event ID. |
req
|
req | True | dynamic |
Returns
- response
- object
Run an advanced action
An advanced action is an Azure Function provides some extra functionalities for the connector.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Category
|
category | True | string |
Select a action category from the list. |
Action
|
function | True | string |
Select an action from the list. |
req
|
req | True | dynamic |
Returns
Send a notification to a contact
This operation sends a notification to a contact in the client portal.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Contact ID
|
contactId | True | integer |
Specify the contact's ID |
req
|
req | True | dynamic |
Returns
Send a notification to a member
This operation sends a notification to a member in the tech portal.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Member ID
|
memberId | True | integer |
Specify the member's ID |
req
|
req | True | dynamic |
Returns
Send a system message in chat
This operation sends a system message in a chat session.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Session
|
sessionId | True | string |
Specify the chat session ID. |
req
|
req | True | dynamic |
Returns
- response
- object
Update a ticket
This operation updates a ticket.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
req
|
req | True | dynamic | |
Ticket
|
ticketId | True | integer |
Specify the ID of the ticket. |
Returns
Triggers
When a chat session is created or updated |
This operation triggers when a chat is created or updated. |
When a ticket is created or updated |
This operation triggers when a ticket is created or updated. |
When a workflow is triggered |
This operation triggers when the specified workflow is triggered. Workflows can be managed in your admin portal. |
When an Advanced Event occurred |
Use this trigger and the 'Respond to an Advanced Event' to handle an Advanced Event. |
When a chat session is created or updated
This operation triggers when a chat is created or updated.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Event
|
type | True | string |
Specify the type of event to subscribe to. |
req
|
req | True | dynamic |
Returns
When a ticket is created or updated
This operation triggers when a ticket is created or updated.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Event
|
type | True | string |
Specify the type of event to subscribe to. |
req
|
req | True | dynamic |
Returns
When a workflow is triggered
This operation triggers when the specified workflow is triggered. Workflows can be managed in your admin portal.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Type
|
type | True | string |
Specify the type of the workflow |
Workflow
|
workflowId | True | string |
Specify the workflow |
req
|
req | True | dynamic |
Returns
When an Advanced Event occurred
Use this trigger and the 'Respond to an Advanced Event' to handle an Advanced Event.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Category
|
category | True | string |
Select a event category from the list. |
Event
|
eventType | True | string |
Select an event from the list. |
req
|
req | True | dynamic |
Returns
Definitions
object
This is the type 'object'.