Посібник із налаштування 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. Надішліть команду @BotFather: /newbot.
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)