Freshdesk
Freshdesk — это облачное решение для поддержки клиентов, которое поможет упростить обслуживание клиентов и убедиться, что клиенты получают поддержку, которую они заслуживают! Соединитель Freshdesk предназначен для агентов Freshdesk для управления билетами и контактами.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Стандарт | Все регионы Power Apps , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Стандарт | Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://freshdesk.com/ |
| Политика конфиденциальности | https://www.freshworks.com/privacy/ |
Известные проблемы и ограничения
- Для триггеров "При создании билета", "При обновлении билета, назначенного агенту", описание билета по умолчанию не возвращается в ответе. Вы можете указать его в ответ триггера, задав параметр Include description (Включить описание) значение "Да". Однако обратите внимание, что это связано с дополнительными затратами на вашу учетную запись на стороне Freshdesk, так как внедрение используется в этом случае. Если вам нужно описание билета, рекомендуется использовать триггер в сочетании с действием "Получить билет", так как ответ этого действия включает описание по умолчанию.
- Создание типа билета "Задача службы" в настоящее время не поддерживается.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| URL-адрес учетной записи | струна | Бывший: https://company.freshdesk.com | True |
| Электронная почта или ключ API (https://aka.ms/ii9u75) | струна | Ваш адрес электронной почты | True |
| Пароль | securestring | Пароль (при использовании ключа API можно указать любое значение) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
| Частота опросов триггеров | 1 | 15 секунд |
Действия
| Добавление заметки в билет |
Добавьте к билету частную или общедоступную заметку. |
| Обновление билета |
Обновите билет (будут обновлены только указанные значения). |
| Получение билета |
Получение билета по идентификатору. |
| Создание билета |
Создайте билет. |
Добавление заметки в билет
Добавьте к билету частную или общедоступную заметку.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор билета
|
ticketId | True | integer |
Идентификатор билета для добавления заметки. |
|
Content
|
body | True | string |
Содержимое заметки. |
|
Частный
|
private | boolean |
Указывает, является ли это частной заметкой (значение по умолчанию — true). |
Возвращаемое значение
- Тело
- AddNote200Response
Обновление билета
Обновите билет (будут обновлены только указанные значения).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор билета
|
ticketId | True | integer |
Идентификатор билета для обновления. |
|
Description
|
description | string |
Описание билета. |
|
|
Тема
|
subject | string |
Тема билета. |
|
|
Priority
|
priority | string |
Приоритет билета. |
|
|
Состояние
|
status | string |
Состояние билета. |
|
|
Тип
|
type | string |
Помогает классифицировать запрос в соответствии с различными типами проблем, с которыми работает ваша группа поддержки. |
|
|
Срок
|
due_by | date-time |
Метка времени, обозначающая, когда билет должен быть разрешен (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
|
Агент
|
responder_id | integer |
Агент билета. |
Возвращаемое значение
Получение билета
Получение билета по идентификатору.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор билета
|
ticketId | True | string |
Идентификатор билета. |
Возвращаемое значение
Создание билета
Создайте билет.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Тема
|
subject | True | string |
Тема билета. |
|
Description
|
description | True | string |
Описание билета. |
|
Адрес электронной почты
|
True | string |
Сообщение электронной почты запрашивающего объекта. |
|
|
Priority
|
priority | True | string |
Приоритет для билета. |
|
Состояние
|
status | True | string |
Состояние билета. |
|
Тип
|
type | string |
Помогает классифицировать запрос в соответствии с различными типами проблем, с которыми работает ваша группа поддержки. |
|
|
Срок
|
due_by | date-time |
Метка времени, обозначающая, когда билет должен быть разрешен (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
|
Первый ответ из-за
|
fr_due_by | date-time |
Метка времени, обозначающая при выполнении первого ответа (в формате yy-MM-ddTHH:mm:ssZ). |
|
|
Агент
|
responder_id | integer |
Агент билета. |
|
|
Продукт
|
product_id | integer |
Продукт, который должен быть частью билета (только для администраторов). |
Возвращаемое значение
Триггеры
| При добавлении агента |
При добавлении агента (только для администраторов). Этот триггер работает только в том случае, если у учетной записи Freshdesk меньше 100 агентов. |
| При добавлении контакта |
При добавлении контакта. Этот триггер работает только в том случае, если у учетной записи Freshdesk меньше 100 контактов. |
| При изменении состояния билета |
При изменении состояния билета. |
| При обновлении билета |
При обновлении билета. |
| При обновлении билета, назначенного агенту |
При обновлении любого билета, назначенного выбранному агенту. |
| При создании билета |
При создании любого билета. |
При добавлении агента
При добавлении агента (только для администраторов). Этот триггер работает только в том случае, если у учетной записи Freshdesk меньше 100 агентов.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Область билета
|
ticket_scope | integer |
Разрешение на запрос агента. |
|
Создано в
|
created_at | date-time |
Метка времени создания агента (в формате гггг-ММ-ддTHH:mm:ssZ). |
|
Обновлено в
|
updated_at | date-time |
Обновленная метка времени агента (в формате гггг-ММ-ддTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Установите значение true, если агент проверен. |
|
Адрес электронной почты
|
contact.email | string |
Адрес электронной почты агента. |
|
Должность
|
contact.job_title | string |
Название задания агента. |
|
Language
|
contact.language | string |
Язык агента. |
|
Последнее имя входа в
|
contact.last_login_at | date-time |
Метка времени последнего успешного входа агента (в формате yyy-MM-ddTHH:mm:ssZ). |
|
мобильное устройство
|
contact.mobile | string |
Номер мобильного устройства агента. |
|
Имя
|
contact.name | string |
Имя агента. |
|
Телефон
|
contact.phone | string |
Номер телефона агента. |
|
Часовой пояс
|
contact.time_zone | string |
Часовой пояс агента. |
|
Создано в
|
contact.created_at | date-time |
Метка времени создания агента (в формате yy-MM-ddTHH:mm:ssZ). |
|
Обновлено в
|
contact.updated_at | date-time |
Метка времени последнего обновления агента (в формате yyy-MM-ddTHH:mm:ssZ). |
При добавлении контакта
При добавлении контакта. Этот триггер работает только в том случае, если у учетной записи Freshdesk меньше 100 контактов.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Active
|
active | boolean |
Установите значение true, если контакт был проверен. |
|
Address
|
address | string |
Адрес контакта. |
|
Идентификатор компании
|
company_id | integer |
Идентификатор компании, к которой принадлежит этот контакт. |
|
Description
|
description | string |
Краткое описание контакта. |
|
Адрес электронной почты
|
string |
Основной адрес электронной почты контакта. |
|
|
Идентификатор
|
id | integer |
Идентификатор контакта. |
|
Должность
|
job_title | string |
Название задания контакта. |
|
Language
|
language | string |
Язык контакта. |
|
мобильное устройство
|
mobile | string |
Номер мобильного телефона контакта. |
|
Имя
|
name | string |
Имя контакта. |
|
Телефон
|
phone | string |
Номер телефона контакта. |
|
Часовой пояс
|
time_zone | string |
Часовой пояс, в котором находится контакт. |
|
Идентификатор Twitter
|
twitter_id | string |
Дескриптор контакта. |
|
Создано в
|
created_at | date-time |
Метка времени создания контакта (в формате гггг-ММ-ддTHH:mm:ssZ). |
|
Обновлено в
|
updated_at | date-time |
Обратитесь в обновленную метку времени (в формате гггг-ММ-ддTHH:mm:ssZ). |
При изменении состояния билета
При изменении состояния билета.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор билета
|
ticketId | True | integer |
Идентификатор билета. |
|
Новое состояние
|
status | string |
Новое состояние билета. |
Возвращаемое значение
При обновлении билета
При обновлении билета.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор билета
|
ticketId | integer |
Идентификатор билета. |
|
|
Описание включения
|
includeDescription | boolean |
Если ответ триггера включает описание. |
Возвращаемое значение
При обновлении билета, назначенного агенту
При обновлении любого билета, назначенного выбранному агенту.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор агента
|
agentId | True | integer |
Идентификатор агента. |
|
Описание включения
|
includeDescription | boolean |
Если ответ триггера включает описание. |
Возвращаемое значение
При создании билета
При создании любого билета.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Описание включения
|
includeDescription | boolean |
Если ответ триггера включает описание. |
Возвращаемое значение
Определения
CreateTicket200Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Спам
|
spam | boolean |
Установите значение true, если билет помечен как спам. |
|
Priority
|
priority | string |
Приоритет билета. |
|
Идентификатор запрашивающего объекта
|
requester_id | integer |
Идентификатор пользователя запрашивающего средства. |
|
Идентификатор агента
|
responder_id | integer |
Идентификатор агента, которому назначен билет. |
|
Исходный материал
|
source | string |
Канал, через который был создан билет. |
|
Состояние
|
status | string |
Состояние билета. |
|
Тема
|
subject | string |
Тема билета. |
|
Идентификатор билета
|
id | integer |
Уникальный идентификатор билета. |
|
Тип
|
type | string |
Помогает классифицировать запрос в соответствии с различными типами проблем, с которыми работает ваша группа поддержки. |
|
Срок
|
due_by | date-time |
Метка времени, обозначающая, когда билет должен быть разрешен (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
Эскалировано
|
is_escalated | boolean |
Установите значение true, если билет был перемещен по какой-либо причине. |
|
Description
|
description | string |
HTML-содержимое билета. |
|
Текст описания
|
description_text | string |
Содержимое билета в виде обычного текста. |
|
Создано в
|
created_at | date-time |
Метка времени создания билета (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
Обновлено в
|
updated_at | date-time |
Обновленная метка времени (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
Удалено
|
deleted | boolean |
Установите значение true, если билет был удален. |
AddNote200Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Частный
|
private | boolean |
Задайте значение true, если заметка является частной. |
|
Content
|
body | string |
Содержимое заметки в HTML. |
|
Текст содержимого
|
body_text | string |
Содержимое заметки в виде обычного текста. |
|
Идентификатор билета
|
ticket_id | integer |
Идентификатор билета, к которому добавляется эта заметка. |
|
Создано в
|
created_at | date-time |
Метка времени создания заметок (в формате гггг-ММ-ддTHH:мм:ssZ). |
|
Обновление по адресу
|
updated_at | date-time |
Обратите внимание на обновленную метку времени (в формате гггг-ММ-ддTHH:мм:ssZ). |