Система общается с поставщиками и клиентами через мессенджеры — Telegram и MAX. Запросы техники поставщикам, запросы актуального статуса, готовые КП клиентам — всё это уходит обычным сообщением в бот, а ответы возвращаются в систему автоматически. Это и есть способ взаимодействия с партнёрами «через ботов».
Какие каналы работают
- Telegram и MAX — рабочие каналы (нужен подключённый бот).
- Avito — пока выключен, поэтому в выборе канала для рассылок его нет.
Как подключить поставщика к боту
Подключение партнёра живёт в его карточке в разделе «Поставщики», в блоке «Рассылки».
Блок «Рассылки» в карточке партнёра
- Выберите «Канал» — Telegram или MAX (тот мессенджер, где партнёр общается с вашим ботом).
- Впишите «ID чата бота» — это технический идентификатор чата партнёра с вашим ботом (не номер телефона). Его получают, когда партнёр первый раз пишет боту; при необходимости спросите у администратора системы.
- Отметьте «Подписать на рассылки запросов».
- Нажмите «Сохранить» (или «Зарегистрировать» в первый раз).
Главное правило: запрос дойдёт до партнёра, только если он И «Подписан», И «Бот подключён» (указан ID чата). Если подписать без ID чата, система прямо предупредит: «Подписан, но бот не подключён — рассылки не дойдут».
Состояние видно по отметкам в блоке: «Подписан» / «Не подписан» и «Бот подключён» / «Бот не подключён».
Мини-приложение в MAX (самостоятельные заявки)
Кроме обычных сообщений, в MAX у бота может быть мини-приложение — страница, которая открывается по кнопке прямо в боте. Через неё поставщик сам подаёт заявку на подключение, а после одобрения там же открывается его кабинет. Это снимает с вас ручное заведение каждого партнёра — см. Заявки партнёров.
Что видит поставщик у себя в телефоне
Партнёр получает в своём Telegram- или MAX-боте обычное текстовое сообщение — запрос техники, запрос статуса или КП. Кнопок нет, он просто отвечает текстом:
- «да», «есть», «готов», «свободен» — система засчитывает как согласие;
- «нет», «занят», «отказ» — как отказ;
- число рядом со словом-единицей (например «есть 3 шт», «3 единицы», «3 машины») — как количество единиц. Просто число без такого слова система за количество не считает.
Система сама разбирает такой ответ и обновляет предложение в диспетчеризации или свежесть на Борде — вам ничего вводить не нужно.
Если ответ непонятный (например, развёрнутый текст без явного «да/нет»), он просто попадает во «Входящие» как обычное сообщение — там вы прочитаете и ответите руками.
Что уходит клиенту
Готовое КП тоже отправляется клиенту сообщением в его канал. Чтобы отправка прошла, у клиента должен быть подключён канал связи — иначе система сообщит, что отправить некуда.
Вся переписка — и с клиентами, и с поставщиками — собирается в одном месте, в разделе «Входящие», с фильтром по каналу. Отвечать можно прямо оттуда.
Для администратора: что нужно для запуска ботов
Этот раздел — для того, кто настраивает систему при передаче, а не для повседневной работы оператора.
- Бот-токен. Для Telegram и MAX в настройках сервера должен быть прописан токен бота. Без токена отправка тихо не работает — сообщения не уходят.
- Приём входящих. Ответы от мессенджеров приходят через защищённый шлюз, который проверяет подпись и передаёт сообщения системе. Этот шлюз настраивается отдельно при развёртывании. Без него бот будет отправлять сообщения, но ответы приходить не будут — это самая частая причина «бот молчит».
- Отправка через рабочий процесс. Исходящие сообщения уходят через постоянный фоновый процесс. Если он остановлен, сообщения «зависают» в очереди и не доставляются. Состояние процессов видно в разделе «Состояние».
- Мини-приложение MAX. Чтобы поставщики могли сами подавать заявки, в кабинете MAX для бизнеса (business.max.ru) у бота указывается адрес мини-приложения (
/mна домене системы) и тип кнопки запуска, а в настройках сервера — токен MAX-бота и тенант для заявок. Подробности — в руководстве по развёртыванию и в статье Заявки партнёров.