Зендеск

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

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

Услуга 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
Поддержка Power Automate Microsoft
Поддержка Power Apps Microsoft
Метаданные соединителя
Publisher Microsoft
Website https://www.zendesk.com/
Политика конфиденциальности https://www.zendesk.com/company/customers-partners/privacy-policy/

Известные проблемы и ограничения

  1. Соединитель возвращает только атомарные свойства сущности Zendesk (например, списки, записи и другие сложные типы не поддерживаются). Например, сущность имеет Ticket свойство, tags представленное массивом на стороне Zendesk. Соединитель Zendesk возвращает [List] строку для таких полей.
  2. Соединитель требует updated_at , чтобы столбец существовал для любой таблицы, используемой с триггерами.
  3. API поиска Zendesk имеет ограничение на возврат 1000 результатов для каждого запроса. Это влияет на некоторые действия соединителя, которые завершаются ошибкой ("Сбой http-запроса: содержимое не было допустимым JSON"), если целевая таблица содержит 1000 записей или более:
  4. Триггер изменения элемента может возникать при создании нового билета. Так как Zendesk обновляет билет во время создания, триггер измененного билета может срабатывать вскоре после создания элемента для того же билета.

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

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

По умолчанию

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

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

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

Имя Тип Description Обязательно
Название компании струна Имя компании Zendesk — это часть поддомена URL-адреса сайта. Например, https://{company}.zendesk.com True

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

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

Действия

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

Обновляет существующий элемент Zendesk
Поиск статей

Возвращает значение по умолчанию 25 статей на страницу до 1000 результатов.
Получение таблиц

Извлекает таблицы Zendesk из сайта
Получение элемента

Извлекает элемент Zendesk
Получение элементов

Извлекает элементы Zendesk определенного типа Zendesk (например, "Билет" )
Создание элемента

Создает элемент Zendesk
Удаление элемента

Удаляет элемент Zendesk

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

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

Обновляет существующий элемент Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Тип элемента Zendesk (например: "Ticket")
Ключ элемента
 id True string

Уникальный идентификатор элемента для обновления
Item
 item True dynamic

Элемент Zendesk с обновленными значениями

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

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

Поиск статей

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

Возвращает значение по умолчанию 25 статей на страницу до 1000 результатов.

Параметры

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

Статья для поиска.
Региональные настройки
 locale string

Языковой стандарт, в котором отображается элемент
Идентификатор бренда
 brand_id integer

Найдите статьи в указанном бренде.
Категория
 category integer

Ограничить поиск идентификатором этой категории.
Секция
 section integer

Ограничить поиск идентификатором этого раздела
Имена меток
 label_names string

Разделенный запятыми список имен меток.
Multibrand
 multibrand boolean

Включите поиск по всем брендам, если верно.

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

Тело
SearchResult

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

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

Извлекает таблицы Zendesk из сайта

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

Тело
TablesList

Получение элемента

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

Извлекает элемент Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Тип элемента Zendesk (например: "Ticket")
Ключ элемента
 id True string

Уникальный идентификатор извлекаемого элемента

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

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

Получение элементов

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

Извлекает элементы Zendesk определенного типа Zendesk (например, "Билет" )

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Тип элемента Zendesk (например: "Ticket")
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по
 $orderby string

Запрос порядка ODATA Для указания порядка записей
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0)
Максимальное число получения
 $top integer

Максимальное количество записей для получения (по умолчанию = 512)
Выбор запроса
 $select string

Определенные поля для извлечения из записей (по умолчанию = все).

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

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

Создание элемента

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

Создает элемент Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Тип элемента Zendesk (например: "Ticket")
Item
 item True dynamic

Элемент Zendesk для создания

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

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

Удаление элемента

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

Удаляет элемент Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Тип элемента Zendesk (например: "Ticket")
Ключ элемента
 id True string

Уникальный идентификатор элемента для удаления

Триггеры

При изменении элемента

Активирует поток при изменении элемента в Zendesk
При изменении элемента

Активирует поток при изменении элемента в Zendesk
При создании элемента

Активирует поток при создании элемента в Zendesk

При изменении элемента

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

Активирует поток при изменении элемента в Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы Zendesk
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по
 $orderby string

Запрос порядка ODATA Для указания порядка записей
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0)
Максимальное число получения
 $top integer

Максимальное количество записей для получения (по умолчанию = 512)

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

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

При изменении элемента

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

Активирует поток при изменении элемента в Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы Zendesk
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по
 $orderby string

Запрос порядка ODATA Для указания порядка записей
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0)
Максимальное число получения
 $top integer

Максимальное количество записей для получения (по умолчанию = 512)

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

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

При создании элемента

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

Активирует поток при создании элемента в Zendesk

Параметры

Имя Ключ Обязательно Тип Описание
Имя таблицы
 table True string

Имя таблицы Zendesk
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123).
Заказ по
 $orderby string

Запрос порядка ODATA Для указания порядка записей
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0)
Максимальное число получения
 $top integer

Максимальное количество записей для получения (по умолчанию = 512)

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

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

Определения

Таблица

Имя Путь Тип Описание
Имя
 Name string
Отображаемое имя
 DisplayName string

SearchResult

Имя Путь Тип Описание
results
 results array of object
id
 results.id integer

Автоматически назначаемый идентификатор статьи
URL-адрес
 results.url string

URL-адрес API статьи
html_url
 results.html_url string

URL-адрес статьи в Центре справки
author_id
 results.author_id integer

Идентификатор автора
comments_disabled
 results.comments_disabled boolean

Значение True, если примечания отключены; False в противном случае
draft
 results.draft boolean

Значение True, если перевод текущего языкового стандарта является черновиком
Способствовало
 results.promoted boolean

Значение true, если эта статья повышена; False в противном случае. False по умолчанию
позиция
 results.position integer

Позиция этой статьи в списке статей. Значение 0 по умолчанию
vote_sum
 results.vote_sum integer

Сумма upvote (+1) и downvote (-1), которые могут быть положительными или отрицательными
vote_count
 results.vote_count integer

Общее количество upvote и downvotes
section_id
 results.section_id integer

Идентификатор раздела, к которому принадлежит эта статья
создано_в
 results.created_at date-time

Время создания статьи
updated_at
 results.updated_at date-time

Время последнего обновления статьи
имя
 results.name string

Имя статьи
title
 results.title string

Название статьи
source_locale
 results.source_locale string

Исходный языковой стандарт (по умолчанию) статьи
местность
 results.locale string

Языковой стандарт, в котором отображается статья
устаревший
 results.outdated boolean

Deprecated
outdated_locales
 results.outdated_locales array of string

Языковые стандарта, в которых статья была помечена как устаревшая
edited_at
 results.edited_at date-time

Время последнего редактирования статьи в отображаемом языковом стандарте
user_segment_id
 results.user_segment_id integer

Идентификатор сегмента пользователя, который определяет, кто может видеть эту статью.
permission_group_id
 results.permission_group_id integer

Идентификатор группы разрешений, которая определяет, кто может редактировать и публиковать эту статью.
content_tag_ids
 results.content_tag_ids array of string

Список тегов контента, присоединенных к статье
label_names
 results.label_names array of string

Массив имен меток, связанных с этой статьей
body
 results.body string

ТЕКСТ HTML статьи
обрезок
 results.snippet string

Html-фрагмент статьи
result_type
 results.result_type string

Тип результата

TablesList

Имя Путь Тип Описание
value
 value array of Table