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

Widget Embedding

Добавете вашия AI чатбот към всеки уебсайт за секунди с нашия прост embed код.

Quick Start

Поставете този код преди затварящия </body> таг:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

Това е всичко! Вашият чатбот вече е на живо на уебсайта ви.

Finding Your Chatbot ID

  1. Отидете в настройките на вашия чатбот
  2. Навигирайте до Вграждане таба
  3. Копирайте embed кода (включва вашето ID)

ID-то на чатбота в embed кода не е същото като името в URL-a на таблото ви. Винаги копирайте ID-то от Вграждане таба.

Customizing the Widget

Визията и поведението на джаджата се конфигурират в таблото ви — не в embed кода. Отидете на Dashboard → Chatbots → [your chatbot] → Widget за настройки:

  • Position — долен десен, долен ляв или inline
  • Colors — основен, фон и цветове на текста, плюс радиус на границата
  • Size — ширина и височина на джаджата

За да отворите чата автоматично след конфигурирана закъснение, включете Автоматично отваряне в Поведение таба на същата страница с настройки. При white-label планове, брандирането на ChatReact е скрито по подразбиране — същият Поведение таб има Show "Powered by ChatReact" превключвател, ако желаете да го показвате в футъра на джаджата.

Промените се прилагат автоматично към уебсайта ви — няма нужда да обновявате embed кода. Вижте ръководството Widget Customization за всички налични опции.

Езикът на джаджата се открива автоматично от браузъра на всеки посетител, въз основа на езиците, които активирате в Езици таба на вашия чатбот.

Изберете позиция Inline, за да вградите чата директно в страницата на мястото, където е поставен script тагът. Джаджата винаги е отворена, без балон или бутон за затваряне — идеално за страници, посветени на чат или секции за поддръжка.

FAQ Widget

Показвайте ЧЗВ като акордеон на всяка страница:

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

FAQ джаджата показва публикувани ЧЗВ от вашия чатбот. Цветовете и стиловете (основен, фон и цветове на текста, радиус на границата) се конфигурират в Табло → ЧЗВ → Настройки.

FAQ Widget Options

SettingDescriptionWhere to Configure
Colors & StylingОсновни, фон и цветове на текста, радиус на границатаDashboard → FAQs → Settings
ШиринаИзберете между 100% (пълна ширина) или персонализирана ширина в пиксели (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderРед на показване: Дата (най-нови първо), Име (азбучно) или Custom (ръчно пренареждане)Dashboard → FAQs → Settings → Behavior
Филтър по категорияПокажете само конкретни категории в джаджатаEmbed code data-categories атрибут
Custom ContainerРендерирайте джаджата вътре във ваш собствен елемент вместо по подразбиране chatreact-faq divEmbed code data-container атрибут
ЕзикНулирайте езика на джаджата (по подразбиране използва <html lang> атрибута на вашата страница, след това езика на браузъра на посетителя)Embed code data-lang атрибут
Accordion BehaviorПозволява множество ЧЗВ да бъдат отворени едновременно, или автоматично разширяване на първото ЧЗВDashboard → FAQs → Settings → Behavior

Category Filter Example

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

Когато джаджата е филтрирана по една категория, собствената подредба на тази категория (зададена в Dashboard → FAQs → Categories) замества глобалната настройка за сортиране.

Mobile Optimization

Чат джаджата е напълно оптимизирана за мобилни устройства:

  • Оформление на пълна ширина на малки екрани
  • Анимация за излитане при отваряне
  • Обработка на клавиатурата в iOS (джаджата се настройва спрямо клавиатурата на екрана)
  • Поддръжка на safe-area за прореза и началния индикатор на iPhone
  • По-големи touch цели за по-добра използваемост
  • Размерът на шрифта в полето за въвеждане предотвратява auto-zoom на iOS

Platform-Specific Guides

WordPress

Препоръчително: Използвайте официалния ChatReact WordPress Plugin за най-лесна интеграция с Gutenberg блокове, Elementor джаджи и shortcode-ове.

Алтернатива: Ръчно вграждане чрез плъгин "Header/Footer Scripts":

  1. Инсталирайте произволен плъгин "Header/Footer Scripts"
  2. Добавете embed кода в секцията footer
  3. Запазете и публикувайте

Shopify

Препоръчително: ChatReact Shopify App

Инсталирайте ChatReact приложението от Shopify App Store за най-лесна интеграция:

  1. Инсталирайте ChatReact приложението в своя Shopify админ
  2. Въведете вашето Chatbot ID в настройките на приложението
  3. Чат джаджата автоматично се появява във вашия storefront
  4. Управлявайте назначаването на джаджата на страница, или я активирайте навсякъде

Приложението поддържа и Form и FAQ джаджи като App Blocks в Theme Editor.

Алтернатива: Ръчно вграждане

  1. Отидете на Online Store → Themes → Edit Code
  2. Отворете theme.liquid
  3. Добавете кода преди </body>
  4. Запазете

Webflow

  1. Отидете на Project Settings → Custom Code
  2. Добавете в Footer Code
  3. Публикувайте сайта

Next.js / React

Използвайте Script компонента:

import Script from 'next/script';

export default function Layout({ children }) {
  return (
    <>
      {children}
      <Script 
        src="https://www.chatreact.ai/embed/widget.js"
        data-chatbot-id="YOUR_CHATBOT_ID"
        strategy="lazyOnload"
      />
    </>
  );
}

Vue.js

Добавете във вашия main App.vue или layout:

<script setup>
import { onMounted } from 'vue';

onMounted(() => {
  const script = document.createElement('script');
  script.src = 'https://www.chatreact.ai/embed/widget.js';
  script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
  script.async = true;
  document.body.appendChild(script);
});
</script>

JavaScript API

Взаимодействайте с джаджата програмно:

// Open the chat
ChatReact.open();

// Close the chat
ChatReact.close();

// Toggle open/closed
ChatReact.toggle();

// Start a fresh conversation
ChatReact.newChat();

// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();

Testing

Preview Mode

Преди да вградите на живо:

  1. Използвайте Преглед функцията в таблото ви
  2. Тествайте различни сценарии
  3. Потвърдете, че отговорите са точни

Тест на локален development сайт? Използвайте стандартния embed код без промени — той работи и на localhost страници.

Troubleshooting

Widget Not Appearing

  1. Проверете конзолата на браузъра за грешки
  2. Уверете се, че chatbot ID е правилно
  3. Уверете се, че чатботът е активен (не е деактивиран)
  4. Проверете дали ad blocker-и не пречат
  5. Проверете използването според вашия план — джаджата се спира, когато месечният лимит на плана бъде достигнат

Caching & Optimization Plugins

Някои кеширащи или оптимизиращи скриптове плъгини пренаписват URL-ове на скриптове, което може да спре зареждането на джаджата. Ако това се случи, добавете явен API URL към script тага:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-api-url="https://www.chatreact.ai"
  async
></script>

Същият атрибут работи и за FAQ и form widget скриптовете.

Styling Conflicts

Ако CSS на вашия сайт конфликтира:

  • Джаджата ограничава стиловете си до собствения контейнер и използва правила с висок приоритет, за да се противопостави на конфликти
  • Проверете z-index стойностите на елементи, които покриват джаджата
  • Избягвайте широки !important правила във вашия сайт CSS, които таргетират общи елементи

Performance

Джаджата е създадена за минимално въздействие:

  • Зарежда се асинхронно — никога не блокира рендирането на страницата
  • Леки: приблизително 30 KB компресиран трансфер

Next Steps