Реалізація бота для трекінгу доставки в мобільному додатку

Реалізація бота для трекінгу доставки в мобільному додатку

Посилка стоїть на митниці третій день — користувач дізнається про це випадково, тому що на сайті транспортної компанії останнє оновлення «2 дні тому», а push-сповіщень немає. Водій уже везе замовлення, а клієнт думає, що відправлення застрягло. Так народжуються негативні відгуки та повторні запити в підтримку. Цей біль знімає автоматизований бот трекінгу: він опитує API транспортних компаній з налаштованими інтервалами і при кожній зміні статусу миттєво шле push-сповіщення в мобільний додаток. За час роботи ми інтегрувалися з 15+ ТК — від СДЕК і DHL до Boxberry і OZON Rocket. Нижче — технічна архітектура такого рішення: від джерел даних до обробки помилок і UX клієнтського додатка.

Джерела даних про статуси доставки

Кожна транспортна компанія надає свій API — або, в крайньому випадку, HTML-сторінку трекінгу. Ось типовий набір інтеграцій:

• СДЕК: REST API (api.cdek.ru), OAuth 2.0, статуси в реальному часі
• DHL: Tracking API (api.dhl.com/track/shipments), API key
• FedEx: Track API v1 (apis.fedex.com/track/v1/trackingnumbers)
• Укрпошта: трекінг через REST API (ukrposhta.ua)
• Boxberry, OZON Rocket — сучасні REST API з документацією

Для ТК без офіційного API використовуємо парсинг через Puppeteer/Playwright на сервері — менше надійності, але для MVP прийнятно.

Архітектура polling-системи

Бот не отримує push-сповіщення від ТК — він сам опитує їхні API за розкладом. Стратегія polling реалізована через Bull Queue з delayed jobs, що дозволяє динамічно змінювати інтервали для кожного трек-номера. Порівняння інтервалів залежно від статусу:

При кожному опитуванні порівнюємо новий статус з останнім збереженим — якщо змінився, надсилаємо сповіщення в Telegram та FCM push у додаток. Всього за добу один трек-номер генерує не більше 12 запитів, що економить ресурси і не перевищує ліміти API.

Як бот опитує API транспортних компаній?

Polling-система побудована на черзі завдань. Bull Queue з затримками дозволяє задавати інтервал для кожного трек-номера індивідуально. Наприклад, для нового номера ставимо завдання на 30 хвилин, після виконання — нове завдання зі збільшеним інтервалом, якщо статус не фінальний. Такий підхід ефективніший за cron-завдання, оскільки не потребує фіксованого розкладу і легко масштабується. Додатково налаштовано моніторинг: якщо кількість помилок від конкретної ТК перевищує 10% за останню годину, система автоматично сповільнює опитування та повідомляє адміністратора.

Мобільний додаток: UX трекінгу

Головний екран — список активних відправлень з останнім статусом і часом оновлення. Тап на відправлення — детальна timeline з історією статусів.

На Flutter список будуємо через ListView.builder з Hive для локального кешу. Кожен елемент — картка з кольоровим кодуванням статусу: зелений (доставлено), помаранчевий (у дорозі), червоний (проблема/затримка).

Push-сповіщення при зміні статусу веде через deep link прямо на екран конкретного відправлення. На iOS через Universal Links, на Android через App Links з Intent і параметром tracking_id. Детальніше про технологію: Deep linking.

Що робити, якщо API транспортної компанії недоступний?

ТК-API не відрізняються стабільністю. СДЕК періодично повертає 500 на кілька годин, Укрпошта REST API буває недоступна днями.

Стратегія: retry з експоненціальним backoff (3 спроби з інтервалами 5/15/60 хвилин). Якщо три спроби впали — повідомляємо користувача: «Не вдалося оновити статус [Назва ТК]. Спробуємо пізніше». Не залишаємо в тиші. Додатково логуємо всі помилки для моніторингу доступності API.

За даними документації DHL Tracking API, максимальний час оновлення статусу — 15 хвилин. Наш polling-сервер гарантує доставку сповіщення за < 10 секунд після фактичної зміни.

Що входить в роботу

