WP Chat — онлайн-чат для WordPress с интеграцией VK

Онлайн-чат для WordPress с автоматическим распределением диалогов по менеджерам: виджет на сайте, панель обработки диалогов в админке, email- и SMS-уведомления, приём и отправка сообщений из группы VK в одном окне с обычным чатом.

Версия 1.6.0  PHP 7.4+  WordPress 6.0+

00О плагине

«WP Chat» добавляет на сайт виджет онлайн-чата и панель для его обработки прямо в админке WordPress — без сторонних сервисов и ежемесячной платы за диалоги:

• показывает на сайте всплывающий виджет чата — круглая кнопка или кнопка-таб, с настраиваемым цветом, положением на экране и текстами;
• автоматически назначает каждый новый диалог доступному менеджеру — если менеджер «на смене» (держит открытой панель «Диалоги»), диалог уходит ему мгновенно; если никого нет — диалог достаётся случайному менеджеру, и ему приходит email- и/или SMS-уведомление;
• единая панель менеджера в админке: список диалогов, переписка, эмодзи, вложения файлов, звуковые уведомления о новых чатах и сообщениях, значок непрочитанных в меню слева;
• принимает и отправляет сообщения из группы VK — тем же диалоговым окном, что и обычный чат на сайте, посетителю не нужно ничего дополнительно устанавливать;
• активное приглашение в чат — всплывающая подсказка с текстом на выбор, появляется через заданную задержку, чтобы подтолкнуть посетителя написать;
• роли доступа: менеджерами являются администраторы, редакторы и пользователи с ролью/возможностью wpchat_manager.

01Что нужно перед началом

1. WordPress 6.0 или новее, PHP 7.4+. Плагин самостоятельный — WooCommerce или другой магазинный плагин не требуется.
2. Хотя бы один менеджер — пользователь с ролью «Администратор» или «Редактор» (или отдельной ролью/возможностью wpchat_manager, см. главу «Менеджеры чата»).
3. Рабочая отправка почты с сайта (wp_mail) — на неё завязаны email-уведомления менеджерам о новых диалогах. Если сайт не отправляет письма штатно, потребуется SMTP-плагин.
4. Аккаунт на sms.ru — опционально, только если планируете SMS-уведомления менеджерам.
5. Сообщество (группа) VK с правами администратора в ней — опционально, только если планируете принимать сообщения из VK.
6. Лицензионный ключ WordPlace — для активации автообновлений плагина.

02Установка и активация

1. Скачайте архив плагина из личного кабинета покупателя на WordPlace (вкладка «Мои покупки»).
2. В админке WordPress: Плагины → Добавить новый → Загрузить плагин, выберите zip-архив, «Установить».
3. Нажмите «Активировать». Плагин сам создаёт нужные таблицы в базе данных при активации — никаких дополнительных действий не требуется.

После активации в меню слева появляется отдельный раздел WP Chat с четырьмя пунктами: «Диалоги», «Менеджеры», «Настройки» и «Лицензия».

03Активация лицензии

Откройте WP Chat → Лицензия. Ключ вы получили при покупке плагина на WordPlace — он приходит в личный кабинет покупателя, вкладка «Лицензии и ключи».

1. Вставьте ключ (формат XXXXX-XXXXX-XXXXX-XXXXX) и нажмите «Активировать».
2. Активация привязывает лицензию к текущему домену и открывает автоматические обновления плагина.
3. Кнопки «Деактивировать» и «Проверить обновления» появляются после активации.

04Настройка плагина

Все настройки собраны на одной странице — WP Chat → Настройки, шесть разделов подряд.

Содержание

Внешний вид

• Цвет виджета — акцентный цвет кнопки запуска, шапки окна чата и элементов управления.
• Положение на экране — «Справа» или «Слева».
• Стиль кнопки — «Круглая кнопка» (только иконка) или «Кнопка с текстом» (с настраиваемой подписью, поле «Текст на кнопке» появляется только для этого варианта).

Форма начала чата

Единственная настройка — галочка «Обязательное поле «E-mail» в форме начала чата». По умолчанию посетитель указывает только имя и сообщение; включите галочку, если хотите гарантированно получать email посетителя ещё до начала переписки (например, чтобы ответить, даже если он закроет вкладку).

