Dane klientów w czacie (zamówienia, wysyłka, faktury)

Dzięki danym klientów asystent AI odpowiada na pytania takie jak „Gdzie jest moja paczka?”, „Czy moja faktura jest już opłacona?” albo „Co było w moim ostatnim zamówieniu?” – zalogowanym klientom i tylko na temat ich własnych danych. Funkcja jest dostępna w płatnych planach.

Jak chronione są dane

• Przeglądarka niczego nie dowodzi. Żaden numer zamówienia ani faktury, żaden adres e-mail i nic, co widać na stronie lub co ktoś napisze w czacie, nie daje dostępu. O tym, kto może zobaczyć jakie dane, decyduje wyłącznie tożsamość podpisana przez Twój serwer.
• Numer to tylko filtr. Jeśli klient poda numer zamówienia, jest on szukany tylko wśród jego własnych zamówień. Cudzy numer nic nie zwraca.
• Decydujesz o każdym polu. Asystent dostaje tylko pola, które udostępnisz. Wszystko inne jest odrzucane przy odbiorze – nawet jeśli Twój sklep to wyśle.
• Brak zbioru danych u nas (pobieranie). Przy pobieraniu reactive.chat pyta Twój sklep przy każdym pytaniu i nie zapisuje odpowiedzi. Przy imporcie dane są przechowywane u nas w postaci zaszyfrowanej i usuwane najpóźniej po 90 dniach.
• Tylko własne maszyny. Dane trafiają wyłącznie do naszych własnych serwerów AI (albo do Twojego własnego węzła AI), nigdy do usługi AI podmiotu trzeciego.

Warunek: weryfikacja tożsamości

Asystent korzysta z danych klientów tylko w przypadku odwiedzających, których tożsamość potwierdził Twój serwer. W koncie, w sekcji Projekt → Weryfikacja tożsamości, utwórz sekret. Pozostaje on na Twoim serwerze i nigdy nie trafia do przeglądarki ani do fragmentu kodu (snippetu).

Dla każdego zalogowanego klienta Twój serwer oblicza hash z czasem ważności (najwyżej 24 godziny naprzód) i przekazuje go widżetowi:

$userId = (string) $klient->id;
$exp    = time() + 3600;
$hash   = hash_hmac('sha256', $userId . '.' . $exp, getenv('RC_IDENT_SEKRET'));
echo "<script>ReactiveChat('identify', { userId: " . json_encode($userId)
   . ", userHash: " . json_encode($hash) . ", exp: " . $exp . " });</script>";

const crypto = require('crypto');
const exp  = Math.floor(Date.now() / 1000) + 3600;
const hash = crypto.createHmac('sha256', process.env.RC_IDENT_SEKRET)
                   .update(String(user.id) + '.' + exp).digest('hex');
// w szablonie: ReactiveChat('identify', { userId: '<id>', userHash: '<hash>', exp: <exp> });

Hash bez exp nadal potwierdza odwiedzającego (np. na potrzeby historii rozmowy), ale nie wystarcza do danych klientów. Po odnowieniu sekretu stary pozostaje ważny jeszcze przez 24 godziny.

Podpisywanie także adresu e-mail (do rezerwacji terminów i integracji opartych na e-mailu). email obok hasha jest uznany za potwierdzony tylko wtedy, gdy wchodzi do podpisu: userHash = HMAC-SHA256(sekret, userId + "." + exp + "." + email) – adres dokładnie taki, jaki przekazujesz do identify. Bez tego odwiedzający pozostaje zalogowany, ale asystent nie zarezerwuje terminu na ten adres, a integracje nie będą go wyszukiwać. Dotychczasowa forma userId + "." + exp działa bez zmian.

Pobieranie, import czy oba

W sekcji Projekt → Dane klientów wybierasz, skąd asystent bierze dane:

• Pobieranie z Twojego sklepu – reactive.chat przy każdym pasującym pytaniu wywołuje Twój endpoint. Dane zostają u Ciebie. Zalecane.
• Import przez API – Twój sklep wysyła zamówienia klienta do reactive.chat. Przydatne, jeśli sklep nie może udostępnić endpointu.
• Oba – najpierw dane zaimportowane, a jeśli tam nic nie ma, pobieranie.