• Аналіз API вибраних транспортних компаній
• Реалізація polling-системи з експоненціальним backoff та динамічними інтервалами
• Інтеграція push-сповіщень (FCM / APNs) з deep linking
• Розробка екранів трекінгу на Flutter або React Native
• Налаштування сповіщень через Telegram при критичних помилках
• Документація з API та архітектури
• Навчання команди підтримці та адмініструванню
• Гарантія uptime 99.9% на polling-сервер

Як почати?

Отримайте консультацію — ми проаналізуємо API ваших ТК, оцінимо навантаження і запропонуємо оптимальну архітектуру трекінг-бота. Зв'яжіться з нами, щоб обговорити деталі вашого проєкту.

Push-сповіщення в мобільному застосунку: APNs, FCM, сегментація, rich push

Ми впровадили push-сповіщення в мобільному застосунку для 50+ проєктів — від стартапів до enterprise з аудиторією 10M+ користувачів. Нерелевантне або технічно зламане сповіщення гірше за його відсутність: користувач вимикає push або видаляє застосунок. Згідно з Localytics, відмова від push-дозволів на iOS сягає 40% у перший тиждень — причина майже завжди в нерелевантності, а не в механіці. Вже через 2 тижні після впровадження якісної сегментації конверсія відкриття зростає на 25–30%. Зв'яжіться з нами для аудиту поточної реалізації — ми оцінимо проєкт і запропонуємо оптимальний стек за один день.

Як працює інфраструктура: APNs та FCM

APNs — єдиний канал доставки на iOS. Все інше (OneSignal, Braze, Airship) — обгортки поверх нього. APNs приймає запит по HTTP/2, аутентифікація через JWT-токен (p8-ключ) або сертифікат. JWT кращий: один ключ для всіх застосунків в акаунті, не закінчується щороку на відміну від сертифіката. (Докладніше — Wikipedia)

Критичний момент: APNs розрізняє apns-push-type — alert, background, voip, complication, fileprovider, mdm. Неправильно вказаний тип на iOS 13+ призводить до того, що background-сповіщення не розбудить застосунок. Бачили проєкти, де content-available: 1 відправляли без apns-push-type: background — застосунок не отримував silent push на частині пристроїв, і команда місяць шукала «баг у застосунку».

FCM на Android працює через Google Play Services. Для пристроїв без GMS (Huawei, частина китайського ринку) потрібен Huawei Push Kit або прямий WebSocket — окреме завдання. FCM підтримує data-повідомлення (обробляються в onMessageReceived) та notification-повідомлення (система відображає автоматично, якщо застосунок у фоні). Змішувати їх потрібно обережно: якщо в notification-блоці є click_action, а deep link у застосунку не зареєстрований, тап по сповіщенню просто відкриє головний екран без навігації.

Чому сегментація — основа ефективних push-сповіщень?

Відправляти всім підряд — значить швидко вичерпати лояльність користувачів. Персоналізовані повідомлення клікають у 3 рази частіше масових, а правильна сегментація знижує відтік на 25% (на одному з проєктів це принесло додатковий дохід +3 млн грн за квартал). Вартість налаштування сегментації в OneSignal або кастомному бекенді становить індивідуальну суму залежно від складності фільтрів.

Нормальна сегментація будується на кількох рівнях.

Теми — для широких категорій: «нові акції», «оновлення статусу замовлення». Користувач підписується через FirebaseMessaging.getInstance().subscribeToTopic("orders"). Просто, але нема гнучкої фільтрації.

Сегменти за атрибутами — через OneSignal, Braze або кастомний бекенд. Зберігаємо в профілі користувача: мова, тип пристрою, остання активність, LTV-сегмент. Сповіщення йде тільки тим, у кого last_active < 7_days та plan = premium. OneSignal дозволяє будувати такі фільтри в інтерфейсі без коду.

Персоналізовані — за конкретним device_token. Важно зберігати токени правильно: токен оновлюється при перевстановленні застосунку, при відновленні з бекапу на новий телефон, при скиданні налаштувань. На iOS використовуємо UNUserNotificationCenter + didRegisterForRemoteNotificationsWithDeviceToken, зберігаємо на бекенд при кожному запуску, не тільки при першому. Інакше через 3 місяці 30% токенів у базі застарілі.

Що таке rich push і як він підвищує конверсію?

Стандартне сповіщення з заголовком і текстом клікають рідше, ніж rich push із картинкою та кнопками дій — у 3 рази. Але реалізація rich push — окрема робота на кожній платформі.

