Документация / База знаний / Быстрый старт

Что такое TG Desk

Книга «Быстрый старт» Обновлено 3 минуты назад 5 минут чтения

TG Desk — это саппорт-инструмент, который превращает Telegram в полноценный пульт операторов. Запросы клиентов поступают через виджет на сайте или брендированный Telegram-бот, а попадают они в обычную Telegram-супергруппу — каждое обращение становится отдельным forum-топиком.

Главная идея: оператор не уходит из Telegram. Никаких отдельных кабинетов, отдельных паролей, отдельных вкладок в браузере. Всё — там, где команда уже сидит.

Из чего состоит продукт

Виджет на сайте

Лёгкий (≤ 50 КБ gzip) Preact-виджет в Shadow DOM. Подключается одним тегом <script>. Изоляция стилей гарантирована — ваш сайт не сломает виджет, виджет не сломает сайт.

Telegram desk (супергруппа)

Любая группа в Telegram, где наш бот — админ с правом «Управлять темами». Каждый новый диалог = новый forum-топик. Под топиком inline-кнопки: Take, Close, Spam.

Веб-админка

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

База знаний (опционально)

Help-центр на собственном домене компании. Редактор TipTap, версионность, рич-карточки в виджете при ссылке на статью.

Почему именно Telegram

Альтернативные саппорт-платформы заставляют операторов работать в собственных интерфейсах: открывать кабинет, проверять очередь, отвечать через специальную кнопку. На практике это означает контекст-свитч и пропущенные сообщения.

В TG Desk оператор получает уведомление туда же, куда приходят рабочие сообщения от коллег. Контекст не теряется, нотификации не пропускаются, а интерфейс операторам уже знаком — это просто Telegram.

Это не «интеграция с Telegram». Это продукт, написанный вокруг Telegram как основного интерфейса. Веб-админка нужна только администраторам и только для настройки.

Как устроены данные

Каждая компания — это Project. Внутри проекта живут:

Поток типичного обращения

  1. Клиент пишет в виджет на вашем сайте.
  2. На сервере создаётся Conversation со статусом new.
  3. Бот создаёт forum-топик в супергруппе и публикует первое сообщение.
  4. Под топиком появляются inline-кнопки. Свободный оператор нажимает Take.
  5. Атомарный SQL-захват — победитель попадает в `assignedAgentId`, остальные видят «уже взял @ivan».
  6. Оператор отвечает в топик. Сообщение зеркалится в виджет на сайте, клиент видит ответ.
  7. Когда диалог решён — нажимает Close. Топик блокируется, клиент получает уведомление.

Что дальше

Готовы начать? Следующая статья — «Регистрация компании». Или сразу к практике: