Integracja Thulium z systemem CRM to jedno z najbardziej wartościowych, ale i najbardziej skomplikowanych wdrożeń w contact center — i jedno z najczęstszych źródeł problemów po stronie administratorów. Screen popy nie wyświetlają się, dane połączeń nie trafiają do CRM, webhooki giną, screen pop otwiera się pusty lub z błędnymi danymi klienta, połączenia wychodzące nie są logowane — to typowe symptomy problemów z integracją CRM–Thulium. Diagnoza wymaga zrozumienia, na którym etapie przepływu danych dochodzi do błędu: po stronie Thulium, w middleware lub po stronie CRM.
Serwis Wiatraczna diagnozuje i naprawia problemy z integracją CRM w Thulium — weryfikuje konfigurację webhooków, autoryzację API, mapowanie danych i logi błędów po obu stronach integracji. Jeżeli Twoja integracja Thulium–CRM nie działa lub działa nieprawidłowo — skontaktuj się z nami.
Problemy z integracją CRM w Thulium — diagnoza i naprawa
Integracja Thulium z CRM to ciąg zdarzeń: połączenie przychodzi → Thulium wysyła webhook → middleware przetwarza → CRM odbiera. Błąd na każdym z tych etapów może wyglądać tak samo z zewnątrz — „integracja nie działa" — ale wymaga zupełnie innego rozwiązania.
Screen pop nie wyświetla się — diagnoza
Screen pop jest najprostszą częścią integracji — jeśli nie działa, zaczynamy od weryfikacji konfiguracji URL w Thulium: czy URL szablonu screen popu jest prawidłowo ustawiony w panelu, czy zawiera właściwy placeholder dla numeru telefonu, czy strona pod tym URL jest dostępna z sieci agenta. Następnie sprawdzamy konsolę przeglądarki agenta (F12) przy połączeniu — czy są błędy JavaScript lub sieciowe przy ładowaniu screen popu. Typowe problemy: URL screen popu prowadzi do strony wymagającej logowania (CRM wylogował sesję agenta), strona blokuje osadzanie w iframe (X-Frame-Options) lub CRM jest niedostępny z powodu awarii.
Webhooki nie docierają do endpointu CRM
Thulium prowadzi log wysłanych webhooków z odpowiedziami serwera endpointu — to pierwsze miejsce do sprawdzenia przy problemach z logowaniem połączeń w CRM. Jeżeli log pokazuje błąd 5xx lub timeout, problem leży po stronie endpointu CRM: serwer jest niedostępny, endpoint zwraca błąd, lub przekroczony został timeout odpowiedzi. Jeżeli log pokazuje 200 OK, ale dane nie pojawiają się w CRM — problem leży w logice przetwarzania webhooka w middleware lub CRM. Brak wpisów w logu webhooków Thulium sugeruje, że zdarzenie nie wyzwala webhooka (błąd konfiguracji typów zdarzeń).
Problemy z autoryzacją API — wygasłe tokeny
Większość integracji Thulium–CRM używa tokenów API do autoryzacji żądań. Tokeny mogą wygasnąć: token OAuth 2.0 jest ważny typowo 1 godzinę (access token) lub kilka miesięcy (refresh token), klucz API może wygasnąć po zmianie hasła konta serwisowego lub po ręcznej rotacji kluczy przez administratora CRM. Jeżeli integracja przestała działać nagle, bez zmian w konfiguracji — sprawdź, czy token API jest aktualny. Rozwiązanie: ponowna autoryzacja integracji lub wygenerowanie nowego klucza API i aktualizacja go w konfiguracji middleware.
Mapowanie numerów telefonów — problemy z formatem
Thulium przekazuje numer telefonu dzwoniącego w określonym formacie — zazwyczaj E.164 (+48221234567) lub krajowym (221234567). CRM może przechowywać numery w innym formacie (bez kierunkowego, z myślnikami, z spacjami). Jeżeli middleware nie normalizuje numeru przed wyszukaniem w CRM, nie znajdzie dopasowania i screen pop będzie pusty lub pojawi się formularz nowego kontaktu zamiast karty istniejącego klienta. Normalizacja numerów telefonu (usunięcie kierunkowego kraju, znaków specjalnych, dodanie brakującego zera) to jeden z najczęstszych naprawczych wymaganych w integracjach CRM–Thulium.
Diagnoza kompleksowych problemów integracji
Przy złożonych problemach integracyjnych diagnostyka wymaga jednoczesnej analizy logów po trzech stronach: logów webhooków Thulium (czy i z jakim kodem wysłał zdarzenie), logów middleware (czy odebrał zdarzenie, jak je przetworz i z jakim wynikiem) i logów API CRM (czy otrzymał żądanie i co zwrócił). Zestawienie tych logów z timestampami dla tego samego połączenia pokazuje, na którym etapie coś poszło nie tak i dlaczego.
Naprawa integracji CRM–Thulium — Serwis Wiatraczna
Serwis Wiatraczna zdiagnozuje i naprawi problemy z integracją Thulium i CRM — niezależnie od tego, który CRM używasz i jak skomplikowana jest konfiguracja. Skontaktuj się z nami, a znów integracja zadziała sprawnie.