Активное приглашение в чат

Всплывающая подсказка над кнопкой запуска — появляется автоматически через заданное время, если посетитель ещё не открыл чат, и подталкивает его написать.

• Показывать приглашение посетителям — включает/выключает приглашение целиком.
• Задержка (секунды) — через сколько секунд после загрузки страницы показать приглашение.
• Текст приглашения — например, «У нас есть акция! Напишите нам — расскажем подробнее».

Уведомления менеджерам

Работают только для офлайн-назначения: если в момент нового диалога ни один менеджер не держит открытой панель «Диалоги», плагин случайно выбирает менеджера из всех администраторов/редакторов/wpchat_manager и уведомляет его.

• Email — включено по умолчанию, письмо уходит на email менеджера штатным wp_mail.
• SMS через sms.ru — выключено по умолчанию. Нужен API-ключ sms.ru (личный кабинет sms.ru → Главная) и, опционально, одобренное имя отправителя. Кроме того, у каждого менеджера должен быть указан номер телефона — поле «WP Chat» внизу его профиля пользователя (Пользователи → профиль менеджера), без этого SMS ему не уйдёт.

VK — входящие сообщения из группы

Включает приём личных сообщений сообщества VK прямо в панель WP Chat и ответ на них из того же интерфейса, что и обычный чат сайта.

1. Откройте вашу группу VK: Дополнительно → Работа с API.
2. В разделе «Ключи доступа» нажмите «Создать ключ», отметьте право «Сообщения сообщества» — вставьте ключ в поле «Ключ доступа группы» на странице настроек WP Chat.
3. Найдите числовой ID группы: Управление → Информация → ID — впишите его в поле «ID группы VK» (без минуса).
4. В разделе «Callback API» выберите версию 5.131, в поле «Адрес» вставьте URL из поля «URL для Callback» на странице настроек WP Chat (есть кнопка «Скопировать»).
5. Скопируйте «Строку для подтверждения сервера» из VK, вставьте в поле «Строка подтверждения» на странице WP Chat, нажмите «Сохранить настройки» — затем вернитесь в VK и нажмите «Подтвердить».
6. Во вкладке «Типы событий» в VK включите «Входящие сообщения (message_new)».
7. Поле «Секретный ключ» — опционально, дополнительная проверка подлинности запросов от VK (задаётся там же, в настройках Callback API вашей группы).

05Менеджеры чата

Страница WP Chat → Менеджеры показывает всех, кто может отвечать в чате: пользователей с ролью «Администратор», «Редактор» или ролью/возможностью wpchat_manager — таблицей с именем, email, статусом (онлайн/оффлайн) и временем последней активности. Страница только показывает список — самих пользователей и их роли назначаются штатно, в разделе Пользователи WordPress.

Статус «Онлайн» в этой таблице означает не просто «залогинен в WordPress», а «прямо сейчас держит открытой вкладку «WP Chat → Диалоги»» — панель отправляет пинг раз в 30 секунд, пока открыта, и менеджер считается офлайн, если пинга не было дольше 90 секунд.

06Что видит посетитель сайта

На фронтенде (не в админке) внизу экрана появляется кнопка запуска чата — по умолчанию круглая, справа. Клик открывает окно:

• если это первое обращение — форма: имя, e-mail (если включён как обязательный в настройках), сообщение;
• после отправки создаётся диалог, посетитель сразу видит своё сообщение и приветственный текст;
• дальше — обычная переписка: текст, эмодзи, вложение файла (до 10 МБ, см. главу «Вложения файлов»);
• если посетитель уже писал раньше (тот же браузер/сессия), при повторном визите чат восстанавливает предыдущий диалог, а не начинает новый.

07Панель менеджера

Раздел WP Chat → Диалоги — рабочее место менеджера: список диалогов слева (с фильтром «Активные / Ожидание / Все» для администраторов, поиском по имени и email), переписка по центру, карточка посетителя справа (имя, email, страница сайта, с которой он пишет, UTM-метки перехода, а для VK — фото, город, ссылка на профиль и другие данные из VK).