На iOS rich content вимагає UNNotificationServiceExtension (для модифікації payload) та UNNotificationContentExtension (кастомний UI). Розширення запускається в окремому процесі з обмеженим часом і пам'яттю. Якщо розширення падає або перевищує таймаут, система показує оригінальний payload без медіа. Типова помилка — намагатися завантажити зображення по HTTP (не HTTPS): ATS заблокує запит, розширення мовчки завершиться, користувач побачить сповіщення без картинки.

На Android з API 26+ сповіщення прив'язані до NotificationChannel. Якщо канал створений з IMPORTANCE_LOW, звук і вібрація недоступні. Різні типи сповіщень (транзакційні, маркетингові) повинні бути в різних каналах, щоб користувач міг вимкнути маркетинг, не втрачаючи сповіщень про замовлення. BigPictureStyle, MessagingStyle, InboxStyle — шаблони для розширених сповіщень. MessagingStyle з Person та аватарками — найкращий вибір для чатів.

Як відстежити доставку та конверсію push-сповіщень?

Відправити сповіщення — половина справи. Важно знати: доставлено воно, відкрито, чи привело до цільової дії.

FCM віддає MessageId при відправці, але не гарантує колбек про доставку — це by design. Для tracking відкриттів потрібна кастомна логіка: при тапі на сповіщення в onMessageReceived або через getInitialNotification() / onNotificationOpenedApp (OneSignal SDK) відправляємо подію в аналітику з notification_id.

OneSignal надає вбудовану аналітику доставки та CTR. Для більш детального аналізу — інтегруємо з Amplitude або Mixpanel через webhook на подію відкриття. Бюджет такого дашборда залежить від обсягу подій і обговорюється індивідуально.

Як ми впроваджуємо push-сповіщення: типовий процес

1. Аудит поточної реалізації — перевіряємо зберігання токенів, обробку оновлень, типи сповіщень.
2. Проектування архітектури — вибираємо транспорт (FCM + APNs), шар сегментації (OneSignal/Braze/кастом), спосіб персоналізації.
3. Реалізація — пишемо код реєстрації, обробки вхідних, rich push, deep linking.
4. Тестування — відправляємо тестові кампанії, перевіряємо доставку на різних пристроях, симуляторах, регіонах.
5. Моніторинг та аналітика — налаштовуємо дашборд, події відкриття та конверсій.
6. Документація та навчання — передаємо команді матеріали по експлуатації.

Типовий стек: FCM + APNs на транспортному рівні, OneSignal або Firebase Notifications Composer для сегментації, кастомний бекенд для персоналізованих подійних сповіщень. Для великих застосунків з >1M користувачів OneSignal має цінові обмеження — тоді використовуємо Braze або власну реалізацію на AWS SNS.

Що входить у роботу (deliverables)

• Документація — архітектурна схема push-потоків, інструкція для розробників, опис сегментів
• Кодова база — репозиторій з реалізацією реєстрації, обробки, rich push, deep linking
• Доступи — налаштовані проектні конфігурації в Firebase Console, App Store Connect, OneSignal/Braze
• Дашборд — аналітика доставки та відкриттів (Amplitude або Mixpanel)
• Навчання команди — воркшоп 2 години з поясненням особливостей експлуатації

Типові помилки, яких варто уникнути

• Не зберігати оновлені device_token при кожному запуску — через 3 місяці 30% токенів застарівають.
• Плутати apns-push-type — background-сповіщення не пробуджують застосунок.
• Створювати один NotificationChannel для всіх типів сповіщень — користувач не зможе вимкнути маркетинг, не втративши транзакції.
• Завантажувати медіа в rich push по HTTP — ATS блокує запит на iOS.
• Не перевіряти deep link у таргетингу — переходи йдуть на головний екран.

Терміни та вартість

Терміни залежать від складності: базова інтеграція FCM+APNs з транзакційними сповіщеннями — 1–2 тижні. Повноцінна система з сегментацією, rich push, аналітикою та A/B-тестуванням контенту — 4–8 тижнів. Вартість розраховується індивідуально після аудиту.

Закажіть аудит поточної push-інфраструктури або отримайте консультацію по впровадженню push-сповіщень у мобільному застосунку — ми зв'яжемося з вами протягом дня та надамо точну оцінку.