Повернутися до панелi керування

Документацiя

Дiзнайтеся, як використовувати Asyntai

Як додати AI чат-бот Asyntai до TYPO3

Покрокова інструкція для вебсайтів TYPO3

Отримати код вбудовування

Крок 1: Отримайте код для вставки

Спочатку перейдiть до вашої Панелi керування Asyntai та прокрутiть вниз до роздiлу "Код для вставки". Скопiюйте унiкальний код для вставки, який виглядатиме так:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Примiтка: Код вище є лише прикладом. Ви повиннi скопiювати власний унiкальний код для вставки з вашої Панелi керування, оскiльки вiн мiстить ваш особистий ID вiджета.

Крок 2: Використання TypoScript footerData (Рекомендовано)

Найпростіший спосіб додати чат-бот на всі сторінки - використати TypoScript footerData:

  1. Увійдіть до вашого бекенду TYPO3
  2. Перейдіть до Web → Template
  3. Виберіть вашу кореневу сторінку в дереві сторінок
  4. Натисніть на "Edit the whole template record" (або виберіть "Info/Modify", а потім "Setup")
  5. У полі Setup додайте наступний код TypoScript:
    page.footerData.99 = TEXT
    page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  6. Замiнiть YOUR_WIDGET_ID на фактичний ID вiджету з панелi керування
  7. Натиснiть "Save"
  8. Очистіть кеш TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Порада: Використання footerData розміщує скрипт безпосередньо перед закриваючим тегом </body>, що рекомендується для чат-віджетів, оскільки це не сповільнить завантаження вашої сторінки.

Альтернатива: Використання Site Package (для Site Packages)

Якщо ви використовуєте site package, ви можете додати скрипт через ваш конфігураційний файл TypoScript:

  1. Перейдіть до папки вашого site package: packages/your_sitepackage/Configuration/TypoScript/
  2. Відкрийте або створіть setup.typoscript
  3. Додайте наступний код:
    page.footerData {
      99 = TEXT
      99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }
  4. Замiнiть YOUR_WIDGET_ID на ваш фактичний ID вiджету
  5. Очистіть кеш у бекенді TYPO3

Альтернатива: Використання шаблону Fluid (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

  1. Перейдіть до вашого файлу шаблону Fluid (зазвичай в Resources/Private/Templates/)
  2. Додайте розділ FooterAssets у ваш макет або шаблон:
    <f:section name="FooterAssets">
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    </f:section>
  3. Переконайтеся, що макет вашої сторінки рендерить розділ FooterAssets:
    <f:render section="FooterAssets" optional="true" />
  4. Очистіть кеш TYPO3

Важливо: Функція FooterAssets вимагає TYPO3 v8 або новішу версію. Для старіших версій використовуйте метод TypoScript footerData.

Альтернатива: Використання AssetCollector (для розробників)

Для розробників розширень TYPO3 v10.3+ пропонує API AssetCollector:

  1. У вашому PHP-коді (наприклад, контролері або middleware) впровадьте AssetCollector
  2. Додайте скрипт з власними атрибутами:
    use TYPO3\CMS\Core\Page\AssetCollector;

    $this->assetCollector->addJavaScript(
      'asyntai_chatbot',
      'https://asyntai.com/static/js/chat-widget.js',
      ['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
    );

Крок 3: Перевiрте встановлення

Пiсля збереження змiн та очищення кешу вiдвiдайте свiй веб-сайт у новiй вкладцi браузера або в режимi iнкогнiто. Ви повиннi побачити кнопку чат-вiджету в нижньому правому кутi. Натиснiть на неї, щоб переконатися, що вона вiдкривається та працює коректно.

Не бачите вiджет? Переконайтеся, що ви очистили всі кеші: перейдіть до Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Також спробуйте очистити кеш браузера або переглянути у вікні інкогніто. Якщо використовуєте TypoScript, перевірте, що ваш шаблон правильно включений в ієрархію сторінок.