Narzędzia

Jak AI może przypisywać maile i przygotowywać odpowiedzi w Help Scout i Front?

AI podpięte do Help Scout lub Front samo przypisuje maile, streszcza wątki i przygotowuje projekt odpowiedzi do zatwierdzenia. REST API, konkretne pola i wdrożenie krok po kroku.

⏱ 10 min czytania · 📅 17.11.2026 · 👁 131 wyświetleń

AI można podpiąć do Help Scout i Front przez ich REST API i już po kilku dniach wspólna skrzynka biuro@ przestaje być miejscem, gdzie wiadomości giną, bo nikt nie wiedział, kto ma odpowiedzieć. System czyta treść każdej nowej wiadomości, przypisuje ją właściwej osobie, przygotowuje projekt odpowiedzi jako notatkę wewnętrzną do zatwierdzenia i wyłapuje wątki, które za długo czekają bez reakcji. Pierwsze automaty można uruchomić w ciągu kilku dni roboczych, bez przebudowy tego, jak dziś pracuje Wasz zespół.

Skąd bierze się chaos w wspólnej skrzynce

Zacznijmy od sytuacji, którą zna niemal każda firma z choćby dwiema osobami obsługującymi biuro@ lub sprzedaz@. Klient pisze jedną wiadomość z trzema sprawami naraz: pyta o status zamówienia, prosi o fakturę proforma i zgłasza, że poprzednia dostawa była niekompletna. Trzy sprawy, trzy różne osoby w firmie. Ktoś musi ten mail przeczytać, ocenić i rozdzielić.

W Help Scout ta czynność to ręczne kliknięcie w przycisk Assign i wybranie agenta z listy. W Front to przeciągnięcie rozmowy na właściwego teammate albo wybranie go z menu. Brzmi prosto, ale gdy dziennie wpływa kilkadziesiąt wiadomości na jedną skrzynkę, ktoś musi spędzić przy tym kawał przedpołudnia, zanim reszta zespołu w ogóle zobaczy swoje zadania. I ta jedna osoba nigdy nie jest tak rzetelna jak algorytm: zdarzają się błędy, pominięcia, a w gorącym tygodniu po prostu zapomnienie.

Drugi problem to wiadomości, które nie trafiają do nikogo. W Help Scout konwersacja bez przypisania ma status Unassigned i siedzi w kolejce razem ze wszystkimi innymi. Nikt się nie czuje odpowiedzialny. W Front jest sekcja Unassigned conversations, którą łatwo zignorować, gdy jest się zajętym własnymi wątkami. Bez czegoś, co aktywnie pilnuje tych wiadomości, przeterminowane sprawy są kwestią czasu.

U jednego z naszych klientów, firmy handlowej z czterema handlowcami na skrzynce sprzedaz@, round-robin w Front przypisywał każdą wiadomość kolejno do następnej osoby na liście. Klient napisał o reklamacji i o nowym zamówieniu w tym samym mailu. Trafił do handlowca, który zajął się zamówieniem i oznaczył sprawę jako zamkniętą. Reklamacja przepadła na trzy dni. Gdy klient napisał drugi mail z tytułem "PILNE", zaczęły się przeprosiny i rabat, którego firma woleliby uniknąć. Klasyczny scenariusz, który powtarza się wszędzie tam, gdzie routing odbywa się ręcznie albo według prostej kolejności.

Jak wygląda podłączenie: Help Scout API i Front API od strony technicznej

Obydwa systemy mają otwarte REST API, przez które można czytać i zapisywać dane w czasie rzeczywistym. To podstawa każdej integracji z AI. Poniżej to, co dostajecie i czego nie dostajecie.

Help Scout udostępnia REST API w wersji 2 pod adresem api.helpscout.net/v2/. Żeby się podłączyć, potrzebujecie konta z rolą Owner lub Administrator. Następnie tworzycie własną aplikację w sekcji Your Profile > My Apps > Create a My App, gdzie dostajecie App ID i App Secret do uwierzytelniania przez OAuth 2.0. Jest też prostszy wariant: wygenerowanie klucza API w ustawieniach konta, wystarczający do automatów działających w tle. Przez API macie dostęp do:

  • /v2/conversations: lista rozmów z filtrowaniem po skrzynce, statusie, tagach i przypisaniu
  • /v2/conversations/{id}: pełny wątek ze wszystkimi polami, w tym customFields
  • /v2/conversations/{id}/threads: poszczególne wiadomości z rolą (customer, user), treścią i timestampem
  • /v2/conversations/{id}/notes: notatki wewnętrzne, do których AI dopisuje swoje projekty odpowiedzi
  • /v2/mailboxes: lista skrzynek z ich ID i nazwami

