Настройка модуля «Уведомления в Telegram»

Мгновенные уведомления для пользователей сайта в Telegram. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Площадкам, которым нужны коды подтверждения, уведомления о заказах или служебные сообщения.
• Владельцам, которые хотят отделить важные системные уведомления от ручной переписки.
• Командам, которым важно проверить доставку сообщения на тестовом получателе до массовой отправки.

Что изменится на сайте

• ADWOS CMS отправляет сервисные уведомления через «Уведомления в Telegram».
• Можно проверить доставку кода, сообщения или админского оповещения на тестовом получателе.
• Владелец контролирует отправителя, токены, лимиты и стоимость сообщений.
• Пользователи получают важные уведомления в привычном канале.

Что подготовить заранее

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

• Создайте кабинет, бота, отправителя или канал у провайдера «Уведомления в Telegram».
• Подготовьте токен, идентификатор отправителя, chat_id, номер или другой реквизит, который требует модуль.
• Проверьте баланс, лимиты, правила шаблонов и разрешения на отправку сервисных сообщений.
• Выберите тестового получателя и не запускайте массовую отправку до успешной проверки.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Уведомления в Telegram» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «Bot Token (от @BotFather)». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Токен Telegram-бота в формате 123456:ABC-DEF...
• «Username бота (например: MySuperBot)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное. Юзернейм бота без символа @. Используется для генерации ссылки t.me/username
• «Объявление одобрено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять пользователя о прохождении модерации объявления
• «Объявление отклонено». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять пользователя об отклонении объявления модератором
• «Сообщения». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых личных сообщениях в чате
• «Отзывы». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Уведомлять о новых отзывах и ответах на отзывы
• «Секрет для Webhook (любая случайная строка)». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Произвольная строка для защиты Webhook от стороннего доступа

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

Проверка перед запуском

• Отправьте тестовое уведомление на свой номер, аккаунт или канал.
• Проверьте статус доставки в ADWOS CMS и в кабинете провайдера.
• Убедитесь, что текст сообщения не содержит тестовых данных и понятен пользователю.
• Проверьте ошибку при неверном получателе или пустом токене.

Частые ошибки

• Сообщение не доставлено. Проверьте токен, баланс, лимиты и формат получателя.
• Провайдер блокирует отправку. Проверьте регистрацию отправителя и правила шаблонов.
• Администратор не получает уведомление. Проверьте chat_id, username, номер или привязку аккаунта.
• Коды приходят с задержкой. Проверьте очередь, лимиты провайдера и повторные попытки.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.