Соединитель Usedesk
Синхронизируйте тикеты поддержки и данные клиентов из Usedesk в базу знаний
Соединитель Usedesk синхронизирует тикеты поддержки, информацию о клиентах и данные компаний из Usedesk в базу знаний. Каждый тикет преобразуется в документ, содержащий тему, статус, сообщения и детали клиента.
Аутентификация
OAuth 2.0 — требуется:
tickets:read— Читать тикеты и комментарииcontacts:read— Читать данные клиентов и компаний
Конфигурация
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| Компания | Селектор | Да | Выберите аккаунт компании Usedesk |
| Включить сообщения | Переключатель | Нет | Включить полные цепочки сообщений в документы |
| Фильтр статуса | Выпадающее меню | Нет | Фильтровать по статусу (открыто/закрыто/ожидание) |
| Макс. тикетов | Ввод | Нет | Ограничить количество синхронизируемых тикетов |
Как это работает
- Валидация компании — Проверяет доступ OAuth к выбранной компании
- Получение тикетов — Извлекает тикеты с разбиением на страницы (50 на странице)
- Получение сообщений — Опционально получает полную историю разговоров
- Генерация документов — Каждый тикет становится поисковым документом
Формат документа
ID тикета: #1234
Тема: Не могу войти
Клиент: Jane Smith (jane@company.com)
Статус: Открыто
Приоритет: Высокий
Сообщений: 5Теги метаданных
| Тег | Тип | Описание |
|---|---|---|
| ID тикета | Текст | Номер тикета Usedesk |
| Статус тикета | Категория | открыто, закрыто или ожидание |
| Приоритет | Категория | Низкий, Нормальный, Высокий, Срочный |
Разбиение на страницы
Использует смещение ID тикета. Формат курсора: offset:{ticket_id}.
Ограничения
- Синхронизация сообщений ограничена 1000 символами на тикет
- Компания должна быть доступна через токен OAuth
- Архивные тикеты не включаются по умолчанию