Webhooki Help Scout reagują na zdarzenia: convo.created (nowa wiadomość), convo.assigned (zmiana przypisania), convo.status.changed (np. przejście do pending lub closed) i convo.note.created. Limit zapytań to 400 żądań na minutę na wyższych planach.

Front działa na REST API v1 pod adresem api2.frontapp.com/. Token dostępowy tworzycie w Settings > Developers > API Tokens, gdzie nadajecie mu nazwę i zakres uprawnień: read conversations, write comments, manage assignments. Zalecamy osobne konto integracyjne, żeby akcje AI były widoczne jako osobny aktor w historii zmian i nie mieszały się z działaniami ludzi. Przez API Fronta macie dostęp do:

  • /conversations: lista rozmów z polem last_message.created_at i informacją o assignee
  • /conversations/{id}/messages: pełna historia wiadomości z treścią, nadawcą i metadanymi
  • /conversations/{id}/comments: odpowiednik notatek wewnętrznych w Help Scout, tu AI wstawia szkice
  • /conversations/{id}/tags: tagi przypisane do wątku
  • /teammates: lista użytkowników z ich ID i adresami email

Webhooki Fronta są bogate: conversation_assigned, message_received, conversation_opened, conversation_archived. Reagują błyskawicznie, co pozwala uruchamiać AI w sekundy po wpłynięciu maila.

Co producenci nie udostępniają przez API: treść załączników nie jest od razu w przetwarzalnym formacie. Plik PDF lub obraz trzeba osobno pobrać przez URL zawarty w obiekcie wiadomości i przesłać do analizy. Na najtańszych planach Help Scout historyczne dane przez API mogą być ograniczone do ostatnich kilku tysięcy konwersacji. Sprawdźcie to przed wdrożeniem, żeby logika AI nie zawodziła na starszych wątkach.

Co wyciągamy z systemu i jak to trafia do AI

Dla każdej nowej lub zmienionej konwersacji skrypt wyciąga konkretny zestaw pól. Z Help Scout pobieramy:

  • conversationId i mailbox.name: żeby wiedzieć, o której skrzynce mowa i do jakiego kontekstu przypisać odpowiedź
  • status: active, pending, closed
  • assignee: imię, email i ID agenta albo null, jeśli wiadomość nieprzypisana
  • subject i preview: temat maila i pierwsze zdania treści
  • tags: tablica tagów, np. ["reklamacja", "pilne", "logistyka"]
  • waitingSince: timestamp ostatniej wiadomości od klienta, na którą jeszcze nie odpowiedziano
  • threads: pełna historia rozmowy z rolami customer i user

Z Fronta analogicznie: conversation.id, channel.name, assignee.email, latest_message.body, tags, last_message.created_at i lista comments jako historia wątku. Pola niestandardowe, jeśli firma je skonfigurowała, też są dostępne.

Te dane trafiają do modelu językowego razem z kontekstem firmy: lista agentów z opisem ich obszaru, np. "Jan Kowalski: reklamacje i logistyka, Anna Nowak: faktury i zamówienia, Tomasz Wiśniewski: wyceny i nowi klienci". Model zwraca ustrukturyzowaną odpowiedź w formacie JSON: pole assignee_email, suggested_tags, priority i draft_response. Skrypt bierze tę odpowiedź i przez API wykonuje konkretne akcje w Help Scout lub Front.

Cztery konkretne zadania, które AI przejmuje każdego dnia

Przypisanie do właściwej osoby. To najprostsze i przynoszące natychmiastowy efekt. AI czyta temat i treść maila, porównuje z opisami ról i przypisuje rozmowę konkretnej osobie lub grupie. W Help Scout przez PATCH /v2/conversations/{id} z polem assignee.email. W Front przez PATCH /conversations/{id} z polem assignee_id. Każde przypisanie można ręcznie zmienić jednym kliknięciem, więc błędy AI nie blokują pracy. Przez kilka pierwszych tygodni warto przeglądać zmiany ręczne: to sygnał, gdzie logika routingu wymaga poprawy.

