Telegram и оповещения администратора

Где найти в панели: System › Settings › Admin alerts (/settings/alerts). Ссылки на поддержку: Customers › Support › Tickets (/support/tickets), вкладка Settings.

Назначение

NexCMP оповещает вас — оператора — о важных событиях, регистрации клиентов или зачислении средств. Уведомления отправляются в один или несколько каналов: Telegram, вебхук или e-mail.

В каналы администратора отправляются события: сбой развертывания, отсутствие VM, сбой сети, менее 30 свободных IP, истекающая услуга (за 1 час), диспут в Stripe, остановка воркера, превышение порога RAM в кластере, новая регистрация клиента и зачисление депозита. Клиентские события надежно ставятся в очередь и повторяются с увеличивающимся интервалом (от 30 секунд до 1 часа), пока Telegram их не примет.

Требования

Параметр	Требование
Telegram	Бот, созданный через @BotFather (токен), и chat ID группы или пользователя, которые должны получать сообщения
Сеть	Исходящие HTTPS-запросы к api.telegram.org
Вебхук (альтернатива)	Конечная точка HTTPS, принимающая полезную нагрузку уведомлений

Подготовка Telegram

1. В Telegram откройте @BotFather, отправьте /newbot, выберите имя и скопируйте bot token (123456789:AA...).
2. Создайте группу, добавьте в нее бота и отправьте любое сообщение.
3. Найдите chat ID: откройте https://api.telegram.org/bot<token>/getUpdates в браузере и найдите chat.id (ID групп начинаются с -).

Подключение в NexCMP

1. Откройте System › Settings › Admin alerts.
2. В блоке Add channel выберите Type: Telegram, укажите chat ID в поле Destination и токен в поле Secret (bot token). Нажмите Add.
3. Убедитесь, что переключатель Send admin Telegram (VM module) включен; в строке VM module status (read-only) отображается «on».

Проверка

Канал появится в списке Configured channels. Вызовите событие (например, зарегистрируйте тестового клиента), и сообщение придет в группу. Если ни один канал не настроен, страница предупреждает: «Without a channel, attacks will go unnoticed», а события Telegram в журнале фиксируются только локально.

Кнопки связи для клиентов

Виджет поддержки клиентов может отображать кнопки Telegram и Zalo. Они скрыты, пока не настроены в параметрах поддержки: укажите ссылку https://t.me/... для Telegram и ссылку или QR-код для Zalo. Принимаются только ссылки https://. Чат поддержки также может отправлять уведомления в вашу группу Telegram с вопросом и черновиком ответа — см. AI Chat.

Ограничения и примечания

• Токен бота сохраняется в настройках канала и больше никогда не отображается.
• Для отправки событий Telegram используется первый активный канал Telegram, у которого заданы и получатель, и токен.

Устранение неполадок

Симптом	Причина	Решение
Сообщения не приходят	Неверный chat ID, бот не добавлен в группу или боту еще не отправляли сообщений	Проверьте ID еще раз через getUpdates; сначала отправьте сообщение боту или в группу.
Работает некоторое время, затем перестает	Токен отозван в BotFather	Создайте новый токен и обновите настройки канала.
Telegram: no channel в журналах	Нет активного канала Telegram	Добавьте канал, как описано выше.