Telegram-бот для водіїв
Telegram-бот для водіїв — це система автоматичних повідомлень і управління рейсами. Водій реєструється один раз через SMS-посилання, після чого всі активні замовлення приходять йому в Telegram. Бот дозволяє підтверджувати рейси та змінювати статуси виконання прямо в месенджері.
Реєстрація водія в системі
Як це працює?
Коли ви створюєте картку рейсу і додаєте нового водія, система автоматично перевіряє його наявність у базі. Якщо водія немає — йому надходить SMS з посиланням на бота для реєстрації.
Крок 1. Додайте водія в картку рейсу
- Відкрийте розділ створення нового рейсу
- Натисніть “Додати транспорт”
- Заповніть дані водія:
- Ім’я
- Прізвище
- Номер телефону
- Збережіть картку рейсу
Крок 2. Система перевірить водія
- ✅ Система автоматично перевіряє номер телефону в базі
- ✅ Якщо водій вже зареєстрований — він одразу отримає повідомлення про новий рейс
- 📱 Якщо водій новий — на його номер надійде SMS
Крок 3. Водій реєструється через SMS
- Водій отримує SMS з посиланням на Telegram-бот
- Він переходить за посиланням і натискає “Старт”
- Система зберігає Telegram ID водія
- ✅ Реєстрація завершена — тепер водій може отримувати рейси
Робота з рейсами через бота
Як водій отримує рейси?
Після реєстрації всі активні замовлення автоматично надходять водію в Telegram.
Крок 1. Отримання повідомлення про новий рейс
- Водій отримує повідомлення: “Вам прийшов новий рейс”
- У повідомленні відображається інформація про маршрут, вантаж, час
- Під повідомленням є кнопка “Підтвердити” (Approve)
Крок 2. Підтвердження рейсу
- Водій натискає кнопку “Підтвердити”
- Система фіксує, що водій побачив замовлення
- Бот переходить до роботи зі статусами рейсу
Крок 3. Зміна статусів рейсу
Водій отримує кнопки для зміни статусу:
- 🚗 “Виїхав на завантаження”
- 📍 “Прибув на завантаження”
- ⚖️ “Завантажився”
- 🚗 “Виїхав на розвантаження”
- 📍 “Прибув на розвантаження”
- ✅ “Розвантажився”
Водій натискає відповідну кнопку на кожному етапі, і статус рейсу автоматично оновлюється в системі.
💡 Поради та можливі помилки
Поради:
- ✓ Завжди перевіряйте правильність номера телефону водія — від цього залежить доставка SMS
- ✓ Попередьте водіїв, що їм прийде SMS з посиланням — так вони не пропустять реєстрацію
- ✓ Водій може зареєструватися пізніше — посилання в SMS не має терміну дії
- ✓ Один номер телефону = один акаунт. Якщо водій змінив номер, додайте його як нового
⚠️ Можливі помилки:
| Проблема | Причина | Рішення |
|---|---|---|
| SMS не прийшла водію | Номер введено з помилкою | Перевірте формат +380XXXXXXXXX, переконайтеся в наявності мобільного зв’язку |
| Водій не може зареєструватися | Не перейшов за посиланням або не натиснув “Старт” | Переконайтеся, що водій перейшов за посиланням із SMS і натиснув “Старт” |
| Водій не отримує повідомлення про рейси | Реєстрація не завершена або бот заблокований | Перевірте завершення реєстрації та чи не заблокований бот |
| Не працюють кнопки зміни статусу | Рейс не підтверджено | Переконайтеся, що водій натиснув “Підтвердити”, спробуйте /start |
🎯 Що ви отримали
Тепер ви знаєте, як працює система реєстрації водіїв і управління рейсами через Telegram. Водій реєструється один раз за посиланням із SMS, після чого всі рейси та зміна статусів відбуваються автоматично через бота. Це економить час і спрощує комунікацію з водіями.
📦 Робота з рейсами через Telegram-бот
Після реєстрації водій отримує всі рейси через Telegram-бот. Він може переглядати деталі рейсу, підтверджувати або відхиляти його, змінювати статуси виконання та вводити дані про вантаж безпосередньо в месенджері.
Отримання нового рейсу
Як це працює?
Коли диспетчер створює рейс і призначає водія, йому автоматично приходить повідомлення в Telegram.
Крок 1. Отримайте повідомлення про рейс
- Вам прийде повідомлення: “Новий рейс”
- Натисніть кнопку “Переглянути рейс”
Крок 2. Перегляньте інформацію про рейс
Ви побачите всі деталі:
- Рейс # — унікальний номер (наприклад,
f3e228e1...) - Автомобіль: номерний знак (наприклад,
ВН5903ІС) - Причепи: номерні знаки причепів (наприклад,
ВН5534ХІ,ВН5535ХІ)
Маршрут:
- 📍 Точка А: повна адреса завантаження (наприклад, 123 Main Street, Kyiv)
- 📍 Точка Б: повна адреса розвантаження (наприклад, 456 Oak Street, Lviv)
Орієнтовна дата: період виконання рейсу (наприклад, 2025-03-13 - 2025-03-16 до 12:00:00)
Вантаж:
- Завантажено: Не вказано
- Розвантажено: Не вказано
Статус: Оголошено
Крок 3. Прийміть рішення
Внизу повідомлення є дві кнопки:
- ✅ Підтвердити рейс — ви приймаєте замовлення
- ❌ Відхилити рейс — ви відмовляєтесь від рейсу
Підтвердження або відхилення рейсу
✅ Варіант 1. Підтвердити рейс
Крок 1. Натисніть кнопку “Підтвердити рейс”
Крок 2. Ви побачите підтвердження:
✅ Рейс успішно підтверджений! Тепер ви можете переглянути поточний рейс
Крок 3. У вас з’явиться кнопка “Поточний рейс”
- Кнопка “Новий рейс” зникне
- Тепер рейс вважається активним
❌ Варіант 2. Відхилити рейс
Крок 1. Натисніть кнопку “Відхилити рейс”
⚠️ Важливо:
- Рейс залишається в системі
- Ви можете передумати і прийняти його пізніше
- Рейс не зникає і не передається іншому водію
Щоб прийняти відхилений рейс:
- Натисніть “Переглянути рейс”
- Натисніть “Підтвердити рейс”
Робота з поточним рейсом
Як переглянути активний рейс?
Після підтвердження рейсу ви можете відстежувати його виконання та змінювати статуси.
Крок 1. Відкрийте поточний рейс
- Натисніть кнопку “Поточний рейс”
- Ви побачите ту саму інформацію про рейс
- Статус: тепер показує
Прийнято
Крок 2. Почніть виконання рейсу
Під інформацією про рейс з’явиться кнопка:
🚗 “Виїхати на завантаження”
Натисніть її, коли починаєте рух до точки завантаження.
⚖️ Введення ваги вантажу
Коли потрібно вводити вагу?
Після того, як ви приїхали на завантаження, потрібно ввести дані зважування: брутто (повна вага) та тару (вага автомобіля).
Крок 1. Відкрийте поточний рейс
- Натисніть “Поточний рейс”
- Статус рейсу змінився після натискання “Виїхати на завантаження”
Крок 2. Введіть вагу брутто
Бот надішле повідомлення: “Введіть вагу брутто в тоннах”
💡 Підказка:
- Формат:
20.5- Приклад:
25.5або30.25
- Введіть вагу брутто числом (наприклад,
30.2) - Надішліть повідомлення
Крок 3. Введіть вагу тари
Після підтвердження брутто бот надішле: “Брутто: 30.2 т”
Бот попросить ввести тару: “Тепер введіть вагу тари в тоннах”
💡 Підказка:
- Формат:
2.5- Приклад:
2.3або3.15
- Введіть вагу тари числом (наприклад,
10) - Надішліть повідомлення
Крок 4. Перевірте дані
Бот покаже всю інформацію:
⚖️ Брутто: 30.2 т
⚖️ Тара: 10.5 т
⚖️ Нетто: 20.20 т (обчислюється автоматично)Бот запитає: “Це вірно?”
Ви побачите дві кнопки:
- ✅ Все вірно — дані збережуться
- 🔄 Ввести знову — можна виправити помилку
Крок 5. Підтвердіть або виправте
- Якщо все правильно — натисніть “Все вірно”
- Якщо помилилися — натисніть “Ввести знову” і повторіть введення
💡 Поради та можливі помилки
Поради:
- ✓ Переглядайте всю інформацію про рейс перед підтвердженням
- ✓ Якщо ви відхилили рейс випадково — його можна прийняти пізніше
- ✓ Зважування вводьте уважно — неправильні дані можуть призвести до проблем при розвантаженні
- ✓ Завжди перевіряйте підсумкову інформацію перед натисканням “Все вірно”
- ✓ Використовуйте крапку, а не кому для дробових чисел (
30.2, а не30,2)
⚠️ Можливі помилки:
| Проблема | Причина | Рішення |
|---|---|---|
| Не приходять нові рейси | Рейс відхилений або не призначений | Перевірте “Переглянути рейс”, напишіть диспетчеру |
| Кнопка “Поточний рейс” не з’являється | Рейс не підтверджено | Натисніть “Підтвердити рейс”, спробуйте /start |
| Бот не приймає вагу | Неправильний формат | Використовуйте тільки цифри та крапку: 30.2 ✓ (не 30,2 т ❌) |
| Помилково ввів неправильну вагу | Підтвердили помилкові дані | Зв’яжіться з диспетчером для виправлення |
| Відхилив рейс, але хочу повернути | Рейс відхилено | ”Переглянути рейс” → “Підтвердити рейс” |
🎯 Що ви отримали
Тепер ви знаєте, як працювати з рейсами через Telegram-бот: отримувати повідомлення про нові рейси, переглядати деталі, підтверджувати або відхиляти замовлення, змінювати статуси та вводити дані зважування. Вся робота з рейсами відбувається в одному месенджері без дзвінків та паперової тяганини.
🔄 Повний цикл виконання рейсу
Після введення ваги завантаження рейс переходить у статус “В дорозі”. Водій проходить всі етапи: дорога, прибуття, візування, розвантаження та завершення рейсу з оформленням документів.
🚗 Статус “В дорозі”
Як це працює?
Після того, як ви ввели та підтвердили вагу брутто і тари при завантаженні, система автоматично змінює статус рейсу на “В дорозі”.
Крок 1. Рейс отримав статус “В дорозі”
Натисніть “Поточний рейс”
Ви побачите оновлену інформацію:
⚖️ Вантаж:
Завантажено:
Брутто: 50.0т
Нетто: 45.0т
Тара: 5.0т
Розвантажено: Не вказано
📊 Статус: В дорозіКрок 2. Виберіть дію
Під інформацією про рейс з’являються дві кнопки:
- ⏰ “Затримуюсь” — якщо ви не встигаєте доїхати вчасно
- 📍 “Прибув” — коли ви приїхали на точку розвантаження
⏰ Повідомлення про затримку
Коли використовувати?
Якщо ви розумієте, що не встигаєте доїхати до точки розвантаження в орієнтовний час, вказаний у рейсі, повідомте про це заздалегідь.
Крок 1. Повідомте про затримку
- Натисніть кнопку “Затримуюсь”
- Система зафіксує затримку
- Диспетчер отримає сповіщення
Крок 2. Продовжуйте рух
- Статус рейсу залишається “В дорозі”
- Коли приїдете, натисніть “Прибув”
📍 Прибуття на точку розвантаження
Що відбувається при прибутті?
Коли ви натискаєте “Прибув”, система автоматично надсилає SMS-повідомлення вам і на термінал розвантаження.
Крок 1. Підтвердіть прибуття
- Приїхавши на адресу розвантаження, натисніть “Прибув”
- Статус: змінюється на
Прибув
Крок 2. SMS-повідомлення
Автоматично відбувається:
- 📱 Вам приходить SMS: “Ви прибули на термінал. Очікуйте виклику на візування”
- 📱 Терміналу приходить SMS: “Водій [ваше ім’я] прибув. Автомобіль [номер]“
Крок 3. Очікуйте виклику
- Термінал отримає повідомлення і покличе вас на візування
- Слідкуйте за оголошеннями або чекайте SMS/дзвінка від терміналу
🔬 Візування на терміналі
Що таке візування?
Візування — це процедура перевірки вантажу: беруть аналізи зерна та проводять контрольне зважування. Від результатів залежить, чи приймуть вантаж на розвантаження.
Крок 1. Вас покличуть на візування
- Термінал викличе вас (SMS, оголошення або особисто)
- Поїдьте на пункт візування згідно з інструкціями терміналу
Крок 2. Статус “На візуванні”
Коли ви на пункті візування, статус автоматично оновиться:
Статус: На візуванні
Спеціалісти терміналу:
- 🧪 Візьмуть проби зерна для аналізу
- ⚖️ Можуть провести контрольне зважування
- ✅ Перевірять якість вантажу
Крок 3. Очікуйте результатів аналізів
Якщо аналізи хороші:
- ✅ Вас направлять на розвантаження
- Статус зміниться на “На розвантаженні”
Якщо аналізи не відповідають вимогам:
- ❌ Можуть відмовити в прийомі вантажу
- 📞 Зв’яжіться з диспетчером для подальших інструкцій
📦 Розвантаження вантажу
Як це працює?
Після успішного візування ви їдете на розвантаження. Після розвантаження потрібно ввести дані зважування та прикріпити фото ТТН.
Крок 1. Статус “На розвантаженні”
- Після візування Статус: змінюється на
На розвантаженні - Їдьте на вказану точку розвантаження
- Розвантажте вантаж згідно з інструкціями терміналу
Крок 2. Введіть вагу після розвантаження
- Після розвантаження натисніть “Поточний рейс”
- Бот надішле: “⚖️ Введіть вагу брутто після розвантаження в тоннах”
- Введіть вагу брутто (наприклад,
5.2) - Бот надішле: “⚖️ Тепер введіть вагу тари в тоннах”
- Введіть вагу тари (наприклад,
5.0)
Крок 3. Перевірте дані розвантаження
Бот покаже розрахунок:
⚖️ Брутто: 5.2 т
⚖️ Тара: 5.0 т
⚖️ Нетто: 0.2 т (скільки залишилось після розвантаження)Питання: “Це вірно?”
- ✅ Все вірно — дані збережуться
- 🔄 Ввести знову — виправте помилку
Крок 4. Сфотографуйте ТТН
- Після підтвердження ваги бот попросить: “Прикріпіть фото ТТН”
- Сфотографуйте товарно-транспортну накладну
- Надішліть фото в чат боту
📸 Переконайтеся, що на фото чітко видно:
- Номер ТТН
- Дату
- Вагу
- Підписи та печатки
Крок 5. Завершення рейсу
✅ Після прикріплення фото ТТН
Статус: автоматично змінюється на Розвантажено
🎉 Рейс завершено успішно!
📋 Повна інформація про завершений рейс
Після завершення рейсу ви можете переглянути всю інформацію:
🚛 Рейс # f3e228e1...
🚗 Автомобіль: ВН5903ІС12212131
🚚 Причепи: ВН5534ХІ, ВН5535ХІ
📍 Маршрут:
123 Main Street, Kyiv
↓
456 Oak Street, Lviv
📅 Орієнтовна дата:
2025-03-13 - 2025-03-16 (до 12:00:00)
⚖️ Вантаж:
Завантажено:
Брутто: 50.0т
Нетто: 45.0т
Тара: 5.0т
Розвантажено:
Брутто: 5.2т
Нетто: 0.2т
Тара: 5.0т
📊 Статус: Розвантажено ✅🔄 Схема всіх статусів рейсу (Happy Flow)
| Статус | Опис |
|---|---|
| 1. Оголошено | Рейс створено, очікує підтвердження |
| 2. Прийнято | Ви підтвердили рейс |
| 3. Виїхав на завантаження | Їдете до точки завантаження |
| 4. На завантаженні | Завантажуєтесь і вводите вагу |
| 5. В дорозі | Їдете до точки розвантаження |
| 6. Прибув | Приїхали на термінал |
| 7. На візуванні | Проходите перевірку якості |
| 8. На розвантаженні | Розвантажуєте вантаж |
| 9. Розвантажено ✅ | Рейс завершено |
💡 Поради та можливі помилки
Поради:
- ✓ Повідомляйте про затримку заздалегідь — це допоможе терміналу скоригувати графік
- ✓ Під час візування майте при собі документи на вантаж
- ✓ Фотографуйте ТТН при хорошому освітленні — документ має бути читабельним
- ✓ Зберігайте оригінал ТТН до повного завершення рейсу
- ✓ Перевіряйте дані зважування перед підтвердженням — виправити помилку після завершення складно
⚠️ Можливі помилки:
| Проблема | Причина | Рішення |
|---|---|---|
| SMS не прийшла про прибуття | Не натиснули “Прибув” або немає зв’язку | Перевірте, чи натиснули кнопку, зв’яжіться з диспетчером |
| Не можу перейти до візування | Чекаєте виклику від терміналу | Переконайтеся, що натиснули “Прибув”, зверніться на пропускний пункт |
| Аналізи не пройшли візування | Якість вантажу не відповідає вимогам | Негайно зв’яжіться з диспетчером, дотримуйтесь інструкцій терміналу |
| Бот не приймає фото ТТН | Неправильний формат або розмір файлу | Надсилайте фото (не файл) у форматі JPEG/PNG, до 20 МБ |
| Помилково ввів неправильну вагу | Підтвердили помилкові дані | Якщо не підтвердили — “Ввести знову”, якщо підтвердили — терміново зв’яжіться з диспетчером |
| Забув сфотографувати ТТН | Без фото не можна завершити рейс | Поверніться на термінал за копією, зв’яжіться з диспетчером |
🎯 Що ви отримали
Тепер ви знаєте повний цикл виконання рейсу від підтвердження до завершення. Ви вмієте:
✅ Повідомляти про затримки
✅ Проходити візування
✅ Вводити дані зважування
✅ Оформлювати завершення рейсу з ТТН
Вся робота відбувається через Telegram-бот без зайвих дзвінків та паперової бюрократії! 🚛📱