Руководство по настройке push-уведомлений Telegram

Принципы настройки и структура API

Отправка сообщений Telegram реализуется на основе Telegram Bot API. Полный URL для отправки формируется путем объединения Bot Token (ключ доступа бота) и Chat ID (уникальный идентификатор получателя).

Стандартный шаблон сборки:

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Шаги получения

Шаг 1: создайте бота и получите Bot Token

1. Откройте Telegram, введите в строке поиска и подпишитесь на официального бота @BotFather.
2. Отправьте команду /newbot боту @BotFather.
3. Последовательно введите данные согласно подсказкам:
   • Bot Name: отображаемое имя бота (например: помощник уведомлений).
   • Bot Username: уникальное имя пользователя бота (должно заканчиваться на bot, например: my_notice_bot).
4. После успешного создания @BotFather выдаст учетные данные для доступа к API. Скопируйте строку HTTP API Token (например, в формате 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Шаг 2: получите Chat ID получателя

Выберите подходящий способ получения в зависимости от типа получателя сообщений (личный аккаунт или группа):

Вариант A: получение уведомлений на личный аккаунт

• Способ 1: через официального бота для запроса данных (рекомендуется)
  1. Найдите в Telegram и подпишитесь на @userinfobot.
  2. Отправьте ему любое сообщение или нажмите /start.
  3. Бот вернет метаданные личного аккаунта; чистое число после Id и будет вашим личным Chat ID (например: 987654321).
• Способ 2: через запрос к API
  1. Самостоятельно отправьте сообщение только что созданному боту (например: hello), чтобы активировать диалог.
  2. Откройте браузер и перейдите по следующей ссылке (замените <TOKEN> на учетные данные, полученные на шаге 1):

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. В возвращенном JSON-ответе извлеките числовое значение "result" -> "message" -> "chat" -> "id".

Вариант B: получение уведомлений в группе/канале

1. Добавьте нового бота в целевую группу Telegram.
2. Отправьте в группе любое сообщение (например: test) или выдайте боту права администратора.
3. Перейдите в браузере по следующей ссылке (замените <TOKEN> на учетные данные, полученные на шаге 1):

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. В возвращенном JSON-ответе найдите запись, содержащую название соответствующей группы, и извлеките поле "chat" -> "id".

   Примечание: Chat ID группы обычно является отрицательным числом, начинающимся с - или -100 (например: -100123456780); при сборке необходимо полностью сохранить знак минус и префикс.

3. Примеры сборки URL

После получения <TOKEN> и <CHAT_ID> подставьте их в стандартный шаблон:

1. Пример URL для личного уведомления

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: 987654321
• Итоговый результат сборки:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Пример URL для уведомления группы

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: -7
• Итоговый результат сборки:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)