Такси — Документация

Telegram-бот заказа такси

Удобный способ пользоваться сервисом через Telegram. Ниже — простое описание кнопок и что они делают.

Нижнее меню бота:

🏠 Главное меню — вернуться на главный экран бота.
🚕 Заказать в приложении — самый удобный способ оформить поездку.
🚕 Заказать в чате — заказ через сообщения бота.
🚖 Стать исполнителем — перейти в раздел для исполнителей.
🤝 Стать партнёром — перейти в раздел для партнёров.
👥 Партнёрка — раздел приглашений и рекомендаций.

Кнопки в сообщении бота (верхний блок):

Открыть приложение — перейти к оформлению заказа.
🚖 Открыть кабинет исполнителя — вход для исполнителей.
ℹ️ Помощь — краткая справка по использованию.
💬 Поддержка — написать в поддержку.
🔗 Поделиться — пригласить друзей.

Основные команды:

/start — открыть главное меню.
/taxi — быстро перейти к заказу.
/help — открыть помощь.
/language — сменить язык.

Как выглядит путь пользователя:

1) Клиент нажимает Заказать в приложении.
2) Открывается экран заказа: клиент указывает маршрут и подтверждает поездку.
3) После создания заказа открывается страница торгов.
4) В боте и приложении клиент получает обновления по заказу и ставкам.

Добавить на экран

Этот экран помогает установить быстрый доступ к сервису на главный экран телефона, чтобы открывать его как обычное приложение.

Что внутри

Отдельные инструкции для iPhone и Android.
Кнопка копирования ссылки бота для ручного добавления.
Пошаговые подсказки, как создать ярлык на домашнем экране.

Результат: клиент запускает сервис быстрее, в один тап с экрана телефона.

Обновления

Здесь публикуются последние изменения сервиса: новые функции, улучшения и исправления.

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

Сообщить о баге

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

Как отправить сообщение

Опишите, что именно не работает или работает неверно.
При необходимости добавьте скриншот.
Нажмите Отправить.

Что поддерживается

Загрузка изображений (PNG, JPG, WEBP, GIF).
Визуальный предварительный просмотр скриншота.
Счётчик длины сообщения для удобства заполнения.

Клиентское меню

Это первая страница клиента — главный экран, с которого начинается работа в сервисе. Здесь можно выбрать тип заказа, перейти к оформлению поездки и открыть все основные разделы.

Что клиент видит на экране

Верхний баннер с визуальной информацией.
Блок Выберите класс для выбора типа услуги.
Ниже — сетка кнопок с разделами: заказы, настройки, поддержка, партнёрство, реклама и другие действия.

Блок «Выберите класс»

Легковые — основной рабочий класс для заказа поездки.
Грузовые — направление для перевозки грузов.
Грузчики — помощь с погрузкой и разгрузкой.
Курьер — доставка небольших отправлений.
Помощь на дороге — помощь водителям в дорожных ситуациях.
Если выбран доступный класс, открывается страница оформления заказа; если раздел ещё не активирован, показывается сообщение, что он в разработке.

Полный список функций на этой странице

Стать исполнителем — переход в раздел для исполнителей, где можно подключиться к выполнению заказов.
Мои заказы — просмотр текущих и завершённых заказов клиента.
Настройки — открытие окна настройки языка и валюты.
Связаться с нами — быстрый переход в поддержку.
Дисп. доступ — отдельный служебный раздел (может быть недоступен для обычного клиента).
Стать партнёром — переход в партнёрский раздел сервиса.
Реклама — переход в раздел запуска и управления рекламой.
Поделиться — отправка ссылки на сервис друзьям и знакомым.
Добавить на экран — добавление приложения на главный экран телефона для быстрого запуска.

Настройки на странице клиента

Можно выбрать язык интерфейса: Русский или English.
Можно выбрать валюту отображения стоимости: KZT, RUB, EUR, USD.
После сохранения новые настройки применяются сразу.

Пошагово: как оформить заказ с этой страницы