Jakie dane może dostać asystent

Każde pole udostępniasz osobno. Ustawienia domyślne obejmują typowe pytania:

• bestellung.nummer – numer zamówienia. Domyślnie: zawsze włączone. Do czego: pole obowiązkowe – bez numeru nie ma zamówienia
• bestellung.datum – data zamówienia (RRRR-MM-DD). Domyślnie: wł.. Do czego: „Kiedy zamówiłem?”
• bestellung.status – status zamówienia jako tekst. Domyślnie: wł.. Do czego: „Czy moje zamówienie zostało wysłane?”
• bestellung.summe – kwota całkowita. Domyślnie: wł.. Do czego: „Ile zapłaciłem?”
• bestellung.waehrung – waluta (ISO, np. PLN). Domyślnie: wł.. Do czego: tylko razem z kwotą
• positionen.name – nazwa artykułu. Domyślnie: wł.. Do czego: „Co było w zamówieniu?”
• positionen.menge – ilość artykułu. Domyślnie: wł.. Do czego: „Ile sztuk zamówiłem?”
• versand.dienst – przewoźnik. Domyślnie: wł.. Do czego: „Kto dostarcza paczkę?”
• versand.sendungsnummer – numer przesyłki. Domyślnie: wł.. Do czego: „Gdzie jest moja paczka?”
• versand.status – status wysyłki jako tekst. Domyślnie: wł.. Do czego: „Czy jest już w drodze?”
• versand.ort – miejscowość adresu dostawy. Domyślnie: wył.. Do czego: „Dokąd idzie moja paczka?”
• versand.plz – kod pocztowy adresu dostawy. Domyślnie: wył.. Do czego: jak wyżej
• rechnung.nummer – numer faktury. Domyślnie: wł.. Do czego: „Która faktura do tego należy?”
• rechnung.status – status płatności jako tekst. Domyślnie: wł.. Do czego: „Czy faktura jest opłacona?”
• rechnung.faellig_am – termin płatności. Domyślnie: wł.. Do czego: „Do kiedy muszę zapłacić?”

Wyłączone pole nigdy nie dociera do asystenta: przy pobieraniu jest odrzucane, przy imporcie w ogóle nie jest zapisywane. Miejscowość i kod pocztowy są celowo dostępne tylko po wyraźnym włączeniu – ulica i nazwisko zawsze pozostają poza zasięgiem.

Czego nigdy się nie przekazuje

Tych danych nie da się włączyć. Jeśli Twój sklep je wyśle, zostaną odrzucone:

• ulica, numer domu i kolejne linie adresu
• imię i nazwisko odbiorcy lub zamawiającego
• adres e-mail i numer telefonu
• IBAN, BIC, numer konta i dane karty
• data urodzenia
• hasła, tokeny i klucze dostępu
• numery podatkowe i numery dokumentów tożsamości

Limity

Najwyżej 10 zamówień na odpowiedź, najwyżej 20 pozycji na zamówienie, teksty najwyżej 200 znaków, cała odpowiedź najwyżej 16 kB. Nieznane pola są odrzucane bez komunikatu o błędzie.

Endpoint do pobierania

reactive.chat wywołuje Twój endpoint metodą POST:

POST https://sklep.twoja-domena.pl/rc-dane-klientow
Content-Type: application/json
X-RC-Zeit: 1791196400
X-RC-Signatur: <hex(HMAC_SHA256(sekret endpointu, X-RC-Zeit + "." + treść))>

{"user_id":"4711","anliegen":"bestellung","referenz":"2026-0815","sprache":"pl","nonce":"..."}

• user_id to potwierdzony identyfikator klienta z weryfikacji tożsamości – nigdy dane wzięte z czatu.
• anliegen to bestellung (zamówienie), lieferung (dostawa), rechnung (faktura), retoure (zwrot) albo test dla przycisku testowego.
• referenz to numer podany przez klienta albo pusta wartość. Szukaj go tylko wśród zamówień tego user_id.

