Integracja - Własny esklep

Łukasz Strumiński

Aktualizacja: 12.10.2026

Wprowadzenie#

Twój sklep internetowy, Twoje zasady – jedna platforma do obsługi klientów!

Nie korzystasz z jednej z popularnych platform e-commerce? A może Twój sklep działa na autorskim oprogramowaniu? Zintegruj go z Thulium i zapewnij konsultantom wygodny dostęp do informacji o zamówieniach, bez konieczności przełączania się między systemami.

Dzięki integracji Własny esklep możesz połączyć Thulium z dowolnym sklepem internetowym udostępniającym odpowiednie API. Konsultanci zyskują dostęp do historii zamówień, ich statusów i szczegółów zakupów bezpośrednio podczas obsługi klienta.

Mniej przełączania między systemami, szybsze odpowiedzi i pełniejszy kontekst każdej rozmowy.

Zakres integracji#

Połączenie własnego sklepu internetowego z Thulium pozwala konsultantom szybciej docierać do informacji zakupowych i sprawniej obsługiwać klientów, niezależnie od kanału kontaktu.

Historia zamówień zawsze pod ręką – sprawdzaj zamówienia klienta wraz ze statusami, datami, kosztami, zakupionymi produktami i adresami dostawy bezpośrednio w Thulium.
Ostatnie zamówienie w zasięgu wzroku – szybko uzyskaj kontekst ostatnich zakupów klienta, aby sprawniej odpowiadać na pytania dotyczące realizacji zamówienia.
Szybki dostęp do szczegółów w sklepie – przechodź bezpośrednio do wybranego zamówienia w panelu sklepu, bez konieczności jego ręcznego wyszukiwania.
Wiele sklepów w jednym miejscu – połącz z Thulium kilka sklepów internetowych, np. B2B i B2C, i wygodnie rozpoznawaj źródło poszczególnych zamówień.

Integracja jest przeznaczona dla sklepów, które mają własne oprogramowanie lub platformę bez gotowej integracji z Thulium. Jeśli Twoja platforma jest na liście integracji, wygodniej będzie użyć gotowej.

Krok po kroku#

Przejdź do Administracja → Integracje i wybierz Własny esklep.

W sekcji uwierzytelniania uzupełnij wymagane pola.

gdzie:

Adres URL sklepu – adres Twojego sklepu, musi zaczynać się od https:// – login i hasło są przesyłane do sklepu, więc połączenie musi być szyfrowane.
Login – login do API sklepu.
Hasło – hasło do API sklepu.

Kliknij przycisk uwierzytelnienia. Thulium połączy się ze sklepem i sprawdzi, czy odpowiada poprawnie.

Uzupełnij pole Nazwa integracji, aby agenci mogli łatwo rozpoznać, z którego sklepu pochodzi zamówienie – szczególnie jeśli korzystasz z kilku sklepów. Następnie kliknij Zapisz i uruchom, aby zapisać ustawienia i aktywować integrację. Możesz ją również uruchomić później za pomocą suwaka aktywacji.

Jeśli zmienisz adres, login lub hasło po uwierzytelnieniu, integracja przestaje być oznaczona jako uwierzytelniona i trzeba uwierzytelnić ją ponownie.

🚀 Gotowe – od teraz zamówienia klientów pojawią się w Thulium.

Informacje o zamówieniach w Thulium#

Wszystkie najważniejsze informacje o zakupach klienta w jednym miejscu! Dzięki integracji konsultanci mogą sprawdzać szczegóły zamówień bezpośrednio w Thulium, zarówno z poziomu historii kontaktu, jak i podczas obsługi rozmowy.

Thulium wyszukuje zamówienia po adresie e-mail klienta. Jeśli klient nie ma zapisanego e-maila, system użyje jego numeru telefonu. Gdy klient nie ma ani e-maila, ani numeru telefonu, zamówień nie da się wyszukać i lista będzie pusta.

Dla każdego zamówienia dostępne są następujące informacje:

numer zamówienia i jego status (dokładnie taki, jaki zwraca sklep),
data zamówienia,
koszt całkowity, koszt produktów i koszt dostawy,
lista produktów z ilościami,
adres dostawy (miasto, kod pocztowy, ulica, kraj),
odnośnik do zamówienia w sklepie.

Dzięki temu konsultant ma pod ręką informacje potrzebne do sprawnej obsługi pytań o zamówienia, bez konieczności każdorazowego otwierania panelu sklepu.

Historia kontaktu:

Kanał kontaktu:

Wymagania wobec API#

Thulium wywołuje Twój sklep pod adresem podanym w polu Adres URL sklepu, przekazując login i hasło (według opisu twórców integracji: jako uwierzytelnianie HTTP Basic).

Rejestracja – POST /thulium/integrations/register

Thulium wysyła w treści JSON identyfikator integracji (id), nazwę klienta (client) i opcjonalnie redirectUrl. Odpowiedź sklepu decyduje o dalszym przebiegu:

200 lub 204 – rejestracja zakończona od razu, system sprawdza następnie, czy sklep poprawnie zwraca zamówienia.
Przekierowanie (3xx z nagłówkiem Location) – sklep wymaga dodatkowego potwierdzenia (np. zalogowania się administratora sklepu). Adres przekierowania musi być na https i w tej samej domenie co adres sklepu. Po potwierdzeniu sklep ma przekierować użytkownika na redirectUrl (parametr result=error oznacza niepowodzenie). Czas na potwierdzenie to 15 minut.
Inna odpowiedź – integracja zostanie oznaczona jako nieudana.

Zamówienia – GET /thulium/integrations/orders

Nagłówek X-Thulium-Integration-Id zawiera identyfikator integracji. Parametry: email lub phoneNumber, page (numeracja od 0), size oraz opcjonalnie sort. Sklep zwraca JSON:

orders – lista zamówień, page, size.
Każde zamówienie: id, status, orderDate (czas UTC w formacie 2026-01-31T12:00:00Z), totalCosts, productsCosts, shippingCosts (obiekty z amount jako tekst, np. "12.50", i currency jako trzyliterowy kod, np. PLN), products (lista z name i quantity ≥ 1), orderUrl (adres zamówienia w sklepie) oraz shippingAddress (city, postcode, street, country).
Pola tekstowe nie mogą być puste.

Podczas uwierzytelniania Thulium pobiera jedno zamówienie bez filtrów, żeby sprawdzić format odpowiedzi – sklep musi więc obsłużyć zapytanie bez email i phoneNumber.

Twój sklep, Twoi klienci, wszystkie informacje w jednym miejscu. Połącz własny esklep z Thulium i zapewnij konsultantom dostęp do danych zakupowych, które pomagają szybciej rozwiązywać problemy i budować lepsze doświadczenia klientów.