Практика работы с Telegram
Отчёт по задаче Telecobra: статусы, выгрузки и сверка
Как собрать отдельный отчёт о парсинге, рассылке, инвайтинге и диалогах, сохранив различия между действиями и заявками.
Начните с идентификатора и периода#
Запишите модуль, внутренний ID задачи, её название, время запуска и окончания. Для незавершённой задачи укажите время снимка. Сводка за день и результат одной задачи отвечают на разные вопросы, поэтому храните оба уровня отдельно.
Не складывайте «найдено пользователей», «отправлено сообщений» и «получено ответов» в общий показатель эффективности. Один человек может присутствовать в нескольких наборах и выполнить несколько действий.
Где получить данные#
| Модуль | Источник результата |
|---|---|
| Парсинг | Карточка задачи и выгрузка CSV / Excel / TXT |
| Рассылка | Статус кампании и журнал отправок |
| Инвайтинг | Счётчики и записи получателей задачи |
| Автоответчик | Журнал правила и история диалогов |
| Мониторинг | Найденные сообщения и журнал источников |
Для API используйте конкретный ID. Например: GET /api/invite/ID, GET /api/invite/ID/recipients, GET /api/autoreply/ID/log и GET /api/autoreply/ID/conversations. Подставьте внутренний идентификатор своего кабинета и заголовок авторизации.
Отдельная таблица отчёта#
Дата снимка | Модуль | ID задачи | Статус
Запланировано | Подтверждено | Пропущено | Ошибки | Требует разбора
Источник выгрузки | Следующее действие | ОтветственныйУчебный пример: задача содержит 80 адресатов. Подтверждено 50 действий, 15 пропущено, 10 дали ошибку, 5 остались без подтверждённого итога. Сумма 50 + 15 + 10 + 5 = 80. Доля подтверждённых действий — 50 / 80 × 100 = 62,5%. Это не конверсия в покупку и не фактический результат клиента.
Если число событий журнала больше числа адресатов, проверьте повторы и единицу учёта. Для отчёта по людям сначала определите итоговый статус каждой уникальной записи.
Общая аналитика API#
GET /api/analytics/summary?since=2026-09-18
X-API-Key: <ключ Telecobra>Параметр since задаёт начало периода в формате YYYY-MM-DD. Ответ содержит время генерации и несколько разных блоков данных. Текущие состояния аккаунтов являются снимком; события журнала фильтруются по времени, а некоторые показатели задач представляют накопленный итог выбранных задач. Нельзя считать все поля одинаковыми суточными счётчиками.
Перед регулярной отчётностью сверяйте каждый используемый показатель с журналом модуля. Не обещайте выгрузку полного архива через endpoint, который возвращает только ограниченную последнюю часть записей.
Как связать работу и продажи#
Запросите отдельный источник подтверждённых обращений и оплат: журнал заявок или CRM. Свяжите их по дате, проекту и идентификатору обращения. Автоматически достигнутая цель автоответчика не доказывает оплату.
Храните исходный отчёт рядом с итоговой таблицей, но убирайте телефоны, содержимое сессий и личные переписки из публичных примеров. Так можно повторно проверить вывод, не публикуя данные клиентов.
Готовый результат для проверки#
Откройте учебный разбор с исходными данными, итоговым файлом и объяснением решений. Данные вымышленные; действия в Telegram не выполняются.
Сверка счётчиков с исходным объёмом#
Отдельный пример проверки баланса. Числа ниже относятся к другой учебной задаче, а не к продолжению предыдущей сводки.
Учебная задача получила 100 записей: 70 имеют подтверждённый успешный исход, 20 — явный отказ, десять ещё не обработаны. Сумма равна входному объёму. Если категории пересекаются или часть записей исчезла, отчёт требует уточнения.
Фактические названия статусов нужно брать из выбранного инструмента; пример не задаёт новый контракт Telecobra. Сохраняйте идентификатор задачи, время среза и файл результата. Счётчик успеха следует понимать в смысле конкретного действия, а не автоматически как число клиентов или прочтений.
Практический разбор добавлен 8 октября 2026 года.
Дополнительные документы для сверки: telecobra.com/guides/
Редактура структуры: . Упорядочены разделы и пояснения. Даты исходных снимков, примеров и функциональных проверок указаны отдельно.
Одна платформа · разные задачи
Подписка Telecobra
Соберите инструменты для работы с Telegram в одном кабинете. Сроки доступа, цены и условия — на странице подписки.
В этой инструкции описана только часть возможностей платформы. Полный список доступен в разделе функций.