Типова ситуація: інтернет-магазин витрачає місяць на налаштування 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 Bot API | Push-сповіщення (FCM/APNs) |
|---|---|---|
| Дозволи | Лише /start, без системного діалогу | Вимагає дозволу, користувач може вимкнути |
| Доставка | Висока, через сервери Telegram | Може блокуватися на пристрої |
| Інтерактивність | Inline-клавіатури, callback queries | Лише текст або зображення |
| Вартість | Безплатно (обмеження на запити) | Безплатно у FCM, APNs вимагає акаунта розробника |
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 з автоматичним продовженням?
- Отримайте токен бота у BotFather.
- Створіть HTTPS endpoint на своєму сервері, використовуючи Nginx та Let's Encrypt.
- Встановіть webhook запитом:
curl -F "url=https://yourdomain.com/webhook" https://api.telegram.org/bot{TOKEN}/setWebhook - Налаштуйте обробку вхідних повідомлень та callback_query.
- Перевірте статус:
curl https://api.telegram.org/bot{TOKEN}/getWebhookInfo
Ми автоматизуємо ці кроки та покриваємо тестами сценарії помилок.
Процес роботи: від аналітики до деплою
| Етап | Дії | Результат |
|---|---|---|
| Аналітика | Вивчення бізнес-логіки, типів сповіщень | Схема інтеграції |
| Проектування | Визначення endpoint'ів, команд, deep link | Архітектура |
| Реалізація | Розробка webhook, обробників, мобільного UI | Робочий прототип |
| Тестування | Перевірка на iOS/Android, сценаріїв помилок | Звіт про тестування |
| Деплой | Публікація бота в Telegram, налаштування вебхука | Запуск у production |
Що входить в роботу
В рамках інтеграції ви отримуєте:
- Серверний модуль обробки webhook з підтримкою callback query та inline-клавіатур.
- Deep link для автоматичної прив'язки облікового запису.
- Налаштування бота в BotFather та реєстрацію команд.
- Документацію з використання API та взаємодії з ботом.
- Технічну підтримку протягом тижня після деплою.
- Можливість інтеграції Telegram Web App для інтерактивних форм.
Строки та вартість
Інтеграція з базовим функціоналом (сповіщення, deep link, inline-клавіатури) займає від 3 до 5 робочих днів. Складні проекти з Telegram Web App — до 10 днів. Вартість розраховується індивідуально, залежно від обсягу робіт. Отримайте консультацію — ми оцінимо ваш проект протягом дня. Залиште заявку на нашому сайті.
Гарантуємо стабільну роботу та відповідність правилам (розділи 4.2, 5.1). Зв'яжіться з нами для обговорення деталей.