1) На главном экране нажмите нужный класс услуги (чаще всего Легковые).
2) Перейдите к экрану оформления заказа.
3) Заполните маршрут и контактные данные.
4) Подтвердите заказ и перейдите к выбору предложения от исполнителей.

Главная идея страницы: это единая стартовая точка, где клиент сразу выбирает нужный тип услуги и получает быстрый доступ ко всем важным разделам сервиса.

Оформление заказа

После выбора класса открывается страница, где клиент заполняет данные поездки. Это основной экран создания заказа.

Что есть на странице заказа

Карта для ориентира по маршруту и выбора точек.
Кнопка Назад для возврата в клиентское меню.
Кнопка Меню с быстрыми переходами в разделы сервиса.
Кнопки масштабирования карты + и −.

Основные поля заказа

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

Удобные действия при заполнении

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

Время подачи

Сейчас — машина нужна как можно скорее.
По расписанию — можно указать точные дату и время.
Для заказа по расписанию доступен выбор: точное время или интервал времени.

Цена и оплата

Перед отправкой показывается ориентировочная оценка поездки.
Можно выбрать способ оплаты: Любой, Наличные, Перевод.

Завершение оформления

После заполнения нажмите кнопку Заказать.
Далее открывается экран предложений от исполнителей.
Там можно выбрать подходящее предложение и продолжить заказ.

Коротко: заполните маршрут, контакт, время и способ оплаты → нажмите Заказать → выберите лучшее предложение.

Мои заказы

На этой странице собраны все поездки клиента: текущие и завершённые. Это основной экран для контроля своих заказов.

Что есть на странице

Список активных заказов в верхней части.
История завершённых и отменённых заказов ниже.
Карточки с номером заказа, статусом, адресами, временем и стоимостью.
Быстрая сортировка списка по времени подачи или по дате создания.

Что можно сделать

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

Коротко: если нужно быстро вернуться к поездке — открывайте Мои заказы.

Заказать в чате

Если удобнее писать сообщениями, можно оформить заказ через чат с ботом.

Нажмите 🚕 Заказать в чате.
Следуйте подсказкам бота и заполните данные для заказа.
Все актуальные заказы доступны в разделе Мои заказы.

Стать исполнителем

Раздел для тех, кто хочет выполнять заказы и зарабатывать в сервисе.

Нажмите 🚖 Стать исполнителем.
Откройте кабинет исполнителя и завершите настройку профиля.
После подключения можно принимать заказы и менять статус поездки.

Торги и предложения

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

Как проходит процесс торгов

1) После отправки заказа запускается поиск исполнителей.
2) На экране идёт таймер, а предложения появляются по мере отклика.
3) Вы сравниваете стоимость и исполнителей.
4) Подтверждаете подходящее предложение и переходите к поездке.

Что отображается на странице

Карточка заказа: номер, адреса, класс, комментарий и важные детали маршрута.
Таймер торгов, чтобы видеть, сколько ещё идёт поиск.
Список предложений от исполнителей с ценой и информацией по машине/водителю.
Кнопки управления поиском: продлить или отменить.

Что можно сделать клиенту

Выбрать предложение — подтвердить подходящего исполнителя.
Продлить поиск на +5 минут — если хотите дождаться других вариантов.
Отменить торги — если заказ больше не актуален.
Следить за обновлениями в реальном времени: новые ставки появляются без перезагрузки.

Как выбрать лучшее предложение

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

Важно: после принятия предложения торги завершаются, и заказ автоматически переходит на страницу Статус заказа.

Статус заказа

Это главный экран вашей текущей поездки. Здесь в реальном времени видно, что происходит с заказом: кто назначен, где находится исполнитель и на каком этапе поездка.

Этапы поездки на экране статуса

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

Что клиент видит в карточке заказа

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

Что можно сделать на этой странице

Связаться с исполнителем по телефону.
Открыть чат с исполнителем и уточнить детали поездки.
Следить за таймером ожидания, если исполнитель ждёт на месте.
Отменить заказ, пока поездка не завершена.
Быстро перейти в Историю или создать Новый заказ.

Как действовать клиенту по этапам

