Уведомления и чат в Telegram
Плагин «Уведомления и чат в Telegram» — автоматические уведомления клиентов о статусах заказов, просмотр деталей заказа прямо в Telegram и чат с оператором. Всё через вашего собственного бота.
Быстрый старт
Создайте бота через @BotFather, скопируйте токен и вставьте его в настройках плагина. Убедитесь, что в приложении «Сайт» указано поселение для приложения «Боты Телеграм». Активируйте вебхук — и плагин готов к работе.
Режим получения обновлений
Плагин поддерживает два режима работы — Webhook и Polling. Переключатель находится в основных настройках.
Webhook (по умолчанию)
Telegram сам отправляет обновления на ваш сервер. Требует доступный HTTPS-адрес и то, чтобы Telegram мог достучаться до вашего сервера.
Polling (опрос через cron)
Сервер сам опрашивает Telegram через API. Не требует входящих подключений от Telegram.
Polling актуален, если российский провайдер блокирует api.telegram.org через ТСПУ — в этом случае включите Polling и настройте Socks5-прокси в настройках плагина.
Требуется скрипт расписания
Polling работает только через задачу в планировщике (cron). Добавьте задание, которое запускает команду раз в минуту:
* * * * * /usr/bin/php /path/to/wa-root/cli.php telegram notifications pollПодробная команда с актуальным путём доступна на вкладке «Информация» в настройках плагина.
Как работает защита от дублей
При переключении в режим Polling плагин снимает webhook у Telegram и сохраняет offset последнего обработанного обновления. Повторная обработка одного обновления исключена.
Подключение клиентов
После настройки у каждого зарегистрированного пользователя в личном кабинете появится ссылка для привязки аккаунта Telegram. Один клик — и клиент начинает получать уведомления.
Хелперы для привязки аккаунтов
На вкладке «Информация» доступны хелперы — специальные ссылки, которые можно вставить в email-рассылки, на страницу успешного оформления заказа или в любое другое место на сайте, чтобы предложить клиенту подключить Telegram.
Все подключённые пользователи отображаются на вкладке «Подписчики». Здесь можно найти клиента через поиск, отвязать аккаунт или начать чат.
Настройка интерфейса бота
На вкладке «Интерфейс» настраиваются реакции бота: приветственное сообщение, команды, текст ошибки и основная логика поведения.
Здесь же включается поддержка мини-приложения Telegram (Telegram Web App) — кнопка в меню бота, открывающая встроенный магазин. Для работы требуются Shop-Script 12+ и Webasyst 4+, а также HTTPS-адрес мини-приложения.
Текст ошибки и чат
Если на вкладке «Интерфейс» включён «Текст ошибки», бот будет отвечать заготовленным сообщением на любой текст, не являющийся командой. В этом режиме чат с оператором через CRM работать не будет. Используйте эту функцию, если хотите направить клиента на альтернативный канал поддержки.
Мини-приложение Telegram (Web App)
Включите мини-приложение на вкладке «Интерфейс», укажите HTTPS-ссылку и название кнопки. После этого в боте появится кнопка, открывающая встроенный магазин прямо в Telegram — без перехода в браузер.
Требования: Shop-Script 12 и выше, Webasyst 4 и выше, HTTPS на сайте.
Также можно указать ссылку на мобильную версию сайта — это тоже будет работать.
Официальная инструкция по настройке мини-приложения →
Уведомления о заказах
Создайте уведомление для каждого события заказа — оплата, отправка, смена статуса. Шаблоны поддерживают HTML-разметку Telegram и переменные Smarty. Уведомления приходят только подписанным клиентам.
Подсказки в интерфейсе
При создании уведомлений внимательно читайте подсказки под каждой настройкой — они помогут правильно настроить формат и содержание сообщений.
Чат с клиентом
Переписывайтесь с клиентом прямо из панели управления — на вкладке «Подписчики» или из окна заказа, если установлено приложение CRM.
Со стороны клиента общение с ботом выглядит как обычный диалог в Telegram:
Интеграция с CRM
Если установлено приложение CRM, дополнительно установите плагин Telegram для CRM. Укажите в нём тот же токен бота и сохраните настройки.
Вебхук в плагине CRM не включать
Вебхук должен быть активирован только в плагине «Уведомления и чат в Telegram». После сохранения настроек CRM-плагина вернитесь сюда и переактивируйте вебхук.
Совместная работа с плагином «Авторизация через Telegram»
Оба плагина могут использовать одного бота. Плагин «Авторизация через Telegram» автоматически привязывает Telegram-аккаунт клиента при входе на сайт — без необходимости отдельно подключать бота.
Требования
- Shop-Script или Site версии 8.0 или выше
- Приложение «Боты Telegram» версии 2.1.0 или выше
- PHP расширение cURL
- Доступ к API Telegram
Планы на будущее
- ИИ-агент для автоматических ответов клиентам
- Поиск товаров через бота