Widget Embedding
Dodaj swojego chatbota AI do dowolnej strony w kilka sekund za pomocą naszego prostego kodu do osadzenia.
Szybki start
Dodaj ten kod przed zamykającym tagiem </body>:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
To wszystko! Twój chatbot jest teraz aktywny na stronie.
Znalezienie ID chatbota
- Przejdź do ustawień swojego chatbota
- Przejdź do karty Osadź
- Skopiuj kod do osadzenia (zawiera Twoje ID)
ID chatbota w kodzie do osadzenia nie jest takie samo jak nazwa w adresie URL pulpitu. Zawsze kopiuj ID z karty Osadź.
Dostosowywanie widgetu
Wygląd i zachowanie widgetu konfiguruje się w panelu — nie w kodzie do osadzenia. Przejdź do Dashboard → Chatbots → [your chatbot] → Widget, aby zmienić:
- Position — dół-po prawej, dół-po lewej lub inline
- Colors — kolory główny, tła i tekstu oraz promień ramki
- Rozmiar — szerokość i wysokość widgetu
Aby otwierać czat automatycznie po skonfigurowanym opóźnieniu, włącz Automatyczne otwieranie w karcie Zachowanie na tej samej stronie ustawień. W planach white-label branding ChatReact jest domyślnie ukryty — ta sama karta Zachowanie zawiera przełącznik Show "Powered by ChatReact", jeśli chcesz mimo to wyświetlać go w stopce widgetu.
Zmiany stosują się automatycznie na Twojej witrynie — nie ma potrzeby aktualizowania kodu do osadzenia. Zobacz przewodnik Widget Customization dla wszystkich dostępnych opcji.
Język widgetu jest wykrywany automatycznie na podstawie przeglądarki każdego odwiedzającego oraz języków włączonych w karcie Języki Twojego chatbota.
Wybierz pozycję Inline, aby osadzić czat bezpośrednio w treści strony w miejscu, gdzie znajduje się tag skryptu. Widget jest zawsze otwarty, bez dymka i przycisku zamykania — idealne dla stron z dedykowanym czatem lub sekcjami wsparcia.
Widget FAQ
Wyświetlaj FAQ jako akordeon na dowolnej stronie:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Widget FAQ pokazuje opublikowane FAQ z Twojego chatbota. Kolory i stylizacja (główny, tła i koloru tekstu, promień ramki) są konfigurowane w Panel → FAQ → Ustawienia.
Opcje widgetu FAQ
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Szerokość | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Filtr kategorii | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Język | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → FAQs → Settings → Behavior |
Przykład filtra kategorii
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Gdy widget jest filtrowany do pojedynczej kategorii, porządek tej kategorii (ustawiony w Dashboard → FAQs → Categories) ma pierwszeństwo przed globalnym ustawieniem sortowania.
Optymalizacja mobilna
Widget czatu jest w pełni zoptymalizowany pod urządzenia mobilne:
- Układ na pełną szerokość na małych ekranach
- Animacja wysuwania przy otwieraniu
- Obsługa klawiatury iOS (widget dostosowuje się do klawiatury ekranowej)
- Obsługa safe-area dla wycięcia iPhone i paska domowego
- Większe cele dotykowe dla lepszej użyteczności
- Rozmiar czcionki w polu wejściowym zapobiega automatycznemu powiększaniu na iOS
Poradniki specyficzne dla platform
WordPress
Zalecane: Użyj oficjalnej wtyczki ChatReact WordPress Plugin dla najprostszej integracji z blokami Gutenberg, widgetami Elementor i shortcode'ami.
Alternatywa: Ręczne osadzenie przez wtyczkę "Header/Footer Scripts":
- Zainstaluj dowolną wtyczkę "Header/Footer Scripts"
- Dodaj kod do sekcji stopki
- Zapisz i opublikuj
Shopify
Zalecane: ChatReact Shopify App
Zainstaluj aplikację ChatReact ze sklepu Shopify App Store dla najprostszej integracji:
- Zainstaluj aplikację ChatReact w panelu administracyjnym Shopify
- Wprowadź swoje ID chatbota w ustawieniach aplikacji
- Widget czatu automatycznie pojawi się w sklepie
- Zarządzaj przypisaniem widgetu do poszczególnych stron lub włącz go globalnie
Aplikacja obsługuje również widgety Formularza i FAQ jako App Blocks w Theme Editor.
Alternatywa: ręczne osadzenie
- Przejdź do Online Store → Themes → Edit Code
- Otwórz
theme.liquid - Dodaj kod przed
</body> - Zapisz
Webflow
- Przejdź do Project Settings → Custom Code
- Dodaj do Footer Code
- Opublikuj stronę
Next.js / React
Użyj komponentu 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
Dodaj do głównego App.vue lub layoutu:
<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>
API JavaScript
Wchodź w interakcje z widgetem programowo:
// 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();
Testowanie
Tryb podglądu
Przed osadzeniem na żywo:
- Użyj funkcji Podgląd w panelu
- Przetestuj różne scenariusze
- Sprawdź, czy odpowiedzi są poprawne
Testujesz na lokalnej stronie deweloperskiej? Użyj standardowego kodu do osadzenia bez zmian — działa również na stronach localhost.
Rozwiązywanie problemów
Widget się nie pojawia
- Sprawdź konsolę przeglądarki pod kątem błędów
- Zweryfikuj, czy ID chatbota jest poprawne
- Upewnij się, że chatbot jest aktywny (nie jest wyłączony)
- Sprawdź, czy blokery reklam nie przeszkadzają
- Sprawdź wykorzystanie planu — widget jest wstrzymywany po osiągnięciu miesięcznego limitu planu
Wtyczki cache i optymalizujące skrypty
Niektóre wtyczki do cache'owania lub optymalizacji skryptów przepisują adresy URL skryptów, co może uniemożliwić załadowanie widgetu. Jeśli tak się dzieje, dodaj jawny URL API do tagu skryptu:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Ten sam atrybut działa dla skryptów widgetów FAQ i formularza.
Konflikty stylów
Jeśli CSS Twojej strony powoduje konflikty:
- Widget ogranicza swoje style do własnego kontenera i używa reguł o wysokim priorytecie, aby przeciwdziałać konfliktom
- Sprawdź wartości z-index elementów nachodzących na widget
- Unikaj szerokich reguł
!importantw CSS strony, które celują w elementy ogólne
Wydajność
Widget zaprojektowano tak, by mieć minimalny wpływ:
- Ładuje się asynchronicznie — nigdy nie blokuje renderowania strony
- Lekki: około 30 KB skompresowanego transferu
Kolejne kroki
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — osadź samodzielne formularze za pomocą widgetu formularza