Integracja: dokumentacja techniczna dla programistów

Ta dokumentacja jest przeznaczona dla programistek i programistów, którzy wbudowują reactive.chat w stronę internetową, aplikację lub backend. Opisuje interfejsy i przebiegi tak, jak są zaimplementowane w kodzie – z nazwami, typami, wartościami domyślnymi i przypadkami błędów.

Jak ustawić wygląd, teksty, stronę startową, reguły, przewodniki, testy A/B i personę AI, opisuje Dostosowanie. Obsługę konta i panelu opisuje Podręcznik.

W skrócie

Przeglądarka odwiedzających                 reactive.chat                         twój serwer
---------------------------                 -------------                         -----------
loader.js  --(wyzwalacz)-->  core.<hash>.js cdn.reactive.chat
   window.ReactiveChat (API, zdarzenia)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   Tryb awaryjny HTTP (SSE/Poll) <------>   ws.reactive.chat/rc_wss/h/
                                            Serwer czatu --- POST (podpisany) ->  Endpoint danych klientów
                                                         --- POST (podpisany) ->  Odbiorca webhooków
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  Sekret tożsamości

Po stronie klienta osadzasz tag script i opcjonalnie sterujesz widżetem przez window.ReactiveChat. Po stronie serwera podpisujesz tożsamość zalogowanych użytkowników, w razie potrzeby odpowiadasz na zapytania o dane klientów, odbierasz webhooki i korzystasz z REST API.

Rozdziały

Podstawy

• Architektura i przebieg – części, ich współdziałanie, wersje i dostarczanie
• Szybki start – osadzenie, wpisanie domeny, CSP, sprawdzenie

W przeglądarce

• Tag script – dokumentacja – wszystkie atrybuty data-rc-* i źródła konfiguracji
• API JavaScript – wszystkie polecenia ReactiveChat(…)
• Zdarzenia – on/off i zdarzenia DOM
• Identyfikacja odwiedzających i przekazywanie kontekstu – identify, userHash, exp, track
• Aplikacje jednostronicowe i zmiany stron
• Bezpieczeństwo i Content Security Policy

Połączenie i dostarczanie

• Własna domena i proxy first-party – nginx, Apache, Caddy
• Transport: WebSocket, tryb awaryjny HTTP, ponowne łączenie – protokół, kody błędów i kody zamknięcia

Na twoim serwerze

• Endpoint danych klientów – pobieranie i import zamówień
• Webhooki – zdarzenia, podpis, ponowienia, REST hooki
• API serwera (REST v1) i MCP
• Integracje i kanały – WhatsApp, Messenger, Instagram, Telegram, SMS, e-mail

Inne miejsca osadzenia

• Aplikacje mobilne – czat w WebView
• Smart Answer – odpowiedź AI w wyszukiwarce twojej strony

Eksploatacja

• Ochrona danych – zgoda, pamięć przeglądarki, tekst o ochronie danych
• Limity i kwoty
• Rozwiązywanie problemów i lista kontrolna

Inne strony na ten temat

• Osadzenie widżetu – wersja skrócona
• Szczegóły techniczne – pomiary rozmiaru, dostępności i kontrastu
• Otwieranie czatu własnym linkiem lub przyciskiem
• Karta promocyjna w czacie
• Dane klientów w czacie
• Własna domena (first-party)
• Tryb awaryjny HTTP
• Automatyczne osadzanie tekstu o ochronie danych

Pojęcia

• Klucz witryny (Site-Key) – publiczny klucz projektu (24 znaki), widnieje we fragmencie kodu. To nie jest sekret.
• Projekt – strona internetowa lub aplikacja z własnymi ustawieniami; kilka projektów tworzy przestrzeń roboczą.
• Panel – interfejs, w którym odpowiada twój zespół.
• Potwierdzony użytkownik – odwiedzający, którego tożsamość twój serwer podpisał przez userHash.
• Loader / rdzeń – mała część ładująca loader.js i doładowywana część główna core.<hash>.js.

Wszystkie części dokumentacji w skrócie: Dokumentacja.