Расширение AI Chatbot для TYPO3 (Бесплатный, TYPO3 10-14)

Расширение для TYPO3

Расширение WebChatAgent добавляет ваш chatbot на сайт TYPO3. Вы устанавливаете его, вставляете свой ID чат-бота в конфигурацию сайта, и кнопка чата появляется на каждой странице этого сайта. Не нужно подключать TypoScript или изменять шаблоны. Оформление, тексты, поведение ИИ и живой чат настраиваются в панели управления WebChatAgent, поэтому внесенные изменения сразу отображаются на сайте.

Один релиз поддерживает TYPO3 10.4, 11.5, 12.4, 13.4 и 14.

Шаг 1: Установка расширения

С помощью Composer (большинство проектов TYPO3):

composer require webchatagent/typo3-webchatagent
vendor/bin/typo3 extension:setup

Без Composer: откройте Admin Tools → Extensions, найдите webchatagent и установите его. TYPO3 создаст поля в базе данных автоматически.

Расширение является бесплатным. Вы можете найти его в TYPO3 Extension Repository и на Packagist.

Шаг 2: Скопируйте ваш ID чат-бота

Войдите в панель управления WebChatAgent и откройте ваш chatbot.
Откройте Действия с чат-ботом и нажмите Копировать ID чат-бота.

Идентификатор выглядит как 3f2b9c1e-8a7d-4e5f-9b0c-1d2e3f4a5b6c.

Шаг 3: Добавьте идентификатор на свой сайт

В TYPO3 перейдите в Site Management → Sites и откройте настройки вашего сайта.
Откройте вкладку Чат.
Вставьте идентификатор в поле ID чат-бота и сохраните.

Откройте ваш сайт в новой вкладке: кнопка чата появится в углу каждой страницы. Если в одной установке TYPO3 работает несколько сайтов, для каждого из них задается свой идентификатор, что позволяет запускать на каждом сайте отдельный chatbot.

Скрытие чата на определенных страницах

Откройте свойства страницы, вкладку Чат, и активируйте параметр Hide the chat button on this page and all subpages. Это удобно для страниц оформления заказа, посадочных страниц для рекламы или раздела интранета.

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

Отображение чата внутри страницы

Для страницы контактов или помощи можно разместить чат прямо в содержимом вместо плавающей кнопки (или в дополнение к ней):

В модуле Page добавьте новый элемент содержимого.
Выберите Встроенный чат в разделе Special elements.
Оставьте поле ID чат-бота пустым, чтобы использовать идентификатор сайта, или укажите другой для этой страницы.
Необязательно: укажите значение в поле Высота, например 600px или 80vh. Без этого размер чата будет увеличиваться по мере добавления содержимого.

Скрипт встроенного чата загружается только на тех страницах, где добавлен такой элемент. Приветственный текст, тема оформления и другие параметры настраиваются в разделе Каналы → Встроенный чат в панели управления, подробнее в руководстве Inline Chat.

Редакторам без прав администратора необходимо открыть доступ к новым полям и типу содержимого "Inline chat" в настройках их группы пользователей бэкенда.

Передача данных авторизованных пользователей сайта в чат

Если на вашем сайте TYPO3 есть закрытая зона со входом, включите параметр Pass logged-in website users to the chat на вкладке Чат в настройках сайта. Для авторизованных посетителей чат будет получать имя, Email адрес и имя пользователя. Бот сможет приветствовать их по имени и не станет повторно запрашивать контактные данные.

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

Передача собственных данных (для разработчиков)

Чтобы передавать дополнительные параметры, например номер клиента, зарегистрируйте слушатель для события WebChatAgent\WebChatAgent\Event\ModifyContextDataEvent и добавьте нужные ключи с помощью метода setContextData(). Полный пример приведен в файле README на GitHub. Формат и ограничения описаны в разделе Встраивание виджета чата.

Content Security Policy

При включенной frontend CSP (TYPO3 12 и новее) расширение автоматически добавляет сервер чата в политику для скриптов, подключений, изображений и медиафайлов, а также разрешает инлайн-стили для виджета. Редактировать файл csp.yaml вручную не требуется.

WebChatAgent не выводит собственный баннер согласия. Без сигнала о согласии он работает в анонимном режиме конфиденциальности. Если на вашем сайте TYPO3 используется менеджер согласий, подключите его согласно инструкции Cookie Consent and Anonymous Proactive Triggers.

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

Кнопка чата не отображается? Проверьте, полностью ли указан идентификатор на вкладке Чат, и не включен ли параметр Hide the chat button для этой страницы или ее родительских разделов. Затем очистите кэш TYPO3. Если используется кэширование статических файлов, например EXT:staticfilecache, очистите и его.
Проблема сохраняется? Доступ к вашему чат-боту может быть ограничен определенными доменами. Добавьте домен вашего сайта в разделе Allowed Domains в панели управления.
Заблокировано политикой Content Security Policy? Проверьте консоль браузера. Если чат размещен на вашем собственном адресе (white-label), укажите его в поле Server address на вкладке Чат, чтобы расширение разрешило обращения именно к этому адресу.