• Список диалогов и счётчик непрочитанных обновляются автоматически, без перезагрузки страницы.
• Значок с числом непрочитанных/ожидающих диалогов показывается прямо на пункте меню «WP Chat» — на любой странице админки, не только внутри самого плагина.
• Звуковой сигнал на новый диалог и на новое сообщение — можно выключить кнопкой со значком динамика в шапке панели (настройка хранится в браузере).

08Автоматическое распределение диалогов

Никакой ручной очереди или кнопки «взять диалог» нет — распределение полностью автоматическое, срабатывает при первом сообщении нового диалога (с сайта или из VK):

1. Плагин ищет менеджеров, которые прямо сейчас держат открытой панель «Диалоги» (пинг за последние 90 секунд).
2. Если такие есть — диалог назначается тому, кто дольше всех не получал новый диалог (по времени последнего пинга), статус сразу становится «Активный».
3. Если онлайн никого нет — диалог назначается случайному менеджеру из всех зарегистрированных (включая офлайн), статус тоже становится «Активный» (менеджер назначен и должен ответить, когда откроет панель), и менеджеру уходит email/SMS-уведомление (см. «Уведомления менеджерам»).

09Вложения файлов

И посетитель, и менеджер могут прикрепить файл к сообщению — кнопка со скрепкой рядом с полем ввода.

10Частые проблемы

Виджет чата не появляется на сайте

Виджет рендерится в wp_footer только на фронтенде (в самой админке его нет — это ожидаемо). Если сайт использует плагин кэширования страниц, после изменения настроек чата (текст, цвет) очистите кэш HTML — иначе посетителям может отдаваться старая закэшированная версия футера.

Новые диалоги не назначаются менеджеру мгновенно

Мгновенное назначение работает только пока у менеджера открыта вкладка браузера с панелью WP Chat → Диалоги — статус «онлайн» держится пингом каждые 30 секунд и сгорает через 90 секунд бездействия/после закрытия вкладки. Если ни один менеджер не онлайн, диалог всё равно назначается (случайному менеджеру) и приходит уведомление — см. «Автоматическое распределение диалогов».

Email- или SMS-уведомления не приходят

Уведомления уходят только при офлайн-назначении (когда никто не онлайн) — если в момент диалога кто-то из менеджеров держал панель открытой, уведомление не отправляется намеренно, диалог просто назначается ему напрямую. Если и в офлайн-сценарии писем нет — проверьте, что сайт вообще умеет отправлять почту (wp_mail, штатный PHP mail() часто блокируется хостингом — нужен SMTP-плагин). Для SMS проверьте API-ключ sms.ru в настройках и то, что у менеджера заполнен телефон в профиле пользователя.

Сообщения из VK не появляются в чате

Проверьте по порядку: в VK выбрана версия Callback API 5.131; строка подтверждения на странице настроек WP Chat совпадает с той, что показывает VK; ID группы указан без минуса; если задан «Секретный ключ» — он совпадает с настройками Callback API в VK. Событие «Входящие сообщения (message_new)» должно быть включено во вкладке «Типы событий» в VK.

Файл не прикрепляется

Проверьте размер (не больше 10 МБ) и тип файла — список разрешённых типов см. в главе «Вложения файлов». Файлы других форматов и типов плагин отклоняет намеренно, по соображениям безопасности.

11Технические ограничения

• Нет ручного управления очередью: забрать чужой диалог, передать свой другому менеджеру или явно «закрыть» диалог через интерфейс нельзя — только автоматическое назначение при создании диалога.
• Статус «менеджер онлайн» привязан к открытой вкладке панели «Диалоги» в браузере, а не к факту авторизации в WordPress — менеджер, вошедший в админку, но не открывший этот раздел, для распределения считается офлайн.
• Идентификация посетителя на сайте — по сессии браузера; в приватном/другом браузере или после явной очистки данных сайта посетитель откроет чат как новый, без истории предыдущего диалога.
• Из VK принимаются текстовые сообщения и вложения без текста (в чат попадает пометка вида «[фото]», «[документ]» и т.п.) — сами файлы вложений VK в панель WP Chat не переносятся.
• Звуковые уведомления и переключатель звука хранятся в браузере (localStorage), а не в профиле пользователя — настройка не переносится между устройствами.