Інтеграція Telegram з сайтом: сповіщення, боти та аутентифікація

Втрата замовлення через те, що менеджер не перевірив email?

Менеджер втрачає до 30% замовлень, тому що листи потрапляють у спам. Клієнт пішов до конкурента через десять хвилин після залишеної заявки — ви просто не встигли відповісти. Ми вирішуємо цю проблему: інтегруємо Telegram-ботів для миттєвих сповіщень, автоматизації та аутентифікації. Telegram не спамить, 99% повідомлень доставляються за секунду — email програє за всіма фронтами. Telegram забезпечує open rate 95-99% проти 20-30% у email — це в 3-5 разів вище. Заміна поштових сповіщень на Telegram скорочує середній час реакції менеджера з 5 хвилин до 10 секунд. Згідно з Telegram Bot API Documentation (https://core.telegram.org/bots/api), боти можуть відправляти мільйони повідомлень без додаткових витрат.

Порівняння Telegram, email та SMS

Telegram дає 100% контроль: ви не залежите від поштових провайдерів та операторів зв'язку. Для сповіщень про замовлення, збої або заявки це критично.

Отримайте консультацію з інтеграції Telegram для вашого проекту.

Які сценарії інтеграції Telegram найбільш затребувані?

Сповіщення: від замовлення до Telegram

Найбільш затребуваний сценарій — сповіщення адміністраторам та менеджерам. Відправляємо повідомлення через sendMessage з HTML-розміткою:

class TelegramNotifier { public function send(string $message, string $parseMode = 'HTML'): void { Http::post("https://api.telegram.org/bot{$this->token}/sendMessage", [ 'chat_id' => config('services.telegram.chat_id'), 'text' => $message, 'parse_mode' => $parseMode ]); } } // Використання $telegram->send( "🛒 <b>Новий заказ #{$order->id}</b>\n" . "Сума: {$order->total} ₴\n" . "Клієнт: {$order->customer_name}" ); 

Підтримуємо будь-які CMS: WordPress, Laravel, Drupal, та фреймворки: React, Vue, Angular. Для сповіщень у групу: бот повинен бути адміністратором, chat_id групи — від'ємне число. При помилках (наприклад, chat_id невірний) повторюємо відправку з експоненціальною затримкою.

Приклад з практики: для інтернет-магазину меблів ми налаштували сповіщення про нові замовлення в Telegram-групу менеджерів. У результаті час реакції скоротився з 5 хвилин до 15 секунд, а кількість втрачених замовлень зменшилася на 40%. Інтеграція окупилася за перший місяць роботи (вартість інтеграції склала 5000 грн, а економія від зменшення втрат – близько 2000 грн на місяць).

Інтерактивний бот для обробки заявок

Inline-клавіатури дозволяють менеджерам приймати рішення прямо в Telegram. Приклад:

Http::post("https://api.telegram.org/bot{$token}/sendMessage", [ 'chat_id' => $chatId, 'text' => "Заявка #{$applicationId} отримана. Що зробити?", 'reply_markup' => json_encode([ 'inline_keyboard' => [[ ['text' => '✅ Прийняти', 'callback_data' => "accept_{$applicationId}"], ['text' => '❌ Відхилити', 'callback_data' => "reject_{$applicationId}"] ]] ]) ]); 

При натисканні кнопки бот отримує callback_query, оновлює статус заявки на сайті та підтверджує дію. Бот може не тільки відправляти повідомлення, але й виконувати дії: приймати заявки, закривати задачі. Використовуємо webhook з secret_token для безпеки.

Telegram Login Widget: аутентифікація за 5 хвилин

Користувачі можуть входити на сайт через Telegram без введення пароля. На стороні фронтенду — вбудовуємо кнопку:

<script async src="https://telegram.org/js/telegram-widget.js?22" data-telegram-login="YourBotName" data-size="large" data-auth-url="URL вашого сайту" data-request-access="write"> </script> 

Сервер перевіряє підпис через HMAC-SHA256:

public function callback(Request $request): void { $checkHash = $request->hash; $authData = $request->except('hash'); ksort($authData); $dataCheckString = implode("\n", array_map( fn($k, $v) => "{$k}={$v}", array_keys($authData), $authData )); $secretKey = hash('sha256', config('services.telegram.bot_token'), true); $hash = hash_hmac('sha256', $dataCheckString, $secretKey); if (!hash_equals($hash, $checkHash)) { abort(403, 'Invalid Telegram signature'); } // Авторизація користувача } 

Віджет дозволяє аутентифікувати користувача без введення пароля. Після успішної аутентифікації створюється сесія, що знижує навантаження на підтримку: користувачі не забувають паролі.

Налаштування вебхуку за 3 кроки

1. Відправте POST-запит на https://api.telegram.org/bot<TOKEN>/setWebhook з параметром url, що вказує на ваш endpoint (обов'язково HTTPS).
2. Вкажіть секретний токен у параметрі secret_token — Telegram передаватиме його в заголовку X-Telegram-Bot-Api-Secret-Token при кожному запиті.
3. На сервері реалізуйте перевірку токена та обробку вхідних оновлень. Рекомендуємо використовувати бібліотеку Telegram Bot SDK для Laravel або pyTelegramBotAPI для Python.

Telegram доставляє повідомлення в 30 разів швидше SMS (менше 1 секунди проти 1-5 секунд). Це робить його ідеальним каналом для критичних сповіщень.

Захист вебхука від підроблених запитів

Для захисту використовуйте секретний токен при встановленні вебхука (параметр secret_token). Telegram передає його в заголовку X-Telegram-Bot-Api-Secret-Token на кожен запит. Порівняйте його з вашим токеном на сервері. Також можна перевіряти IP-адреси Telegram (список публікується). Ми завжди додаємо цей захист.

// config/services.php 'telegram' => [ 'bot_token' => env('TELEGRAM_BOT_TOKEN'), 'webhook_secret' => env('TELEGRAM_WEBHOOK_SECRET'), ]; // routes/api.php Route::post('/telegram/webhook', [TelegramController::class, 'webhook']); // App/Http/Controllers/TelegramController.php public function webhook(Request $request) { if ($request->header('X-Telegram-Bot-Api-Secret-Token') !== config('services.telegram.webhook_secret')) { abort(403); } // Handle update... } 

Процес роботи над інтеграцією

• Аналіз: вивчаємо ваші бізнес-процеси, обираємо сценарії (сповіщення, бот, аутентифікація).
• Проектування: розробляємо архітектуру, схеми даних, діаграми послідовності.
• Реалізація: пишемо код бота, налаштовуємо вебхук, інтегруємо з вашою CMS.
• Тестування: unit-тести кожного обробника, інтеграційні тести з реальним Telegram API.
• Деплой: розгортаємо на сервері, налаштовуємо моніторинг, логування.

Терміни інтеграції

Терміни розраховуються індивідуально: залежить від складності вашої логіки та архітектури сайту.

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

• Налаштування бота та вебхука
• Реалізація сценаріїв сповіщень (замовлення, події, помилки)
• Інтеграція Telegram Login Widget
• Розробка обробників callback_query
• Покриття тестами (unit + інтеграційні)
• Документація (схеми, приклади запитів)
• Доступ до вихідного коду та деплой-інструкцій
• Навчання адміністраторів та розробників

Чому варто працювати з нами

Ми 5+ років інтегруємо Telegram з сайтами, реалізували 40+ проектів у цій ніші. Досвід з будь-якими стеками: Laravel, Django, React, Next.js. Гарантуємо стабільну роботу навіть при високому навантаженні. Прозора звітність та підтримка після здачі. Вартість інтеграції базових сповіщень починається від 5000 грн.

Інтеграція Telegram-сповіщень може принести додатковий дохід для середнього інтернет-магазину за рахунок скорочення втрат клієнтів. Бот обробляє до 500 звернень на день, заощаджуючи ресурси на роботі операторів.

Telegram забезпечує open rate до 99%, що в 3–5 разів вище, ніж у email (20–30%). Це означає, ви не втратите жодного замовлення. Зв'яжіться з нами для оцінки вашого проекту — ми запропонуємо оптимальне рішення. Замовте інтеграцію Telegram і забудьте про втрачені заявки.