DeskDirector

DeskDirector автоматизирует и ускоряет рабочие процессы на основе билетов между пользователями и технологиями, работающими ИТ-службами. Соединитель DeskDirector — это глубокая и мощная интеграция с нашей богатой платформой билетов. Все этапы жизненного цикла билета могут быть автоматизированы и улучшены для повышения качества обслуживания.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Поддержка DeskDirector
URL	https://support.deskdirector.com
Адрес электронной почты	support@deskdirector.com

Метаданные соединителя
Publisher	DeskDirector
Веб-сайт	https://www.deskdirector.com
Политика конфиденциальности	https://www.deskdirector.com/privacy-policy
Категории	ИТ-операции; Продуктивность

DeskDirector — это облачная система для поддержки I.T. и общего управления службами. DeskDirector чрезвычайно настраивается вне коробки. Но если требуется еще больше возможностей службы, вы можете расширить функциональные возможности и возможности службы DeskDirector, используя этот расширенный соединитель.

Предпосылки

Вам потребуется активная подписка DeskDirector с функцией соединителя потока, чтобы использовать соединитель DeskDirector, вы можете ознакомиться с нашими ценами здесь.

Получение учетных данных

При настройке нового подключения вам будет предложено предоставить ключ API, его можно создать или извлечь на портале администрирования, см. здесь документацию.

Начало работы с соединителем

Ознакомьтесь с нашим пошаговые руководства по началу работы с соединителем DeskDirector здесь.

Часто задаваемые вопросы

Ознакомьтесь с часто задаваемыми вопросами из нашей базы знаний.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Узел сайта	струна	URL-адрес корневого сайта (пример: support.deskdirector.com)	True
Ключ API	securestring	Ключ API DeskDirector	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Выполнение расширенного действия	Расширенные действия позволяют автоматизировать специализированные операции, которые реже используются, но обеспечивают ценные функциональные возможности для упрощения задач.
Обновление билета	Эта операция обновляет билет.
Отправка системного сообщения в чате	Эта операция отправляет системное сообщение в сеансе чата.
Отправка уведомления контакту	Эта операция отправляет уведомление контакту на клиентском портале.
Отправка уведомления участнику	Эта операция отправляет уведомление участнику на техническом портале.
Поиск билетов	Поиск билетов по ключевым словам или фильтрам.
Поиск групп пользователей	Поиск групп пользователей по ключевым словам или фильтрам.
Поиск компаний	Поиск компаний по ключевым словам или фильтрам.
Поиск контактов	Поиск контактов по ключевым словам или фильтрам.
Поиск участников	Поиск элементов по ключевым словам или фильтрам.
Поиск шаблонов задач билета	Поиск шаблонов задач билетов по ключевым словам или фильтрам.
Получение билета	Эта операция возвращает сведения о билете.
Получение задач по запросу	Эта операция возвращает все списки задач билетов.
Получение компании	Эта операция возвращает сведения о компании.
Получение контакта	Эта операция возвращает сведения о контакте.
Получение результата формы	Эта операция возвращает запись формы по идентификатору результата формы.
Получение результата формы (не рекомендуется) [DEPRECATED]	Это действие устарело. Вместо этого используйте результат получения формы . ~~Эта операция возвращает запись формы идентификатором результата формы (не рекомендуется).~~
Получение сеанса чата	Эта операция возвращает сведения о сеансе чата.
Получение члена	Эта операция возвращает сведения о члене.
Приглашение пользователей в чат	Эта операция приглашает пользователей в сеанс чата.
Реагирование на дополнительное событие	Ответ на дополнительное событие.
Создание билета	Эта операция создает билет.
Создание задач по запросу	Эта операция создает задачи билета из шаблонов или с нуля.
Создание контакта	Эта операция создает контакт.
Создание сообщения электронной почты из шаблона	Эта операция создает HTML-документ из динамического шаблона электронной почты. Динамические шаблоны электронной почты можно управлять на портале администрирования.

Выполнение расширенного действия

Идентификатор операции:: CallAdvancedAction

Расширенные действия позволяют автоматизировать специализированные операции, которые реже используются, но обеспечивают ценные функциональные возможности для упрощения задач.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Категория	category	True	string	Выберите категорию действий из списка.
Действие	function	True	string	Выберите действие из списка.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Обновление билета

Идентификатор операции:: UpdateTicket

Эта операция обновляет билет.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic
Билет	ticketId	True	integer	Укажите идентификатор билета.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Отправка системного сообщения в чате

Идентификатор операции:: AddChatSystemMessage

Эта операция отправляет системное сообщение в сеансе чата.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Session	sessionId	True	string	Укажите идентификатор сеанса чата.
req	req	True	dynamic

Возвращаемое значение

response: object

Отправка уведомления контакту

Идентификатор операции:: CreateContactNotification

Эта операция отправляет уведомление контакту на клиентском портале.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Код контактного лица	contactId	True	integer	Укажите идентификатор контакта
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Отправка уведомления участнику

Идентификатор операции:: CreateMemberNotification

Эта операция отправляет уведомление участнику на техническом портале.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор члена	memberId	True	integer	Укажите идентификатор участника
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск билетов

Идентификатор операции:: FindTickets

Поиск билетов по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск групп пользователей