Twój endpoint musi:

1. sprawdzać podpis (porównanie w stałym czasie) i odrzucać żądania, których X-RC-Zeit różni się o ponad 5 minut,
2. zwracać wyłącznie dane podanego user_id,
3. być dostępny przez https na porcie 443 pod publicznym adresem, bez przekierowań,
4. odpowiadać w ciągu 3 sekund.

Odpowiedź:

{
  "bestellungen": [
    {
      "nummer": "2026-0815", "datum": "2026-09-28", "status": "wysłane",
      "summe": "199.00", "waehrung": "PLN",
      "positionen": [ { "name": "Rowerek biegowy niebieski", "menge": 1 } ],
      "versand": { "dienst": "InPost", "sendungsnummer": "6200...", "status": "w doręczeniu" },
      "rechnung": { "nummer": "FV/2026/1201", "status": "opłacona", "faellig_am": "2026-10-12" }
    }
  ]
}

Pełny przykład w PHP znajdziesz w dokumentacji dla programistów (kundendaten-referenz-endpunkt.php).

Przycisk Testuj połączenie wywołuje Twój endpoint z user_id rc-test i rodzajem sprawy test oraz pokazuje wynik. Zwróć wtedy pustą listę albo przykładowe zamówienie.

Import przez API

Z kluczem API z uprawnieniem kundendaten:schreiben:

PUT https://reactive.chat/v1/kundendaten/4711?project_id=123
Authorization: Bearer <klucz API>
Content-Type: application/json

{"bestellungen":[ ... jak wyżej ... ]}

project_id to numer Twojego projektu; jeśli Twoja przestrzeń robocza ma tylko jeden projekt, możesz go pominąć. PUT zastępuje wszystkie zamówienia tego identyfikatora klienta (najwyżej 50). DELETE /v1/kundendaten/4711?project_id=123 je usuwa. Zaimportowane dane są przechowywane u nas w postaci zaszyfrowanej i usuwane 90 dni po ostatnim imporcie – wysyłaj więc zmiany na bieżąco, np. przy każdej zmianie statusu.

Niezalogowani odwiedzający

Jeśli ktoś bez potwierdzonej tożsamości zapyta o zamówienie, asystent niczego nie pobiera. Zamiast tego pokazuje komunikat, który ustawiasz w sekcji Projekt → Dane klientów: tekst w każdym języku i opcjonalnie link do logowania. Alternatywnie przekazuje pytanie Twojemu zespołowi.

Co jest zapisywane

• Pobieranie: odpowiedź Twojego sklepu służy tylko do jednej odpowiedzi asystenta i nie jest zapisywana – ani w rozmowie, ani w bazie wiedzy.
• Import: w postaci zaszyfrowanej, najwyżej 90 dni, usuwany razem z projektem.
• Odpowiedź asystenta widnieje w historii rozmowy jak każda wiadomość. Twój zespół widzi ją w panelu.

Rozwiązywanie problemów

• Asystent prosi klienta o zalogowanie, choć ten jest zalogowany: jeśli brakuje exp, minął jego czas albo hash się nie zgadza, odwiedzający nie jest uznany za potwierdzonego. Sprawdź sekret, kolejność userId + "." + exp i zegar swojego serwera.
• Przycisk testowy zgłasza „adres niedozwolony”: endpoint musi być dostępny przez https pod publicznym adresem; adresy wewnętrzne i inne porty są odrzucane.
• Twoja strona zgłasza błąd podpisu: podpisywany jest ciąg X-RC-Zeit + "." + treść sekretem endpointu – dokładnie ta treść, która dotarła, bez ponownego kodowania.
• W odpowiedzi asystenta brakuje pola: czy jest włączone w sekcji „Jakie dane może dostać asystent”?

Więcej w dokumentacji

Szczegółowo: Endpoint danych klientów. Wszystkie rozdziały znajdziesz w dokumentacji.