Учебник по экспорту диалогов Telegram Bot в Google Sheets: создание простой панели операционной аналитики

При управлении службой поддержки Telegram Bot данные диалогов разбросаны по бэкенду бота, группам Telegram и личным чатам членов команды, что затрудняет формирование общей картины. Экспорт данных поддержки Telegram Bot в Google Sheets позволяет быстро создать легковесную панель операционной аналитики, помогающую отслеживать источники пользователей, тренды количества диалогов и эффективность операторов. В этой статье на примере TG-Staff подробно описан полный процесс от атрибуции трафика до построения отчетов, подходящий для команд B2B SaaS, Web3 и кросс-граничных команд.

Зачем экспортировать данные поддержки Telegram Bot в Google Sheets?

Типичные проблемы панели операционной аналитики

• Фрагментация данных: источники пользователей (реклама, сообщества, сайт) и записи диалогов разбросаны по разным местам, что не позволяет единообразно анализировать воронку конверсии.
• Избыточность инструментов отчетности: CRM или BI-инструменты имеют высокий порог входа и сложны в обслуживании для малых команд, в то время как большинству нужно отслеживать лишь несколько ключевых метрик.
• Низкая эффективность ручной статистики: ежедневный подсчет сообщений и времени ответа отнимает много времени и чреват ошибками.

Преимущества Google Sheets как легковесного инструмента отчетности

• Нулевая стоимость: требуется только аккаунт Google, без дополнительных затрат.
• Высокая гибкость: поддержка функций QUERY, FILTER, PIVOT и диаграмм для быстрого построения трендов и круговых диаграмм.
• Совместная работа: члены команды могут одновременно редактировать, подходит для удаленных команд.
• Потенциал автоматизации: с помощью Google Apps Script можно периодически получать данные, обеспечивая почти реальное время обновления.

Предварительная подготовка: какие инструменты и разрешения нужны?

Перед началом убедитесь, что выполнены следующие условия:

• Учетная запись TG-Staff Console: регистрация по адресу app.tg-staff.com, бесплатный пробный период 3 дня.
• Подключенный проект Telegram Bot: хотя бы один бот настроен и запущен через TG-Staff.
• Аккаунт Google: для доступа к Google Sheets.
• Подтверждение тарифа: тариф Standard и выше поддерживает экспорт диверсионных ссылок и диалогов (бесплатный пробный период позволяет экспортировать базовые данные).
• (Опционально) Диверсионные ссылки: для атрибуции трафика требуется тариф Standard.

Шаг 1: Захват данных об источнике пользователя с помощью диверсионных ссылок

