Преобразуйте структурированные сообщения о заказах из Telegram в чистый CSV, который можно открыть в Excel, импортировать в Google Sheets, использовать для отчетности, сверки или подготовки к CRM-процессу.

Telegram Order Exporter — локальная утилита на Python для фрилансеров, творцов контента, аналитиков, операторов и малого бизнеса, которые получают заказы через Telegram и нуждаются в повторяемом способе преобразования экспорта чата в структурированные записи заказов.

Требуется только локальный запуск. API-ключ Telegram и токен бота не требуются. Основной рабочий процесс выполняется на вашем компьютере.

ЧТО ЭТО ДЕЛАЕТ

• Читает экспорт Telegram Desktop в формате JSON, читаемом машинами.

• Поддерживает один чат и полные экспорты, содержащие несколько чатов.

• Обрабатывает left_chats при наличии в полном экспорте, вместо того чтобы игнорировать их.

• Распознаёт обычные поля заказа, такие как ID заказа, клиент, имя пользователя, продукт, количество, сумма, валюта и статус.

• Обрабатывает массивы форматированного текста Telegram.

• Принимает распространённые денежные форматы, такие как 17,98 EUR, EUR 1 234,50 и $1,234.50.

• Отклоняет небезопасные выражения, такие как формулы в ячейках суммы, вместо их вычисления или угадывания.

• Использует коэффициент доверия и отдельную очередь на обзоры.

• Разделяет повторяющиеся IDs сообщений и IDs заказов в очередь дубликатов.

• Записывает CSV в кодировке UTF-8 с BOM для совместимости с электронными таблицами.

• Защищает от распространённых префиксов для инъекций формул в таблицах по умолчанию.

• Генерирует JSON-отчёт для аудита и последующей автоматизации.

• Поддерживает пользовательские псевдонимы и обязательные поля через файл правил JSON.

• Использует только стандартную библиотеку Python.

ЧТО ВЫ ПОЛУЧИТЕ

• telegram_orders_to_csv.py - главный парсер/экспортер

• Запускатель для Windows

• Запускатель для macOS/Linux

• configurable rules.example.json

• синтетические примеры экспорта Telegram JSON

• примеры принятых, просмотренных и дублирующихся CSV

• пример рабочей тетради Excel

• 15-страничное руководство пользователя в PDF

• руководство по безопасности и конфиденциальности

• офлайн набор модульных тестов

• README

• START HERE руководство

• SOURCES

• CHANGELOG

• коммерческая лицензия

OUTPUT FILES

Если основным выводом является orders.csv, инструмент также создаёт:

• orders_review.csv - потенциальные заказы, требующие человеческого рассмотрения.

• orders_duplicates.csv - повторяющиеся IDs сообщений или заказов.

• orders_summary.json - метаданные запуска, подсчёты, объём и сводка статуса.

КАК РАБОТАЕТ

1. Экспортируйте чат Telegram в машиночитаемом формате JSON через Telegram Desktop.

2. Запустите включённый экспортёр против файла JSON