Разработка бота для трекинга доставки в мобильном приложении

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

Посылка стоит на таможне третий день — пользователь узнаёт об этом случайно, потому что на сайте транспортной компании последнее обновление «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)
• Почта России: трекинг через SOAP-эндпоинт tracking.russianpost.ru/rtm34
• 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 на несколько часов, Почта России SOAP-эндпоинт бывает недоступен днями.

Стратегия: 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 или кастомном бэкенде составляет от 100 000 до 250 000 рублей в зависимости от сложности фильтров.

Нормальная сегментация строится на нескольких уровнях.

Топики — для широких категорий: «новые акции», «обновления статуса заказа». Пользователь подписывается через 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 на событие открытия. Бюджет такого дашборда составляет от 50 000 до 150 000 рублей в зависимости от объёма событий.

Как мы внедряем 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.

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