Идентификатор операции:: FindUserGroups

Поиск групп пользователей по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск компаний

Идентификатор операции:: FindCompanies

Поиск компаний по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск контактов

Идентификатор операции:: FindContacts

Поиск контактов по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск участников

Идентификатор операции:: FindMembers

Поиск элементов по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Поиск шаблонов задач билета

Идентификатор операции:: FindTicketTaskTemplates

Поиск шаблонов задач билетов по ключевым словам или фильтрам.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение билета

Идентификатор операции:: GetTicket

Эта операция возвращает сведения о билете.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Билет	ticketId	True	integer	Укажите идентификатор билета.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение задач по запросу

Идентификатор операции:: GetTicketTasks

Эта операция возвращает все списки задач билетов.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Билет	ticketId	True	integer	Укажите идентификатор билета.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение компании

Идентификатор операции:: GetCompany

Эта операция возвращает сведения о компании.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор компании	companyId	True	integer	Укажите идентификатор компании.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение контакта

Идентификатор операции:: GetContact

Эта операция возвращает сведения о контакте.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Код контактного лица	contactId	True	integer	Укажите идентификатор контакта.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение результата формы

Идентификатор операции:: GetFormResult_V2

Эта операция возвращает запись формы по идентификатору результата формы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Form	formId	True	integer	Укажите форму.
Result	resultId	True	integer	Укажите идентификатор результата.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение результата формы (не рекомендуется) [DEPRECATED]

Идентификатор операции:: GetFormResult

Это действие устарело. Вместо этого используйте результат получения формы .

~~Эта операция возвращает запись формы идентификатором результата формы (не рекомендуется).~~

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Form	formId	True	integer	Укажите форму.
Result	resultId	True	integer	Укажите идентификатор результата.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение сеанса чата

Идентификатор операции:: GetChatSession

Эта операция возвращает сведения о сеансе чата.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Session	sessionId	True	string	Укажите идентификатор сеанса чата.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение члена

Идентификатор операции:: GetMember

Эта операция возвращает сведения о члене.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор члена	memberId	True	integer	Укажите идентификатор участника.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Приглашение пользователей в чат

Идентификатор операции:: InviteUsersToChat

Эта операция приглашает пользователей в сеанс чата.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Session	sessionId	True	string	Укажите идентификатор сеанса чата.
req	req	True	dynamic

Возвращаемое значение

response: object

Реагирование на дополнительное событие

Идентификатор операции:: AdvancedEventResponseHandle

Ответ на дополнительное событие.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Категория	category	True	string	Выберите категорию событий из списка.
Event	eventType	True	string	Выберите событие в списке.
Идентификатор события	eventId	True	string	Укажите идентификатор события.
req	req	True	dynamic

Возвращаемое значение

response: object

Создание билета

Идентификатор операции:: CreateTicket

Эта операция создает билет.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип запроса	requestTypeId	True	integer	Укажите тип запроса.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Создание задач по запросу

Идентификатор операции:: CreateTicketTasks

Эта операция создает задачи билета из шаблонов или с нуля.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Билет	ticketId	True	integer	Укажите идентификатор билета.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Создание контакта

Идентификатор операции:: CreateContact

Эта операция создает контакт.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Создание сообщения электронной почты из шаблона

Идентификатор операции:: GenerateEmailFromTemplate

Эта операция создает HTML-документ из динамического шаблона электронной почты. Динамические шаблоны электронной почты можно управлять на портале администрирования.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Template	emailTemplateId	True	string	Укажите шаблон электронной почты.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Триггеры

Когда произошло дополнительное событие	Расширенные события — это специализированные триггеры, которые происходят реже, но предоставляют ценные функциональные возможности для автоматического запуска рабочих процессов в ответ на определенные условия.
При активации рабочего процесса	Эта операция активируется при активации указанного рабочего процесса. Рабочие процессы можно управлять на портале администрирования.
При создании или обновлении билета	Эта операция активируется при создании или обновлении билета.
При создании или обновлении сеанса чата	Эта операция активируется при создании или обновлении чата.

Когда произошло дополнительное событие

Идентификатор операции:: AdvancedEventSubscribe

Расширенные события — это специализированные триггеры, которые происходят реже, но предоставляют ценные функциональные возможности для автоматического запуска рабочих процессов в ответ на определенные условия.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Категория	category	True	string	Выберите категорию событий из списка.
Event	eventType	True	string	Выберите событие в списке.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При активации рабочего процесса

Идентификатор операции:: SubscribeToWorkflow

Эта операция активируется при активации указанного рабочего процесса. Рабочие процессы можно управлять на портале администрирования.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Тип	type	True	string	Укажите тип рабочего процесса
Рабочий процесс	workflowId	True	string	Указание рабочего процесса
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При создании или обновлении билета

Идентификатор операции:: CreateTicketWorkflow

Эта операция активируется при создании или обновлении билета.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Event	type	True	string	Укажите тип события для подписки.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При создании или обновлении сеанса чата

Идентификатор операции:: CreateChatWebhook

Эта операция активируется при создании или обновлении чата.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Event	type	True	string	Укажите тип события для подписки.
req	req	True	dynamic

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Определения

объект

Это тип object.