Отчёт по задаче Telecobra: статусы, выгрузки и сверка

Начните с идентификатора и периода

Запишите модуль, внутренний ID задачи, её название, время запуска и окончания. Для незавершённой задачи укажите время снимка. Сводка за день и результат одной задачи отвечают на разные вопросы, поэтому храните оба уровня отдельно.

Не складывайте «найдено пользователей», «отправлено сообщений» и «получено ответов» в общий показатель эффективности. Один человек может присутствовать в нескольких наборах и выполнить несколько действий.

Где получить данные

Для 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: CSV, Excel и TXT →
• Инвайтинг в Telecobra: подготовка, режимы и результат →
• ИИ-автоответчик Telecobra: триггеры, диалоги и цель →