Когда статус Принят — проверяйте данные исполнителя и готовьтесь к подаче.
Когда статус На месте — выходите к точке подачи и, при необходимости, напишите в чат.
Когда статус В пути — контролируйте маршрут и оставайтесь на связи.
Когда статус Завершён — проверьте итог и поставьте оценку.

Коротко: раздел Статус заказа нужен для полного контроля поездки от назначения исполнителя до завершения.

Завершение и оценка

После завершения поездки клиент видит итоговый экран: детали поездки, стоимость и форму оценки исполнителя.

Что есть на экране

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

Что может сделать клиент

Оставить оценку от 1 до 5 звёзд.
Добавить комментарий к поездке.
Отправить отзыв.
Сразу перейти к новому заказу или открыть детали завершённой поездки.

Важно: оценка помогает улучшать качество сервиса и работу исполнителей.

Водительский бот

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

Главные кнопки в меню бота

Панель исполнителя — быстрый вход в приложение водителя.
Регистрация — оформление профиля исполнителя.
Помощь — инструкция по работе и ключевым действиям.
Язык — переключение интерфейса RU/EN.
Стать заказчиком — переход в клиентский бот.
Партнёрка — переход в партнёрскую программу.

Что бот делает автоматически

Проверяет, подписан ли водитель на обязательные каналы (если это включено в настройках).
Проверяет регистрацию водителя перед входом в панель.
Проверяет, включена ли live-геолокация перед началом работы.
Показывает быструю кнопку открытия панели после успешной проверки.

Полезные команды

/start — главное меню водителя.
/orders — быстрый переход к заказам.
/panel и /app — вход в водительскую панель.
/help и /language — помощь и язык.

Что обязательно перед началом работы

Быть зарегистрированным в системе как водитель.
Включить и транслировать геолокацию в Telegram (live location).
После включения геолокации снова нажать вход в панель.

Коротко: бот не просто открывает панель, а контролирует готовность водителя к работе и ускоряет ежедневные действия.

Панель водителя

Панель водителя — это центральный рабочий интерфейс исполнителя. В ней водитель принимает заказы, ведёт поездку, работает с маршрутами, контролирует профиль и финансы.

Что есть в верхнем меню панели

Новые заказы — список свежих заявок для принятия.
Активный заказ — текущая поездка и статусы выполнения.
Карта заказов — география заявок и маршрутов.
Мой тариф — параметры доступа и условий работы.
Профиль и Финансы — персональные данные, история и платежи.

Дополнительные разделы водителя

История поездок и отдельный экран завершённых заказов.
Загрузка документов и контроль статуса верификации профиля.
Обновления сервиса и форма Сообщить о баге.
Добавление ярлыка приложения на домашний экран телефона.

Системные проверки перед работой

Проверка статуса аккаунта водителя.
Проверка доступа/тарифа (если применяется платный доступ).
Проверка актуальной геолокации, чтобы водитель был виден в выдаче заказов.

Как устроен вход в работу

Если есть активная поездка — панель сразу ведёт в экран активного заказа.
Если активной поездки нет — открывается список новых заказов.
Если геолокация выключена/устарела — водитель получает экран с инструкцией включения.

Коротко: панель водителя — это ежедневный рабочий интерфейс для приёма и ведения заказов.

Водитель: новые заказы

На экране новых заказов водитель получает все доступные заявки, которые подходят по правилам системы, локации и условиям тарифа.

Что показывает карточка заказа

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

Что может сделать водитель

Открыть детали заявки и маршрут на карте.
Принять заказ, если условия подходят.
Сделать предложение по цене (в сценариях с торгами).
Работать через фильтрацию заявок по доступности для водителя.
Следить за индикатором новых заказов в верхней панели.

Практика работы с потоком заказов

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

Важно: если уже есть активная поездка, система ведёт водителя в экран активного заказа.

Водитель: активный заказ

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

Этапы выполнения заказа

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

Что есть на экране активного заказа

