DLVRY документация

# Боты (мессенджеры)

Панель управления / Боты (мессенджеры)

# Что это такое?

Боты позволяют ресторану работать с клиентами в Telegram и MAX. У них есть две основные задачи:

  1. Сообщения клиентам. Клиент подписывается на бота и может получать новости, акции, персональные предложения и уведомления о смене статуса заказа.
  2. Приём заказов через Mini App. Внутри Telegram или MAX клиент открывает меню ресторана, собирает корзину и оформляет заказ, не переходя в браузер.

Mini App — это дополнительный канал продаж DLVRY наряду с сайтом, приложением ВКонтакте и мобильными приложениями. Оформленные в нём заказы поступают в DLVRY и дальше обрабатываются по обычной схеме компании, включая передачу во внешнюю систему при настроенной интеграции.

# Как используются подписки и сообщения?

После того как клиент запустил бота и подписался на его сообщения, ресторан может обращаться к нему через:

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

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

# Как добавить бота в DLVRY?

  1. Выберите в панели управления нужную компанию и филиал.
  2. Откройте Боты → Боты (мессенджеры).
  3. Нажмите Добавить бота.
  4. Выберите мессенджер: Telegram или MAX.
  5. Укажите понятное внутреннее название и токен бота.
  6. Нажмите Сохранить.

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

Не передавайте токен посторонним

Токен даёт доступ к управлению ботом. Храните его как пароль и вводите только в настройках DLVRY и самого мессенджера.

# Настройка Telegram

# Подключение бота

  1. Перейдите в @BotFather — официальный бот Telegram для создания и настройки ботов. Нажмите Запустить / Start, если открываете его впервые.
  2. Отправьте сообщение /newbot, чтобы создать нового бота.
  3. В ответ на запрос BotFather отправьте название бота, которое будут видеть клиенты. Например: Пиццерия — заказы и акции.
  4. Затем придумайте и отправьте имя пользователя (username). Оно должно быть уникальным, содержать латинские буквы, цифры или знак _ и заканчиваться на bot. Например: my_restaurant_bot. Если имя занято, BotFather попросит выбрать другое.
  5. После создания BotFather пришлёт ссылку на вашего бота и токен — длинную строку из букв, цифр и символов. Скопируйте токен целиком: он понадобится для подключения к DLVRY.
  6. Откройте раздел «Боты» в панели DLVRY, выберите нужную компанию и филиал. В подразделе Боты (мессенджеры) нажмите Добавить бота.
  7. Выберите Telegram, укажите внутреннее название, вставьте токен в поле Токен и нажмите Сохранить.

Если бот уже создан, повторно создавать его не нужно. Откройте @BotFather, отправьте /mybots, выберите своего бота и скопируйте его API-токен. Затем выполните шаги 6–7.

Подробнее о создании бота — в инструкции Telegram.

# Подключение Mini App

Mini App позволяет клиентам открывать меню ресторана и оформлять заказы прямо в Telegram. Готовое приложение предоставляет DLVRY — вам нужно привязать его к своему боту.

  1. Откройте список ботов в DLVRY. У нужного Telegram-бота нажмите Настроить в столбце Mini App.
  2. Скопируйте ссылку Mini App из открывшегося окна целиком. Используйте именно ссылку, которую показывает DLVRY для этого бота.
  3. Перейдите в @BotFather, отправьте /mybots и выберите того же бота.
  4. Откройте Bot Settings → Configure Mini App → Enable Mini App.
  5. Когда BotFather запросит адрес приложения, отправьте скопированную ссылку DLVRY. Дождитесь подтверждения настройки.
  6. Откройте профиль своего бота и нажмите кнопку запуска приложения. Должно открыться меню вашего ресторана.

Чтобы клиенты могли открывать приложение также кнопкой рядом с полем ввода сообщения, настройте Menu Button:

  1. В @BotFather отправьте /setmenubutton и выберите своего бота.
  2. Отправьте ту же ссылку Mini App из DLVRY, затем укажите название кнопки, например Заказать.
  3. Вернитесь в чат со своим ботом и проверьте кнопку.

Подробнее — в инструкции Telegram по Mini App.

# Запуск по прямой ссылке

