integracja z systemem ticketowym

Integracja z systemem ticketowym umożliwia automatyczne zakładanie zgłoszeń na podstawie przychodzącej korespondencji.

Na czym polega integracja z systemem ticketowym

Integracja z systemem ticketowym łączy kanał przyjmowania korespondencji z aplikacją, w której rejestrowane i obsługiwane są zgłoszenia. Wiadomość wysłana na określony adres może zostać odebrana przez mechanizm integracyjny, odczytana i przekształcona w rekord zgłoszenia. Taki rekord zwykle zawiera temat wiadomości, treść, adres nadawcy, datę otrzymania oraz załączniki, jeżeli konfiguracja systemu pozwala na ich bezpieczne przekazanie.

Najczęściej stosuje się odbiór poczty przez protokół IMAP albo POP3, bezpośrednie wywołania interfejsu API lub połączenie kilku mechanizmów. IMAP pozwala pracować na wiadomościach przechowywanych na serwerze pocztowym i zachowywać ich stan, natomiast POP3 służy przede wszystkim do pobierania wiadomości do aplikacji. W integracji opartej na API dane są przekazywane przez żądania HTTP, zazwyczaj w formacie JSON. Konkretne możliwości zależą od systemu ticketowego, dostawcy poczty i użytej konfiguracji.

Droga wiadomości od skrzynki do zgłoszenia

Przepływ danych powinien mieć jasno określone etapy. Najpierw moduł odbierający sprawdza skrzynkę lub oczekuje na żądanie wysłane przez inny system. Następnie identyfikuje wiadomość, odczytuje jej nagłówki i treść oraz rozpoznaje, czy jest to nowe zgłoszenie, odpowiedź do istniejącej sprawy czy wiadomość niezwiązana z obsługiwanym procesem. W praktyce identyfikacja istniejącego zgłoszenia może opierać się na numerze w temacie, specjalnym nagłówku albo identyfikatorze umieszczonym w treści odpowiedzi.

Po pomyślnym przetworzeniu wiadomość jest mapowana na pola dostępne w systemie ticketowym. Temat może stać się tytułem sprawy, treść opisem, a adres nadawcy danymi osoby zgłaszającej. Reguły mogą również przypisywać kategorię, priorytet, kolejkę lub osobę odpowiedzialną na podstawie adresu odbiorcy, słów występujących w temacie albo rodzaju załącznika. Jeżeli dane wejściowe nie spełniają wymaganych warunków, system powinien odnotować błąd i pozostawić informację umożliwiającą ponowne przetworzenie wiadomości.

Kontrola duplikatów, odpowiedzi i błędów

Istotnym elementem integracji jest idempotencja, czyli możliwość ponowienia tej samej operacji bez utworzenia wielu identycznych zgłoszeń. Mechanizm może zapamiętywać identyfikator wiadomości, identyfikator żądania albo wynik poprzedniego przetwarzania. Bez takiej kontroli chwilowa awaria połączenia może spowodować, że jedna wiadomość zostanie zarejestrowana więcej niż raz. Dobrze zaprojektowany przepływ rozdziela także błąd pobrania poczty, błąd walidacji danych i błąd zapisu w systemie ticketowym, ponieważ każdy z nich wymaga innego sposobu diagnozy.

Obsługa odpowiedzi wymaga zachowania relacji między korespondencją a zgłoszeniem. Odpowiedź wysłana przez osobę zajmującą się sprawą powinna wrócić do właściwego nadawcy i zawierać identyfikator pozwalający powiązać kolejną wiadomość z tym samym ticketem. Trzeba również ustalić zachowanie dla automatycznych odpowiedzi, wiadomości z nieobsługiwanych adresów, pustych tematów, zbyt dużych załączników oraz wiadomości wieloczęściowych w formacie MIME. Logi integracji powinny wskazywać czas operacji, jej rezultat i techniczny identyfikator, ale nie powinny bez potrzeby powielać całej treści korespondencji.

Sprawdzenie działania integracji w praktyce serwisowej

Weryfikację warto rozpocząć od kontrolowanej wiadomości testowej zawierającej jednoznaczny temat, prostą treść i niewielki załącznik. Należy sprawdzić, czy powstaje tylko jedno zgłoszenie, czy pola są prawidłowo wypełnione oraz czy odpowiedź do zgłoszenia pozostaje powiązana z pierwotną sprawą. Następnie można przetestować ponowienie po błędzie połączenia, wiadomość z nieprawidłowymi danymi i odpowiedź w istniejącym wątku. Wynik powinien być widoczny zarówno w systemie ticketowym, jak i w logach modułu integracyjnego.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów. Przy problemach z działaniem oprogramowania obsługującego zgłoszenia można przeanalizować konfigurację klienta pocztowego, komunikację aplikacji, mapowanie pól oraz sposób zapisu błędów, aby oddzielić usterkę samego komputera od nieprawidłowości w przepływie danych między skrzynką a systemem ticketowym.