RouteHook setup diagram with three steps: buy relay, keep webhook, replace Bot API URL

Если Telegram-бот уже работает, самый удобный сценарий подключения к RouteHook - не переносить проект и не переписывать webhook. Обычно достаточно оставить текущий webhook и заменить базовый адрес Bot API в исходящих запросах.

Начать подключение можно в Telegram: @RouteHookBot.

Что понадобится

  • bot token вашего Telegram-бота;
  • рабочий HTTPS webhook, если бот принимает входящие updates;
  • место в коде, где задается базовый URL Bot API.

Bot token нужен RouteHook для настройки relay. В интерфейсе он не показывается обратно.

Шаг 1. Купить relay

Откройте @RouteHookBot и нажмите Купить relay.

Одна оплата подключает один relay для одного Telegram-бота. После оплаты бот предложит добавить Telegram-бота.

Шаг 2. Отправить bot token

Нажмите Добавить бота и отправьте token в формате:

123456789:AA...

RouteHook проверит token через Telegram getMe и посмотрит текущий webhook через getWebhookInfo.

Шаг 3. Оставить текущий webhook

Если webhook уже есть, выберите Оставить текущий webhook.

В этом режиме ваш сервер продолжит получать обычные Telegram updates. RouteHook просто станет промежуточным слоем между Telegram и вашим webhook.

Новый webhook URL нужно указывать только если вы точно хотите заменить downstream webhook и новый адрес уже принимает Telegram updates.

Шаг 4. Заменить Bot API URL в коде

После подключения RouteHook выдаст:

API base URL: https://routehook.ipcfg.com/<public_id>

В PHP это обычно выглядит так.

Было:

$apiUrl = 'https://api.telegram.org/bot' . $botToken . '/';

Стало:

$apiUrl = 'https://routehook.ipcfg.com/<public_id>/bot' . $botToken . '/';

Остальной код можно не трогать. Если дальше у вас есть вызовы вроде:

file_get_contents($apiUrl . 'sendMessage?' . http_build_query($params));

они продолжат работать через relay.

Если webhook не нужен

Для ботов, которые только отправляют сообщения и не принимают входящие updates, выберите API-only, webhook не нужен.

В этом режиме RouteHook не назначает webhook в Telegram и выдает только API base URL для исходящих Bot API запросов.

Как проверить

После подключения откройте Мой доступ, выберите бота и нажмите Проверить.

То же самое можно сделать командой:

/checkbot <public_id>

Проверка покажет текущий Telegram webhook, pending updates и последнюю ошибку доставки, если она есть.

Короткая логика такая: webhook оставляем, Bot API URL меняем, работу проверяем через /checkbot.

Подключить своего бота можно здесь: @RouteHookBot.