Strona głównaDokumentacja

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

  1. Przejdź do ustawień swojego chatbota
  2. Przejdź do karty Osadź
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
SzerokośćChoose between 100% (full width) or a custom pixel width (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderDisplay order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop)Dashboard → FAQs → Settings → Behavior
Filtr kategoriiShow only specific categories in the widgetEmbed code data-categories attribute
Custom ContainerRender the widget inside your own element instead of the default chatreact-faq divEmbed code data-container attribute
JęzykOverride the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language)Embed code data-lang attribute
Accordion BehaviorAllow multiple FAQs open at once, or auto-expand the first FAQDashboard → 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":

  1. Zainstaluj dowolną wtyczkę "Header/Footer Scripts"
  2. Dodaj kod do sekcji stopki
  3. Zapisz i opublikuj

Shopify

Zalecane: ChatReact Shopify App

Zainstaluj aplikację ChatReact ze sklepu Shopify App Store dla najprostszej integracji:

  1. Zainstaluj aplikację ChatReact w panelu administracyjnym Shopify
  2. Wprowadź swoje ID chatbota w ustawieniach aplikacji
  3. Widget czatu automatycznie pojawi się w sklepie
  4. 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

  1. Przejdź do Online Store → Themes → Edit Code
  2. Otwórz theme.liquid
  3. Dodaj kod przed </body>
  4. Zapisz

Webflow

  1. Przejdź do Project Settings → Custom Code
  2. Dodaj do Footer Code
  3. 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:

  1. Użyj funkcji Podgląd w panelu
  2. Przetestuj różne scenariusze
  3. 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

  1. Sprawdź konsolę przeglądarki pod kątem błędów
  2. Zweryfikuj, czy ID chatbota jest poprawne
  3. Upewnij się, że chatbot jest aktywny (nie jest wyłączony)
  4. Sprawdź, czy blokery reklam nie przeszkadzają
  5. 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ł !important w 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