> For the complete documentation index, see [llms.txt](https://docs.ispecalgo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ispecalgo.com/isa-terminal/baza-znanii/kak-poluchat-uvedomleniya-v-telegram.md).

# Telegram-уведомления

ISA Terminal может отправлять в Telegram события терминала и торговых ботов. Уведомления удобны при работе на VPS, но не заменяют проверку [логов](/isa-terminal/baza-znanii/logirovanie-v-isa.md).

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

* собственный Telegram-бот;
* токен этого бота;
* `chat_id` личного чата или группы;
* доступ к настройкам ISA Terminal.

## 1. Создайте Telegram-бота

1. Откройте официальный бот [@BotFather](https://t.me/BotFather).
2. Отправьте команду `/newbot`.
3. Укажите имя и username бота.
4. Сохраните выданный токен.
5. Откройте созданного бота и отправьте ему `/start`.

Токен даёт право управлять ботом. Не отправляйте его в чаты, поддержку и сторонние сервисы.

## 2. Подготовьте нужный чат

### Личный чат

Откройте созданного бота, нажмите **Start** и отправьте `/start`.

### Группа

1. Добавьте своего бота в группу.
2. Убедитесь, что ему разрешено отправлять сообщения.
3. Отправьте в группе команду с упоминанием бота, например `/start@ИмяВашегоБота`.

## 3. Получите `chat_id` через официальный Telegram API

Не вставляйте токен в адресную строку браузера: он может сохраниться в истории. Безопаснее выполнить запрос через PowerShell с интерактивным вводом.

Откройте PowerShell и выполните:

```powershell
$secret = Read-Host "Bot token" -AsSecureString
$token = [Net.NetworkCredential]::new("", $secret).Password

$updates = Invoke-RestMethod `
  -Method Post `
  -Uri "https://api.telegram.org/bot$token/getUpdates"

$updates | ConvertTo-Json -Depth 10
```

В ответе найдите `message.chat.id` или `my_chat_member.chat.id` нужного чата.

* личный `chat_id` обычно положительный;
* ID группы или супергруппы обычно отрицательный, часто начинается с `-100`.

Если массив `result` пустой, отправьте боту или группе ещё одну команду и повторите запрос.

## 4. Проверьте токен и `chat_id`

Пока PowerShell остаётся открытым, выполните:

```powershell
$chatId = [int64](Read-Host "chat_id")

Invoke-RestMethod `
  -Method Post `
  -Uri "https://api.telegram.org/bot$token/sendMessage" `
  -ContentType "application/json" `
  -Body (@{
    chat_id = $chatId
    text = "Проверка уведомлений ISA Terminal"
  } | ConvertTo-Json)

Remove-Variable token, secret, updates, chatId
```

Если Telegram вернул `"ok": true` и сообщение появилось в нужном чате, данные подходят.

Все запросы в этом способе отправляются напрямую на официальный домен `api.telegram.org`. Не используйте сайты и сторонних ботов, которые просят прислать токен для определения `chat_id`.

## 5. Настройте ISA Terminal

1. Нажмите значок аккаунта в правом верхнем углу.
2. Откройте **Настройки → Уведомления**.
3. Вставьте токен Telegram-бота.
4. Укажите `chat_id`.
5. Выберите события, которые хотите получать.
6. Сохраните настройки.

Терминал поддерживает уведомления по действиям с ордерами и позициями, изменениям позиции, ошибкам подключения, watchdog, funding и ошибкам логов.

Отдельной кнопки проверки в интерфейсе нет. При сохранении ISA Terminal проверяет токен и пытается отправить в указанный чат сообщение об успешном подключении.

> Успешное сохранение ещё не гарантирует доставку сообщения: отправка выполняется отдельно. Если подтверждение не пришло, проверьте `chat_id`, права бота в группе и общие логи терминала.

## Если уведомления не приходят

Проверьте:

* вы отправили боту `/start`;
* токен скопирован полностью;
* `chat_id` указан без пробелов;
* для группы используется отрицательный `chat_id`;
* бот состоит в группе и может отправлять сообщения;
* выбрано хотя бы одно событие;
* терминал имеет доступ к интернету;
* в общих логах нет ошибки отправки Telegram-сообщения.

Если токен или `chat_id` были изменены, сохраните настройки повторно.

## Безопасность

* Не публикуйте токен Telegram-бота.
* Не передавайте его сторонним ботам и сайтам.
* Поле токена в текущем интерфейсе не маскируется — не показывайте его на скриншотах и трансляциях экрана.
* Защитите доступ к Windows или VPS: токен хранится в локальных настройках терминала.
* Не отправляйте в Telegram API Secret биржи, пароли и скриншоты с чувствительными данными.
* При утечке токена сразу отзовите его через BotFather.