Карта и маршрут с актуальными точками поездки.
Кнопки смены статуса (прибыл/начать/завершить).
Расчёт ожидания и актуальной стоимости с учётом правил тарифа.
Чат с клиентом и отметка непрочитанных сообщений.
Быстрые действия: звонок, переход к навигации, контроль заказа.

Дополнительные действия

Отмена заказа по правилам системы, если поездка не может быть выполнена.
Переход к экрану завершения и оценке клиента после закрытия поездки.
Контроль времени ожидания клиента на месте подачи.

Коротко: активный заказ — это полный рабочий пульт одной поездки от подачи до финала.

Водитель: профиль и финансы

Раздел профиля и финансов закрывает все вопросы по аккаунту водителя: личные данные, документы, статистика поездок, доступ и платежи.

Что есть в профиле

Основные данные исполнителя и автомобиля.
История завершённых поездок и рейтинг.
Статус документов и переход к их загрузке.
Отдельные страницы настроек и истории работы.

Что есть в финансах

Баланс, платежи и история операций.
Оплата доступа/подписки (если включено в системе).
Пакеты заказов, комиссии и рабочие ограничения по настройкам сервиса.
Состояние текущего доступа: до какой даты активен и что делать для продления.

Что важно контролировать регулярно

Актуальность документов — без подтверждения могут ограничиваться функции.
Баланс/доступ — чтобы не терять возможность брать заказы в пиковые часы.
Историю поездок — для анализа дохода и качества работы.

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

Водитель: работа по шагам

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

Пошаговый сценарий

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

Частые рабочие ситуации

Нет доступа в панель: проверьте подписку/тариф и статус аккаунта.
Не видно заказов: проверьте, что геолокация активно передаётся.
Есть активный заказ: всегда завершите текущий цикл до взятия нового.
Клиент не на месте: используйте чат/звонок и фиксируйте ожидание по правилам.

Итог: водительский бот и панель вместе закрывают полный цикл: вход, заказы, выполнение поездки, финансы, документы и качество сервиса.

Реклама: обзор кабинета

Рекламный кабинет — это рабочее место рекламодателя: здесь создаются кампании, контролируются статусы и оценивается результат.

Что есть на главном экране

Карточки с быстрыми цифрами: всего кампаний, активные, на модерации.
Кампании — список всех кампаний и кнопки действий.
Новая — запуск создания новой кампании.
Статистика — показы, клики и CTR.
Как — встроенная подсказка по процессу.

Коротко: это единая точка управления всей рекламой в сервисе.

Реклама: создание кампании

Кампания создаётся по шагам. На каждом шаге вы задаёте, где и как будет показываться реклама.

Пошагово

1. Где показывать: выберите экран приложения для размещения баннера.
2. Контент: заполните название, текст, адрес, загрузите картинку и ссылку.
3. Зона показа: при необходимости укажите точку на карте и радиус.
4. Период и лимиты: настройте даты, бюджет и ограничения показов.
5. Предпросмотр: проверьте, как баннер выглядит для клиента.

Что важно перед отправкой

Название кампании должно быть понятным для вас и команды.
Текст баннера — короткий и с понятным призывом к действию.
Картинка — читаемая, в горизонтальном формате.
Ссылка — рабочая и открывается без ошибок.

Коротко: сначала заполните шаги, затем отправьте кампанию на модерацию.

Реклама: управление кампаниями

После создания кампанией нужно управлять: запускать, ставить на паузу, исправлять после отклонения и архивировать.

Статусы кампании

Черновик — редактируется, ещё не отправлена.
На модерации — ожидает проверки.
Активна — идёт показ пользователям.
Пауза — показ временно остановлен.
Отклонена — есть замечания, нужно исправить.
Архив — убрана из активной работы.

Основные действия

Открыть / Редактировать — изменить настройки и креатив.
На модерацию — отправить кампанию на проверку.
Пауза / Запустить — остановить или возобновить показы.
Архив — убрать из активного списка, сохранив историю.
Удалить — полностью удалить кампанию.

Важно: если кампания отклонена, исправьте причину и отправьте её повторно.

Реклама: статистика и оптимизация

