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

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

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

Початок роботи
Встановлення База знань Як ШІ отримує доступ до вашого контенту Підключіть свій сайт Протестувати ШІ Керування сайтами Поради щодо інструкцій для ШІ Перехід з іншого чат-бота Порівняння тарифів
Функції
Панель Ask AI Рядок ШІ-пошуку Сканування сайту Прогалини у знаннях Картки товарів Динамічні картки товарів Динамічні зображення Контекст користувача Власні інструменти Параметри посилань Проактивні повідомлення Моніторинг у реальному часі Підключення оператора Ескалація Сповіщення ШІ Сповіщення в браузері Щоденний звіт Потік даних у реальному часі Фід даних у реальному часі Max Учасники команди Єдиний вхід Двофакторна автентифікація Показувати зображення Розпізнавання зображень Віджет перекладу Локалізація Прозорість ШІ Ліди Розумний збір лідів Тікети підтримки ШІ-відповіді на листи Категорії чатів Довідковий центр Бронювання Голосовий агент Вбудовування Виключити сторінки Заблоковані IP Політика зберігання Режим нульового зберігання Маскування PII Класифікатор відповідей Access Tags Закріплення версії віджета Журнал аудиту Пропозиції відповідей Подальші повідомлення Розпізнавання мовлення Завантаження стенограми Вбудований чат Вбудовування через iframe

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

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

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

Headless CMS: Contentful - це headless CMS, що означає надання контенту через API без вбудованого фронтенду. Встановлення чат-бота залежить від того, який фреймворк ви використовуєте для відображення контенту Contentful. Оберіть метод нижче, який відповідає вашому налаштуванню.

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

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

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

Метод 1: Next.js з Contentful (Рекомендований)

Якщо ви використовуєте Next.js для відображення контенту Contentful, додайте чат-бот за допомогою компонента Script:

  1. Відкрийте головний файл макету: app/layout.tsx (App Router) або pages/_app.tsx (Pages Router)
  2. Імпортуйте компонент Script та додайте чат-бот:
    import Script from 'next/script'

    export default function RootLayout({ children }) {
      return (
        <html>
          <body>
            {children}
            <Script
              src="https://asyntai.com/static/js/chat-widget.js"
              data-asyntai-id="YOUR_WIDGET_ID"
              strategy="lazyOnload"
            />
          </body>
        </html>
      )
    }
  3. Замініть YOUR_WIDGET_ID на ваш фактичний ID віджету
  4. Збережіть файл та перезапустіть сервер розробки

Порада: Використання strategy="lazyOnload" забезпечує завантаження чат-бота після того, як сторінка стане повністю інтерактивною, що забезпечує найкращу продуктивність.

Метод 2: Gatsby з Contentful

Для сайтів Gatsby, що отримують контент з Contentful:

  1. Встановіть gatsby-plugin-load-script (необов'язково, але рекомендовано):
    npm install gatsby-plugin-load-script
  2. Додайте до вашого gatsby-config.js:
    module.exports = {
      plugins: [
        {
          resolve: 'gatsby-plugin-load-script',
          options: {
            src: 'https://asyntai.com/static/js/chat-widget.js',
            attributes: {
              'data-asyntai-id': 'YOUR_WIDGET_ID',
              async: true
            }
          }
        }
      ]
    }
  3. Як альтернативу, використовуйте gatsby-ssr.js:
    // gatsby-ssr.js
    import React from 'react'

    export const onRenderBody = ({ setPostBodyComponents }) => {
      setPostBodyComponents([
        <script
          key="asyntai-chatbot"
          async
          src="https://asyntai.com/static/js/chat-widget.js"
          data-asyntai-id="YOUR_WIDGET_ID"
        />
      ])
    }
  4. Перезапустіть сервер розробки Gatsby

Метод 3: React з Contentful

Для стандартних React-застосунків (Create React App, Vite тощо), що використовують Contentful:

  1. Відкрийте файл public/index.html
  2. Додайте код вбудовування перед закриваючим тегом </body>:
    <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
  3. Збережіть файл

Або використовуйте компонент React з useEffect:

// components/Chatbot.jsx
import { useEffect } from 'react'

export default function Chatbot() {
  useEffect(() => {
    const script = document.createElement('script')
    script.src = 'https://asyntai.com/static/js/chat-widget.js'
    script.async = true
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID')
    document.body.appendChild(script)
    return () => document.body.removeChild(script)
  }, [])
  return null
}

Метод 4: Vue/Nuxt з Contentful

Для застосунків Vue або Nuxt.js, що використовують Contentful:

Nuxt 3:

  1. Додайте до вашого nuxt.config.ts:
    export default defineNuxtConfig({
      app: {
        head: {
          script: [
            {
              src: 'https://asyntai.com/static/js/chat-widget.js',
              async: true,
              'data-asyntai-id': 'YOUR_WIDGET_ID'
            }
          ]
        }
      }
    })

Vue 3:

  1. Додайте до вашого index.html перед </body>:
    <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

Метод 5: Статичний HTML з Contentful API

Якщо ви використовуєте Content Delivery API Contentful з чистим JavaScript:

  1. Додайте код вбудовування до вашого HTML-файлу перед закриваючим тегом </body>:
    <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
  2. Збережіть файл та завантажте на хостинг

Крок 2: Перевірка встановлення

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

Не бачите віджет? Переконайтеся, що ви додали скрипт до правильного файлу для вашого фреймворку. Перевірте консоль розробника у браузері на наявність помилок. Якщо ви використовуєте серверний рендеринг, переконайтеся, що скрипт виконується на клієнтській стороні. Спробуйте очистити кеш браузера або переглянути в режимі інкогніто.

Змінні середовища: Для кращої безпеки та гнучкості рекомендується зберігати ID віджету у змінній середовища (наприклад, NEXT_PUBLIC_ASYNTAI_ID для Next.js) замість жорсткого кодування.