Клиенты могут открывать Mini App по прямой ссылке. Её можно разместить на сайте, в социальных сетях или отправить клиенту в сообщении.

  • Основное Mini App бота: https://t.me/BOT_USERNAME?startapp. Замените BOT_USERNAME на имя пользователя своего бота без @. Для работы ссылки в @BotFather должно быть настроено основное приложение — Main Mini App.
  • Отдельное Mini App с коротким именем: если в @BotFather создано отдельное Mini App с коротким именем menu, доступна ссылка вида https://t.me/BOT_USERNAME/menu. Замените BOT_USERNAME на имя своего бота без @, а menu — на короткое имя своего приложения, если оно отличается. Одной настройки Main Mini App для ссылки с /menu недостаточно — отдельное приложение с таким коротким именем должно быть создано в BotFather.

# Настройка MAX

# Подключение бота

Для создания бота нужен подтверждённый профиль бизнеса на платформе MAX для партнёров. Платформа доступна организациям, ИП и самозанятым — резидентам РФ. Как зарегистрироваться и подтвердить профиль, описано в инструкции MAX.

  1. Перейдите на платформу MAX для партнёров и войдите или зарегистрируйтесь.
  2. Создайте профиль своего бизнеса и пройдите его подтверждение, следуя подсказкам платформы. Если профиль уже подтверждён, выберите его.
  3. В разделе Чат-боты нажмите Создать.
  4. Укажите название бота, загрузите логотип ресторана и добавьте краткое описание. Например: Заказывайте доставку из нашего ресторана и получайте новости, акции и уведомления о заказах.
  5. Нажмите Создать и дождитесь успешного прохождения модерации. После проверки станут доступны настройки и токен бота. Подробнее — в инструкции по созданию и модерации бота.
  6. В разделе Чат-боты найдите созданного бота и откройте ⋮ → Настройки.
  7. Найдите поле Токен доступа и нажмите значок копирования справа от него. Токен может отображаться частично скрытым — кнопка скопирует его целиком. Как получить токен.
  8. Откройте раздел «Боты» в панели DLVRY, выберите нужную компанию и филиал. В подразделе Боты (мессенджеры) нажмите Добавить бота.
  9. Выберите MAX, укажите внутреннее название, вставьте скопированный токен в поле Токен и нажмите Сохранить.

Если у вас уже есть бот, прошедший модерацию, начните с шага 6.

# Подключение Mini App

Mini App позволяет клиентам просматривать меню и оформлять заказы внутри MAX. Для подключения используется готовая ссылка приложения DLVRY.

  1. Откройте список ботов в DLVRY. У нужного MAX-бота нажмите Настроить в столбце Mini App.
  2. Скопируйте ссылку Mini App из открывшегося окна целиком.
  3. Перейдите на платформу MAX для партнёров и откройте Чат-боты.
  4. Найдите того же бота и откройте ⋮ → Настройки.
  5. В блоке Мини-приложение вставьте скопированную ссылку DLVRY в поле для адреса приложения.
  6. Выберите вариант кнопки Открыть и нажмите Сохранить.
  7. Откройте своего бота в мессенджере MAX и нажмите появившуюся кнопку. Убедитесь, что открывается меню вашего ресторана.

Подробнее — в инструкции MAX по подключению мини-приложения.

# Запуск по прямой ссылке

Настроенное Mini App можно открыть по прямой ссылке на бота с параметром ?startapp, например: https://max.ru/BOT_USERNAME?startapp.

Чтобы получить ссылку для своего ресторана, возьмите ссылку на своего MAX-бота и добавьте в конце ?startapp. Замените BOT_USERNAME в примере на имя своего бота без @. Такую ссылку можно разместить на сайте, в социальных сетях или отправить клиенту в сообщении. Для запуска Mini App должно быть подключено к боту по инструкции выше.

# Доступные команды

/open — открыть меню ресторана. Отправьте команду /open в чат с ботом в MAX. В ответ бот пришлёт сообщение с кнопкой Открыть меню. При нажатии на неё запускается Mini App ресторана внутри MAX, где клиент может выбрать блюда и оформить заказ.

Для работы кнопки Mini App должно быть настроено — выполните подключение по инструкции выше.

# Проверка после настройки

  1. Откройте бота с клиентского аккаунта и запустите его.
  2. Убедитесь, что Mini App открывается и показывает меню нужного филиала.
  3. Проверьте корзину, условия доставки и самовывоза.
  4. Оформите тестовый заказ и убедитесь, что он появился в DLVRY и был передан во внешнюю систему, если используется интеграция.
  5. Отправьте тестовое сообщение через событие или рассылку и проверьте его получение в выбранном мессенджере.

В списке ботов отображаются название, мессенджер, Bot ID, username и состояние Mini App. Для изменения основных данных откройте бота, а для настройки приложения используйте кнопку Настроить.

Последнее обновление: 9/26/2026, 11:49:49 PM

← Клиенты →