Раздел статистики помогает понять, насколько реклама работает, и принять решения по улучшению.

Главные показатели

Показы — сколько раз баннер увидели.
Клики — сколько раз нажали на баннер.
CTR — процент кликов от показов.

Как улучшать результат

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

Если включён режим подписки

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

Коротко: смотрите метрики, тестируйте варианты и масштабируйте самые эффективные кампании.

Партнёрский бот

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

Что есть в боте

🏢 Открыть кабинет партнёра — вход в WebApp партнёра внутри Telegram.
📞 Поддержка — связь по вопросам настройки и работы.
❓ Помощь — короткие подсказки для старта.

Что бот проверяет перед допуском

Принята ли оферта партнёрской программы.
Есть ли привязанный номер телефона для связи.
Активен ли партнёрский профиль.

Что происходит после успешного входа

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

Что важно при первом входе

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

Коротко: бот — это точка безопасного входа и быстрый старт для ежедневной партнёрской работы.

Партнёрский кабинет

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

Что есть в кабинете

Панель с основными показателями: привлечённые исполнители, клиенты, активные и завершённые заказы.
Блок Мои зоны — список ваших зон обслуживания.
Кнопка + Создать зону — добавление новой зоны через карту.
Разделы Мои исполнители и Мои клиенты с реферальной статистикой.
Реферальные ссылки и партнёрский код для приглашения аудитории.

Что включает статистика партнёра

Количество привлечённых водителей и клиентов.
Общее число заказов, выполненные и активные заказы.
Динамику по зонам: где лучше работает трафик.
Доходные показатели по партнёрской модели (если включены в проекте).

Как настраивается зона

Задайте название зоны (например, район, аэропорт, центр города).
Выберите точку на карте или введите адрес.
Установите радиус зоны (например, 500 м, 3000 м, 5000 м).
Добавьте одну или несколько Telegram-групп/каналов для привязки трафика.

Работа с группами и каналами

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

Что можно делать после создания зоны

Редактировать центр и радиус зоны на карте.
Добавлять и удалять группы у каждой зоны.
Удалять зону, если она больше не нужна.
Использовать код привязки для быстрого связывания группы с зоной.

Реферальные инструменты

Персональный партнёрский код для учёта привлечений.
Отдельные ссылки приглашения для водителей и для клиентов.
Быстрое копирование и отправка ссылок в мессенджеры/чаты.

Коротко: кабинет партнёра — это рабочая система управления зонами, группами и реферальным ростом.

Партнёрская система: как работать по шагам

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

Пошаговый старт

1) Откройте партнёрский бот и перейдите в кабинет.
2) Примите условия и убедитесь, что привязан контактный номер.
3) Создайте первую зону: точка, радиус, название.
4) Добавьте Telegram-группу(ы), откуда идёт ваш трафик.
5) Возьмите реферальные ссылки и начните приглашать водителей/клиентов.
6) Регулярно смотрите статистику по привлечениям и заказам, корректируйте зоны.

Операционная работа партнёра

Ежедневно проверяйте, какие зоны дают лучший приток.
Раз в несколько дней корректируйте радиусы и границы зон.
Следите за качеством групп: активность, тематика, локальность аудитории.
Отдельно анализируйте водителей и клиентов по источникам.

Как повысить результат

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

Частые ситуации и решения

Нет входа в кабинет: проверьте, принятие оферты и наличие номера телефона.
Группа не привязывается: проверьте формат username и что бот добавлен в группу.
Слабый результат по зоне: уменьшите радиус, уточните гео и используйте отдельную группу.
Падение активности: обновите приглашения и перераспределите усилия по зонам с лучшей отдачей.

Итог: партнёрская система позволяет строить прогнозируемый рост через управляемые зоны, качественные группы и прозрачную аналитику привлечений.

Поддержка

Если возник вопрос по заказу, оплате, статусу поездки или работе приложения — используйте раздел поддержки.

Telegram: @StepA_support_bot
Также доступна поддержка внутри приложения.

Также можно использовать раздел Сообщить о баге, если заметили техническую ошибку.