pimenov.ai
Кейс / Клиентский вход через Telegram

Как личный Telegram стал входом в клиентские процессы

Сотрудники уже присылали Сергею ежедневные итоги голосом в личный Telegram. Людям было проще рассказать о результате, препятствии и следующем шаге, чем заполнять ещё одну форму. Но за удобным разговором скрывалась ручная работа: скачать аудио, разложить файлы, передать их Codex, собрать PDF и вернуть документы адресатам.

Telegram Business позволил сохранить личный чат как человеческий интерфейс, а техническую обработку вынести на Mac mini. Клиент пишет привычным способом, официальный Bot API передаёт только разрешённые сообщения, Codex разбирает смысл, а обычный код проверяет структуру, адресата и право внешнего действия.

Источник

3 ID

Маршрут привязан к business_connection_id, chat_id и user_id, а не к изменяемому имени пользователя.

Материалы

5 форматов

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

Архитектура

2 слоя

Предсказуемый код держит транспорт и проверки, а Codex работает только с подготовленным смысловым пакетом.

Один входящий поток из личного Telegram превращается в личные документы сотрудников и управленческий итог

Рабочий маршрут

Клиент отправляет сообщение как обычно, а система собирает проверяемый пакет

Постоянный приёмник на Mac mini не пытается сразу сделать вывод или кому-то ответить. Сначала он подтверждает источник, сохраняет исходные материалы, убирает повторы и готовит ограниченный пакет для смысловой работы.

  1. Человек пишет Сергею в личный Telegram: текстом, голосом или прикладывает файл.
  2. Приёмник проверяет числовую связку источника, сохраняет сообщение вне Git и отсеивает повторы.
  3. Аудио транскрибируется локально, материалы одной даты собираются в пакет и дополняются read-only снимком amoCRM.
  4. Codex выделяет факты и следующие действия, после чего обычный код проверяет документы и только затем разрешает доставку.

Продуктовое решение

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

В этом процессе был важен личный адресат. Сотрудник понимал, кому рассказывает о своём дне, и не переходил в ещё одно служебное окно. Поэтому автоматизация появилась на стороне Сергея и не заставила клиента менять привычку.

Личный чат остался личным

Человек продолжает писать Сергею в той же переписке, без команд, нового интерфейса и необходимости искать отдельного бота.

Автоматизация работает только в выбранных чатах

Telegram Business-бот получает доступ не ко всей переписке, а к явно разрешённому маршруту с устойчивой числовой идентификацией.

Формат сообщения не навязывается

Можно надиктовать итог по дороге, переслать документ, добавить фотографию или написать короткое пояснение.

За знакомым входом появился проектный процесс

Сообщение получает происхождение, состояние обработки, документированный результат и контролируемый путь обратно.

Разделение ролей

Mac mini координирует поток, Codex отвечает только за смысл

Codex не живёт внутри Telegram, не получает токен и не выбирает адресатов. Он видит подготовленный пакет источников и возвращает структурированный результат. Получение сообщений, очереди, транскрибация, PDF, журнал и доставка остаются у проверяемого кода.

Telegram Business: привычный вход

Официальный Bot API подхватывает разрешённые сообщения в личной переписке, не меняя сценарий клиента.

Mac mini: постоянный координатор

Локальная машина принимает обновления, хранит вложения, запускает транскрибацию и ведёт состояния обработки.

Codex: смысловой исполнитель

Агент выделяет результаты, препятствия, следующие действия и собирает документы по строгому контракту.

amoCRM: read-only сверка

Подготовленный снимок помогает отличить подтверждённые действия от частично подтверждённых и мест, где данных недостаточно.

Обычный код: право действия

Структура, тип документа, адресат и контрольная сумма проверяются до любой обратной отправки.

Человек: владелец границ

Новый маршрут по умолчанию готовит черновик; отправка, задачи, CRM-записи и публикация включаются отдельно.

Безопасность

Неуверенность останавливает цикл, а не превращается во внешнее действие

Маршрут проектировался вокруг цены ошибки. Если источник неизвестен, транскрибация не завершилась, результат Codex не прошёл проверку или адресат не совпал с контрактом, система не пытается угадать и ничего не отправляет.

Источник проверяется до обработки

Связка business_connection_id, chat_id и user_id отделяет разрешённый чат от похожего имени или изменённого username.

Повтор не создаёт второй материал

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

Секреты не входят в пакет Codex

Telegram-токен, пароли, учётные данные других систем и право выбирать адресатов остаются вне смыслового прохода.

Документы разделены по получателям

Сотрудник получает только своё нейтральное резюме, а управленческий отчёт нельзя случайно отправить не тому человеку.

Доставка проверяет файл

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

Новый маршрут начинается с тени

Сначала одно контрольное сообщение должно прийти ровно один раз, попасть только в свой проект и не вызвать внешних действий.

Повторяемость

Частный процесс превратился в способ подключать новые проекты

После первого рабочего контура стало ясно, что транспорт не зависит от ежедневных отчётов. Через тот же личный Telegram клиент может передать договор, таблицу, фотографию, вопрос или голосовое объяснение — различается только контракт проекта.

Подключение оформлено как Codex-скилл

Скилл уточняет клиента, допустимые сообщения, нужный результат, место хранения, право ответа и операции с отдельным подтверждением.

У каждого проекта свой маршрут

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

Без общего маршрутизатора скилл останавливается честно

Пока межпроектный слой не включён, подключение заканчивается подготовленным контрактом и не смешивает новый чат с действующим проектом.

Внешние действия остаются отдельным решением

Приём материалов и черновик можно проверить безопасно; отправку, постановку задач и запись в CRM разрешают только после пилота.

Общий приёмник разводит голосовые, документы и изображения по изолированным маршрутам клиентских проектов

Результат

Telegram остался разговором, но ручная перекладка перестала быть системой

Для клиента почти ничего не изменилось. Для Сергея изменился весь внутренний маршрут: у входящего материала появились происхождение, очередь, транскрибация, смысловой контракт, проверяемые документы и контролируемая обратная доставка.

Клиенту не нужно осваивать новую систему

Он пишет, надиктовывает и пересылает материалы в привычном личном чате.

Материал больше не зависит от ручного внимания

Файлы не нужно каждый раз скачивать, переименовывать, раскладывать по папкам и заново объяснять задачу Codex.

Руководитель видит границы доказательств

Сводный отчёт различает подтверждённые данные, частичное подтверждение и места, где информации для вывода недостаточно.

Появился повторяемый клиентский интерфейс

Обычное личное сообщение может безопасно запустить проектный процесс с понятными разрешениями и стоп-линиями.

Источник

Полный маршрут описан в статье про Telegram Business и Codex

В статье разобраны причины сохранить личный чат, устройство приёмника на Mac mini, локальная транскрибация, read-only сверка с amoCRM, роль Codex, безопасная доставка и переход от одного процесса к повторяемому способу подключения клиентов.