Інтеграція Telegram Bot API в мобільний додаток

Типова ситуація: інтернет-магазин витрачає місяць на налаштування FCM/APNs, а потім половина користувачів вимикає push-сповіщення. Telegram Bot API вирішує обидві проблеми: не вимагає push-сертифікатів і забезпечує понад 90% доставки навіть при обмеженнях ОС. Ми розробляємо інтеграцію Telegram Bot API для мобільних додатків — це канал сповіщень, який працює без системних дозволів та додаткових згод. Одна з головних проблем — отримати chat_id для надсилання повідомлень. Вирішується deep link з параметром: користувач переходить за посиланням і миттєво прив'язується. Друга складність — webhook, який вимагає HTTPS та стабільного endpoint. Ми налаштовуємо його з автоматичним продовженням сертифікатів через Let's Encrypt та обробкою таймаутів з механізмом повторних викликів. За час роботи реалізували понад 30 інтеграцій для e-commerce, fintech та логістики.

Як працює інтеграція?

Користувач натискає «Підключити Telegram» у мобільному додатку. Відкривається deep link виду https://t.me/YourBot?start=user_uuid_12345. Після надсилання команди /start бот отримує chat_id, а параметр start дозволяє зіставити його з обліковим записом. Бекенд зберігає зв'язку і готовий надсилати сповіщення. Прив'язка акаунта займає один клік.

Чому Telegram Bot API вигідніший за push-сповіщення?

Telegram-боти забезпечують до 2 разів більше відкриттів порівняно з push-сповіщеннями. Економія на інфраструктурі сповіщень сягає 70%.

Які проблеми вирішуємо

Отримання chat_id

Без deep link користувачеві потрібно вручну вводити код. Наше рішення: deep link виду t.me/Bot?start=uuid — бот отримує chat_id і параметр, бекенд пов'язує їх за секунду. Це виключає помилки ручного введення.

Налаштування webhook

Webhook має бути на HTTPS і обробляти таймаути. Ми використовуємо автоматичне продовження сертифікатів через Let's Encrypt та чергу для повторних викликів при помилках 502. Час відгуку endpoint не має перевищувати 2 секунд, інакше Telegram блокує запит.

Обробка callback query

У високонавантажених системах бот може отримувати сотні callback'ів за секунду. Ми застосовуємо асинхронну обробку та відповідаємо answerCallbackQuery протягом 2 секунд, інакше Telegram показує помилку на стороні користувача.

Як влаштоване надсилання сповіщень на прикладі замовлень

Для інтернет-магазину ми реалізували надсилання сповіщень про статус замовлення. Принцип:

POST https://api.telegram.org/bot{TOKEN}/sendMessage
{
  "chat_id": 123456789,
  "text": "Ваше замовлення #98765 передано в доставку 🚚",
  "parse_mode": "HTML",
  "reply_markup": {
    "inline_keyboard": [[
      { "text": "Відстежити", "url": "https://yourbrand.com/track/98765" },
      { "text": "Зв'язатися", "callback_data": "contact_support_98765" }
    ]]
  }
}

Після натискання «Зв'язатися» бекенд отримує callback query: {"callback_query":{"data":"contact_support_98765","from":{"id":123456789},"message":{"message_id":456,"chat":{"id":123456789}}}} і відповідає викликом answerCallbackQuery, з'єднуючи з підтримкою.

Як налаштувати webhook з автоматичним продовженням?

1. Отримайте токен бота у BotFather.
2. Створіть HTTPS endpoint на своєму сервері, використовуючи Nginx та Let's Encrypt.
3. Встановіть webhook запитом: curl -F "url=https://yourdomain.com/webhook" https://api.telegram.org/bot{TOKEN}/setWebhook
4. Налаштуйте обробку вхідних повідомлень та callback_query.
5. Перевірте статус: curl https://api.telegram.org/bot{TOKEN}/getWebhookInfo

Ми автоматизуємо ці кроки та покриваємо тестами сценарії помилок.

Процес роботи: від аналітики до деплою

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

В рамках інтеграції ви отримуєте:

• Серверний модуль обробки webhook з підтримкою callback query та inline-клавіатур.
• Deep link для автоматичної прив'язки облікового запису.
• Налаштування бота в BotFather та реєстрацію команд.
• Документацію з використання API та взаємодії з ботом.
• Технічну підтримку протягом тижня після деплою.
• Можливість інтеграції Telegram Web App для інтерактивних форм.

Строки та вартість

Інтеграція з базовим функціоналом (сповіщення, deep link, inline-клавіатури) займає від 3 до 5 робочих днів. Складні проекти з Telegram Web App — до 10 днів. Вартість розраховується індивідуально, залежно від обсягу робіт. Отримайте консультацію — ми оцінимо ваш проект протягом дня. Залиште заявку на нашому сайті.

Гарантуємо стабільну роботу та відповідність правилам (розділи 4.2, 5.1). Зв'яжіться з нами для обговорення деталей.

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-сповіщень у мобільному застосунку — ми зв'яжемося з вами протягом дня та надамо точну оцінку.