Диверсионная ссылка (Diversion Link) — это официальная короткая ссылка домена TG-Staff (например, https://app.tg-staff.com/{code}), которая при клике пользователя перенаправляет его в ваш Telegram Bot и одновременно захватывает следующую информацию:

• IP-адрес посетителя
• User-Agent браузера
• Параметры URL (например, utm_source, campaign, medium)

Порядок действий:

1. Войдите в консоль TG-Staff, перейдите в раздел «Диверсионные ссылки».
2. Нажмите «Создать диверсионную ссылку», выберите целевой проект бота.
3. В разделе «Параметры URL» добавьте параметры отслеживания, например:
   • utm_source=twitter
   • utm_campaign=product_launch
4. Вставьте сгенерированную короткую ссылку в рекламные объявления, посты в соцсетях или кнопки на сайте.
5. После клика пользователь переходит в бота и начинает диалог с поддержкой; данные об источнике автоматически записываются в детали диалога.

Диверсионные ссылки — ключевой инструмент атрибуции трафика. При последующем экспорте в Google Sheets эти поля будут отображаться как отдельные столбцы, помогая анализировать эффективность различных каналов.

Шаг 2: Настройка правил маршрутизации сессий для обеспечения целостности данных

Правила маршрутизации сессий определяют, как сообщения пользователей распределяются между агентами. Если правила настроены неправильно, некоторые сессии могут быть не записаны (например, потеря сообщений, когда все агенты офлайн), что повлияет на полноту экспортируемых данных.

Рекомендуемая конфигурация:

• Правила маршрутизации на уровне проекта: выберите режим «Онлайн в первую очередь». Когда есть онлайн-агенты, сессии сначала назначаются им; если все офлайн, происходит откат к «Поочередному распределению», чтобы каждая сессия была принята агентом.
• Диапазон агентов: если в команде несколько человек, рекомендуется выбрать «Все агенты», чтобы новые сессии не были пропущены.
• Обработка тайм-аута: установите разумное время ожидания ответа агента (например, 5 минут), после которого сессия автоматически переназначается.

После такой настройки TG-Staff будет создавать полные записи для каждой сессии, включая записи о назначении, историю передачи и временные метки сообщений, что исключит пропуски при экспорте.

Шаг 3: Экспорт записей сессий и данных профилей пользователей

Экспорт через консоль

1. В консоли TG-Staff перейдите в модуль «Сессии» или «Экспорт данных».
2. Выберите период для экспорта (например, последние 30 дней).
3. Нажмите «Экспорт CSV», система сгенерирует файл со следующими полями:

Поле	Описание	Ограничения тарифа
ID сессии	Уникальный идентификатор	Все тарифы
Telegram ID пользователя	Уникальный идентификатор пользователя	Все тарифы
Время начала/окончания сессии	С точностью до секунды	Все тарифы
Общее количество сообщений	Сумма сообщений обеих сторон	Все тарифы
Назначенный агент	Имя агента, обработавшего сессию	Все тарифы
URL-параметры источника	Например, utm_source, campaign	Стандартный и выше
Теги пользователя	Теги, добавленные агентом вручную	Профессиональный
Оценка активности	Показатель вовлеченности пользователя	Профессиональный

Экспорт через API (подходит для технических команд)

TG-Staff предоставляет API-интерфейс для программного извлечения данных сессий. Подходит для команд, которым нужна регулярная автоматическая синхронизация.

// 示例：使用 fetch 调用 API 获取会话列表
fetch('https://api.tg-staff.com/v1/conversations?limit=100', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(res => res.json())
.then(data => console.log(data));

API возвращает данные в формате JSON, которые можно напрямую разобрать с помощью Google Apps Script и записать в Sheets.

Шаг 4: Импорт данных в Google Sheets и очистка

1. Откройте Google Sheets и создайте новый лист.
2. Выберите «Файл» → «Импорт» → «Загрузить» и выберите ранее экспортированный CSV-файл.
3. После импорта выполните очистку данных:

Часто используемые операции очистки:

• Удаление дубликатов: используйте =UNIQUE(A:A) для удаления повторяющихся ID сессий.
• Форматирование временных меток: если временные метки в формате Unix, используйте =TEXT(A2/86400 + DATE(1970,1,1), "yyyy-mm-dd hh:mm:ss") для преобразования.
• Извлечение даты: используйте =DATE(YEAR(B2), MONTH(B2), DAY(B2)) для извлечения даты сессии для статистики по дням.
• Классификация источников: если в параметрах ссылки маршрутизации есть utm_source, используйте =IF(ISNUMBER(SEARCH("twitter", C2)), "Twitter", "其他") для группировки.

Шаг 5: Создание простой операционной панели (Dashboard)

Ключевые показатели и соответствующие формулы

Показатель	Пример формулы	Тип диаграммы
Ежедневное количество сессий	=COUNTIF(日期列, 今天日期)	Линейная диаграмма
Распределение по источникам	=COUNTIF(来源列, "Twitter") и др.	Круговая диаграмма
Среднее время ответа	=AVERAGE(响应时间列)	Карточка с одним значением
Нагрузка на оператора	=COUNTIF(坐席列, "张三")	Столбчатая диаграмма
Коэффициент завершения сессий	=COUNTIF(状态列, "已关闭")/COUNTA(状态列)	Процентная приборная панель

Шаги по созданию:

1. Создайте новый лист с именем «Панель».
2. Используйте =QUERY(清洗后数据!A:Z, "select A, count(B) group by A label count(B) ''") для агрегации данных.
3. Выделите результаты агрегации и вставьте диаграмму (рекомендуется линейная для трендов, круговая для долей).
4. Добавьте выпадающие меню проверки данных, чтобы панель поддерживала фильтрацию по диапазону дат или каналу.

От данных к действиям: как оптимизировать процесс поддержки с помощью панели

• Анализ источников: если конверсия сессий из Twitter значительно выше, чем из других каналов, увеличьте рекламный бюджет на этот канал.
• Пиковые часы: по линейной диаграмме ежедневных сессий видно, что пик обращений приходится на вторник после обеда — планируйте больше операторов в это время.
• Эффективность оператора: если среднее время ответа у одного оператора значительно выше среднего по команде, возможно, требуется обучение или корректировка рабочего процесса.
• Теги сессий: теги пользователей из профессиональной версии помогут выявить частые типы вопросов, чтобы оптимизировать FAQ или автоматические ответы бота.

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

В: Какие поля содержит экспорт данных из TG-Staff?
О: Базовый экспорт включает ID сессии, Telegram ID пользователя, время начала/окончания сессии, общее количество сообщений, назначенного оператора, URL-параметры источника (например, utm_source); профессиональная версия дополнительно включает теги пользователей, оценку активности и теги сессий.

В: Можно ли синхронизировать данные с Google Sheets в реальном времени?
О: В настоящее время TG-Staff поддерживает ручной экспорт CSV или получение данных через API. С помощью Google Apps Script можно реализовать почти реальную синхронизацию (каждые 15 минут). Для панели в реальном времени рекомендуется использовать BI-инструменты, подключаемые к API.

В: Можно ли экспортировать данные в бесплатной пробной версии?
О: В течение 3-дневного бесплатного пробного периода можно опробовать функцию экспорта, но экспортируемые поля ограничены тарифным планом (атрибуция по ссылкам и полные записи сессий доступны начиная со стандартной версии).

В: Как использовать данные атрибуции по ссылкам в Google Sheets?
О: В Sheets можно использовать функции PIVOT или COUNTIF для подсчета количества сессий с разных utm_source и расчета конверсии (например, коэффициент перехода от ссылки к оператору).

В: Содержит ли экспорт данных личную информацию пользователей?
О: Экспортируемые данные пользователей ограничены публичной информацией Telegram (например, ID пользователя, никнейм) и содержимым сообщений в сессии. Соблюдайте законы о конфиденциальности, такие как GDPR, и рекомендуется деидентифицировать чувствительные поля.

---

Если вы хотите лично протестировать полный процесс экспорта данных Telegram Bot в Google Sheets, рекомендуем зарегистрироваться на бесплатную пробную версию TG-Staff. В течение 3 дней вы сможете протестировать ссылки и экспорт сессий. Для помощи обращайтесь к @tgstaff_robot или читайте официальную документацию.