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
- Отидете в настройките на вашия чатбот
- Навигирайте до Вграждане таба
- Копирайте 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
| Setting | Description | Where 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 div | Embed 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":
- Инсталирайте произволен плъгин "Header/Footer Scripts"
- Добавете embed кода в секцията footer
- Запазете и публикувайте
Shopify
Препоръчително: ChatReact Shopify App
Инсталирайте ChatReact приложението от Shopify App Store за най-лесна интеграция:
- Инсталирайте ChatReact приложението в своя Shopify админ
- Въведете вашето Chatbot ID в настройките на приложението
- Чат джаджата автоматично се появява във вашия storefront
- Управлявайте назначаването на джаджата на страница, или я активирайте навсякъде
Приложението поддържа и Form и FAQ джаджи като App Blocks в Theme Editor.
Алтернатива: Ръчно вграждане
- Отидете на Online Store → Themes → Edit Code
- Отворете
theme.liquid - Добавете кода преди
</body> - Запазете
Webflow
- Отидете на Project Settings → Custom Code
- Добавете в Footer Code
- Публикувайте сайта
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
Преди да вградите на живо:
- Използвайте Преглед функцията в таблото ви
- Тествайте различни сценарии
- Потвърдете, че отговорите са точни
Тест на локален development сайт? Използвайте стандартния embed код без промени — той работи и на localhost страници.
Troubleshooting
Widget Not Appearing
- Проверете конзолата на браузъра за грешки
- Уверете се, че chatbot ID е правилно
- Уверете се, че чатботът е активен (не е деактивиран)
- Проверете дали ad blocker-и не пречат
- Проверете използването според вашия план — джаджата се спира, когато месечният лимит на плана бъде достигнат
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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — вграждайте самостоятелни форми с form widget