Обратно към таблото

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

Научете как да използвате Asyntai

Как да добавите Asyntai AI чатбот към Umbraco

Ръководство стъпка по стъпка за уебсайтове с Umbraco CMS

Вземете код за вграждане

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

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

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Редактиране на Master шаблон (Препоръчително)

Най-лесният начин да добавите чатбота на всички страници е чрез редактиране на вашия Master шаблон:

  1. Влезте в Umbraco Backoffice
  2. Отидете на Settings в лявата странична лента
  3. Разгънете Templates
  4. Щракнете върху вашия Master шаблон (или основния шаблон за оформление, който вашият сайт използва)
  5. Намерете затварящия таг </body>
  6. Поставете вашия Asyntai код за вграждане точно преди тага </body>
  7. Натиснете "Save"

Съвет: Добавянето на скрипта преди затварящия таг </body> гарантира, че той се зарежда след съдържанието на страницата, което е препоръчително за чат уиджети и няма да забави зареждането на страницата ви.

Алтернатива: Използване на тип документ Site Settings

За повече гъвкавост можете да добавите персонализирано поле за управление на скриптове във футъра:

  1. Отидете на Settings → Document Types
  2. Редактирайте типа документ Site Settings (или създайте такъв, ако не съществува)
  3. Добавете ново свойство, наречено "Footer Scripts", с тип данни Textarea
  4. Запазете типа документ
  5. Отидете на Content и редактирайте възела Site Settings
  6. Поставете вашия Asyntai код за вграждане в полето Footer Scripts
  7. Във вашия Master шаблон добавете този код преди </body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Запазете както съдържанието, така и шаблона

Забележка: Използването на @Html.Raw() е важно за правилно визуализиране на script таговете без HTML кодиране.

Алтернатива: Използване на папка Scripts

Можете също да създадете JavaScript файл в Umbraco Backoffice:

  1. Отидете на Settings → Scripts
  2. Щракнете с десен бутон върху Scripts и изберете "Create"
  3. Създайте нов файл, наречен asyntai-chatbot.js
  4. Добавете следния код:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  5. Заменете YOUR_WIDGET_ID с вашия действителен ID на уиджета
  6. Запазете файла
  7. Включете този скрипт във вашия Master шаблон преди </body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Алтернатива: За конкретна страница с RenderSection

Ако искате чатбота само на конкретни страници:

  1. Във вашия Master шаблон добавете преди </body>:
    @RenderSection("footerScripts", required: false)
  2. В конкретния шаблон на страницата, където искате чатбота, добавете:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Стъпка 3: Проверка на инсталацията

След като запазите промените, посетете уебсайта си в нов раздел на браузъра или в инкогнито прозорец. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Кликнете върху него, за да се уверите, че се отваря и работи правилно.

Не виждате уиджета? Уверете се, че сте запазили шаблона след направените промени. Опитайте да изчистите кеша на браузъра или да разгледате в прозорец инкогнито. Ако използвате Umbraco Cloud, промените трябва да се деплойнат автоматично. За самостоятелно хостван Umbraco може да се наложи да рестартирате приложението или да изчистите кеша.