Боты: MAX и Telegram

Система общается с поставщиками и клиентами через мессенджеры — Telegram и MAX. Запросы техники поставщикам, запросы актуального статуса, готовые КП клиентам — всё это уходит обычным сообщением в бот, а ответы возвращаются в систему автоматически. Это и есть способ взаимодействия с партнёрами «через ботов».

Какие каналы работают

  • Telegram и MAX — рабочие каналы (нужен подключённый бот).
  • Avito — пока выключен, поэтому в выборе канала для рассылок его нет.

Как подключить поставщика к боту

Подключение партнёра живёт в его карточке в разделе «Поставщики», в блоке «Рассылки».

Блок «Рассылки» в карточке партнёраБлок «Рассылки» в карточке партнёра

  1. Выберите «Канал» — Telegram или MAX (тот мессенджер, где партнёр общается с вашим ботом).
  2. Впишите «ID чата бота» — это технический идентификатор чата партнёра с вашим ботом (не номер телефона). Его получают, когда партнёр первый раз пишет боту; при необходимости спросите у администратора системы.
  3. Отметьте «Подписать на рассылки запросов».
  4. Нажмите «Сохранить» (или «Зарегистрировать» в первый раз).

Главное правило: запрос дойдёт до партнёра, только если он И «Подписан», И «Бот подключён» (указан ID чата). Если подписать без ID чата, система прямо предупредит: «Подписан, но бот не подключён — рассылки не дойдут».

Состояние видно по отметкам в блоке: «Подписан» / «Не подписан» и «Бот подключён» / «Бот не подключён».

Мини-приложение в MAX (самостоятельные заявки)

Кроме обычных сообщений, в MAX у бота может быть мини-приложение — страница, которая открывается по кнопке прямо в боте. Через неё поставщик сам подаёт заявку на подключение, а после одобрения там же открывается его кабинет. Это снимает с вас ручное заведение каждого партнёра — см. Заявки партнёров.

Что видит поставщик у себя в телефоне

Партнёр получает в своём Telegram- или MAX-боте обычное текстовое сообщение — запрос техники, запрос статуса или КП. Кнопок нет, он просто отвечает текстом:

  • «да», «есть», «готов», «свободен» — система засчитывает как согласие;
  • «нет», «занят», «отказ» — как отказ;
  • число рядом со словом-единицей (например «есть 3 шт», «3 единицы», «3 машины») — как количество единиц. Просто число без такого слова система за количество не считает.

Система сама разбирает такой ответ и обновляет предложение в диспетчеризации или свежесть на Борде — вам ничего вводить не нужно.

Если ответ непонятный (например, развёрнутый текст без явного «да/нет»), он просто попадает во «Входящие» как обычное сообщение — там вы прочитаете и ответите руками.

Что уходит клиенту

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

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

Для администратора: что нужно для запуска ботов

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

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