Projekt odpowiedzi do zatwierdzenia. AI nie wysyła odpowiedzi samo, przynajmniej na początku. Generuje projekt i wstawia go jako notatkę wewnętrzną: Note w Help Scout lub Comment w Front. Pracownik widzi szkic od razu po otwarciu wątku, kopiuje do pola Reply, poprawia szczegóły i wysyła. Zamiast pisać od zera, sprawdza i zatwierdza. To inna praca, o wiele szybsza, a błąd merytoryczny zawsze wyłapie człowiek przed wysyłką.

Alert na wiadomości bez odpowiedzi. Każda firma ma inny próg: 2 godziny, 4 godziny, do końca dnia roboczego. Skrypt filtruje konwersacje po statusie active, polu assignee: null i wartości waitingSince starszej niż ustalony próg. Wynik idzie jako podsumowanie na maila do kierownika lub do kanału na Teamsach: ile wiadomości, jak długo czekają, od kogo. Brzmi jak drobiazg. W praktyce to jeden z pierwszych automatów, który firmy chcą zostawić na zawsze.

Streszczenie długich wątków. Gdy wątek ma kilkanaście lub więcej wiadomości albo wróciła sprawa sprzed kilku tygodni, AI generuje streszczenie: czego chciał klient, co ustalono, co zostało otwarte. Streszczenie ląduje jako Note na górze wątku w Help Scout lub jako Comment w Front. Nowa osoba, która przejmuje sprawę po urlopie kolegi, nie musi czytać całej historii. Dwie minuty zamiast piętnastu.

Jak to wygląda w praktyce: jeden poranek w firmie handlowej

Poniedziałek, 8:15. Przez weekend na skrzynkę sprzedaz@ w Help Scout wpłynęło 27 wiadomości. Bez AI ktoś musiałby je przejrzeć i rozdzielić zanim zespół zacznie pracować.

Z AI wygląda to inaczej. Każdy nowy mail uruchomił webhook convo.created. Skrypt pobrał treść, temat i dane nadawcy, wysłał do modelu i dostał z powrotem instrukcję w JSON: "przypisz do jan.kowalski@firma.pl, nadaj tag logistyka, priorytet normalny, szkic odpowiedzi gotowy". Przez API rozmowa została przypisana i otagowana w ciągu kilku sekund od wpłynięcia maila. Jeszcze w nocy.

Gdy Jan przychodzi rano, widzi w Help Scout tylko 9 rozmów: swoje. Każda ma Note z projektem odpowiedzi. Cztery pytają o termin dostawy, dwie to prośby o wycenę, trzy to potwierdzenia zamówień. Jan pracuje od razu, nie musi sortować. Anna i Tomasz mają analogicznie swoje.

O 8:00 kierownik dostał na maila: "2 wiadomości bez przypisania, najstarsza od piątku 17:42, nadawca: firma@klient.pl, temat: reklamacja faktury 11/2026". Kierownik otwiera Help Scout, sprawdza i sam przypisuje do księgowości. Sprawa obsłużona zanim klient napisze ponaglenie.

Od czego zaczyna się wdrożenie i na co uważać

Zaczynamy zawsze od tego samego pierwszego kroku: pobieramy listę konwersacji z ostatnich czterech tygodni i sprawdzamy rozkład tematów. Ile jest reklamacji, ile zapytań handlowych, ile spraw administracyjnych, ile wiadomości, które trafiają na wspólną skrzynkę, bo klient nie wie, gdzie pisać. To daje obraz, jak powinna wyglądać logika routingu i czy jest sens ją budować dla tej konkretnej skrzynki.

Potem uruchamiamy najprostszy automat: wykrywanie nieprzypisanych wiadomości starszych niż dwie godziny i wysyłanie alertu. Żadnego AI, żadnego routingu, tylko warunek i powiadomienie. Firma od razu widzi, gdzie są dziury. I przekonuje się, że system faktycznie działa.

Kolejny krok to routing oparty na AI. Zaczynamy od jednej skrzynki z największym ruchem, gdzie podział tematyczny jest oczywisty. Przez tydzień sprawdzamy, ile przypisań AI zrobiło dobrze, ile źle. Złe przypadki pomagają doprecyzować opis ról, który dostaje model. Po dwóch, trzech tygodniach logika routingu zwykle stabilizuje się na poziomie, który wymaga minimalnej interwencji ręcznej.

