Блог RU
2026-11-10 12:46 Telegram и автоматизация

Как передавать заявку из Telegram-бота в систему заказчика без постоянного API

У заказчика есть внутренняя система, которая не предоставляет постоянный API или запрещает внешнее соединение. Отказ от API не обязательно означает ручное копирование заявок из Telegram. Можно согласовать регулярную передачу файла, защищённый обмен или очереди импорта. Но без протокола подтверждения бот не знает, дошли ли данные, а повторная отправка может создать дубликаты заказов.

Для FILE-99 отсутствие постоянного API меняет способ передачи заявки, но не отменяет контроль получения: выгрузка файла сама по себе не означает, что строка принята системой заказчика. Реализация требует проектирования через разработка Telegram-ботов и Mini Apps.

Какие исходники и ограничения нужны до оценки

  • Формат, который система реально принимает: CSV, XLSX, структурированный JSON или согласованная таблица.
  • Поля заявки, требования к кодировке, временным зонам, обязательности и ограничению персональных данных.
  • Способ защищённой передачи, расписание импорта, ответственный за приём и канал возврата ошибок.
  • Уникальный идентификатор заявки, журнал партий, правила обработки отклонений и повторной доставки.

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

Как работает решение и что оплачивается

Поток должен состоять из явных состояний: создана в боте, подготовлена к экспорту, передана, принята к обработке, импортирована либо отклонена. Файл не следует считать успешно обработанным только потому, что он появился в папке. После импорта нужна квитанция о принятых и отклонённых строках. У каждого события сохраняют устойчивый внешний ID, который система заказчика умеет распознавать, чтобы повторная загрузка не создавалась как новая заявка.

В оценку входят формат данных, правила идентификаторов, механизм передачи, импортные проверки, журнал подтверждений, повторная обработка и инструкции для оператора. Разработка импортёра внутри закрытой ERP, SFTP-инфраструктура, сложная защита персональных данных и бизнес-процессы ручного исправления могут потребовать отдельного согласования с технической командой заказчика. Нельзя утверждать, что любой существующий Excel-экспорт автоматически обеспечит надёжную интеграцию.

В FILE-99 оценивают формат выгрузки, схему проверки строк, квитанции импорта и повторную отправку только отклонённых записей; стартовый пакет не включает эти интеграционные правила автоматически. коммерческое предложение Telegram даёт ориентир по базовому направлению, но не фиксированную стоимость этого сценария.

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

Заполненный условный пример FILE-99

Учебный FILE-99 содержит десять заявок F001–F010 в партии B-99. При первом импорте девять строк приняты, F007 отклонена из-за отсутствующего обязательного кода объекта. Бот получает квитанцию: accepted=9, rejected=1, а F007 остаётся в состоянии «нужно исправить». Оператор дополняет поле и повторно передаёт F007 с тем же устойчивым ID, не пересоздавая девять принятых заявок.

После корректировки импортёр подтверждает F007 и отмечает все десять уникальных ID как принятые; итог 9+1=10 без дублей. При повторной отправке исходного файла система видит F001–F010 и не создаёт новые записи; вместо этого возвращает статусы. Если система не способна вернуть квитанцию, необходимо заранее определить безопасную процедуру ручного подтверждения и сверки, не выдавая «файл создан» за «заявка принята».

Ошибки, ограничения и приёмка

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

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

Файл — транспорт данных, а не свидетельство успешной заявки

Когда API недоступен, заказчики часто предлагают просто отправлять CSV на почту раз в час. Это возможно только после согласования защиты, проверки формата и подтверждения фактического приёма. Доставка вложения на email не означает, что ERP прочитала строку, а менеджер её обработал. Поэтому в FILE-99 важны минимум два независимых журнала: исходящие заявки в боте и фактические импортные результаты в системе заказчика. Если принимающая сторона не умеет возвращать формальное подтверждение, нужно предусмотреть контролируемую ручную сверку, а не молча считать всё успешным.

У каждого поля должен быть согласованный тип. Дата и время нуждаются в часовом поясе, количество — в единицах измерения, идентификатор товара — в актуальном справочнике, номер клиента — в допустимом формате. Текстовые поля требуют правил экранирования, а файл — согласованной кодировки. Иначе одна запись может не пройти импорт, а остальные будут обработаны частично. Схему следует версионировать: изменение столбца без предупреждения может сломать весь обмен. Отдельно определите, какие персональные данные действительно необходимы и как долго они сохраняются в промежуточных файлах.

Повторная доставка без дублей FILE-99

  • При экспорте десять строк F001–F010 получают устойчивые уникальные ключи, не меняющиеся при повторной отправке.
  • Получатель возвращает статус по каждой строке. Девять приняты, F007 не прошла обязательную проверку кода объекта.
  • Оператор исправляет именно F007 и передаёт её с тем же ключом. Другие девять строк не создаются заново.
  • После повторного импорта получатель подтверждает десять уникальных принятых заявок. Итог 9+1=10, дублей нет.
  • Если прежнее подтверждение потерялось, запрос статуса по ключу должен отличать уже принятую запись от новой, не создавая повторный заказ.

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

Безопасность обмена зависит от конкретного канала. Ссылки на файлы не должны быть публичными без контроля доступа; секреты для соединений не включают в исходный код, доступный всем сотрудникам. Если используется общая папка, заранее определяют владельца, сроки удаления, роли и механизм уведомления об утечке. Техническая реализация и её стоимость требуют индивидуального изучения инфраструктуры заказчика. Функциональная приёмка подтверждает корректность тестовых импортов, а не универсальную безопасность всех каналов.

План действий при длительной недоступности импорта

Без постоянного API обмен нередко работает по расписанию. Если принимающая система недоступна несколько часов, бот должен сохранить заявки в контролируемой очереди и показывать ответственному, какие партии ждут подтверждения. Не нужно обещать клиенту, что заказ «уже принят в работу», когда есть только локальная запись. Для таких случаев полезны отдельные статусы «зарегистрировано», «передано» и «подтверждено получателем», с понятными правилами повторной отправки.

При восстановлении связи система повторно использует прежние идентификаторы F001–F010. Оператор видит, что девять записей уже подтверждены, а F007 требует исправления, и не перезапускает всю группу как новый импорт. Полнота процесса подтверждается итоговым отчётом с количеством полученных, обработанных, отклонённых и повторно принятых строк. Без такой сверки простой файл экспорта нельзя считать надёжной интеграцией.

На этапе согласования стоит определить, что считается окончательным подтверждением заявки. Импорт файла в ERP может ещё не означать, что менеджер принял заказ к исполнению. Эти статусы лучше не объединять: «строка принята системой» и «заказ подтверждён сотрудником» — разные события. Тогда бот не будет преждевременно обещать сроки или поставку, а клиент сможет узнать, на каком этапе находится его обращение.

Что прислать для коммерческой оценки

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

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