Szkice odpowiedzi wdrażamy jako ostatnie. Wymagają więcej przygotowania: AI musi znać ton firmy, typowe odpowiedzi na powtarzające się pytania i granice tego, czego nie wolno obiecywać klientowi bez konsultacji z kimś wyżej. Zbieramy do tego kilkadziesiąt przykładowych par pytanie-odpowiedź z historii konwersacji i dajemy je modelowi jako kontekst.

Żeby to wszystko działało, potrzebujecie planu Help Scout lub Front z dostępem do API. Sprawdźcie przed wdrożeniem, bo najtańsze warianty czasem mają API ograniczone albo wyłączone. Do tego klucz API lub token OAuth, skrypt integracyjny i środowisko, w którym ten skrypt działa bez przerwy. Nie musi to być osobny serwer: wystarczy zadanie cykliczne lub obsługa webhooków na portalu firmy.

Jeśli chcecie zobaczyć, jak taki przepływ działa na Waszych danych ze skrzynki, zapraszamy na 15 minut rozmowy. Możemy też pokazać, jak wyglądały podobne wdrożenia u innych firm: realne wdrożenia.

Chcecie to u siebie?

Na osobnej stronie rozpisaliśmy, co dokładnie podłączamy w Help Scout, o co możecie wtedy pytać asystenta i ile kosztuje wdrożenie.

Co podłączamy i ile to kosztuje →

Najczęstsze pytania

Czy AI może samo wysyłać odpowiedzi w Help Scout bez zatwierdzenia przez człowieka?

Może, ale bezpieczniej zacząć od trybu do zatwierdzenia: AI wstawia projekt jako notatkę wewnętrzną, a pracownik jednym kliknięciem go wysyła. Pełna automatyka dobrze sprawdza się wyłącznie w wąskiej kategorii maili, gdzie błąd nic nie kosztuje, np. autopowtierdzenia odbioru zgłoszenia.

Czy Help Scout i Front mają otwarte API, przez które można podpiąć AI?

Tak, obydwa udostępniają REST API. Help Scout ma wersję 2 z OAuth 2.0 i webhookami reagującymi na nowe wiadomości w czasie rzeczywistym, Front działa na API v1 z tokenem dostępowym. Przez oba można czytać i zapisywać wiadomości, przypisania, tagi, notatki i statusy.

Co się stanie, gdy AI przypisze mail do złej osoby?

Każde przypisanie można ręcznie zmienić jednym kliknięciem w Help Scout lub Front, więc błąd AI nie blokuje pracy. Warto logować, co system przypisał i dlaczego, żeby z biegiem tygodnia poprawiać opisy ról i doszczegółowiać logikę routingu.

Czy integracja AI z Help Scout lub Front wymaga osobnego programisty?

Proste pobieranie danych przez API, routing do właściwej osoby i generowanie szkiców odpowiedzi to kilkadziesiąt linii kodu, które można uruchomić w kilka dni roboczych. Bardziej rozbudowane przepływy z własnym ekranem do zatwierdzania odpowiedzi wymagają więcej pracy, ale nie jest to projekt na miesiące.

Jakie uprawnienia są potrzebne, żeby podpiąć AI do Help Scout lub Front?

W Help Scout potrzebna jest rola Owner lub Administrator, żeby wygenerować klucz API lub stworzyć aplikację OAuth. W Front wymagane jest konto Administratora do tworzenia tokenów API i konfiguracji webhooków. Zalecamy osobne konto integracyjne, żeby akcje AI były widoczne jako osobny aktor w historii zmian.

Wolicie napisać

Pokażemy to na Waszych danych z Help Scout

Jedno zdanie wystarczy: czego szukacie w Help Scout albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Opracowanie: zespół redAi z wykorzystaniem narzędzi AI.

Następny krok

Podłączymy Help Scout do AI u Was

15 minut rozmowy: mówicie, czego szukacie w danych, my mówimy, co wyciągniemy z Help Scout, ile to potrwa i czego potrzebujemy po Waszej stronie.

  • Bezpłatna prezentacjaAI na Waszych zadaniach, nie na slajdach.
  • Dostęp tego samego dniaZespół od razu pracuje we własnym portalu.
  • Do 2 tygodni testówPłacicie dopiero po decyzji.

Może Was też zainteresować