Integracje / Help Scout
Obsługa klienta i marketing
Integracja AI: Help Scout
Podłączamy skrzynki mailboxes przez REST API Help Scout v2 i czytamy wątki z conversations, threads oraz notatki wewnętrzne notes. Asystent przypisuje wiadomości do właściwych osób, wstawia szkice odpowiedzi do notes i alarmuje o wątkach bez reakcji.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem Help Scout?
Łączymy się przez REST API Help Scout w wersji 2 pod adresem api.helpscout.net/v2/. Uwierzytelniamy się przez OAuth 2.0 (App ID i App Secret z sekcji Your Profile › My Apps) albo kluczem API z ustawień konta, wystarczającym do automatów działających w tle.
- Na start potrzebujemy
- Konto Help Scout z rolą Owner lub Administrator do wygenerowania klucza API lub aplikacji OAuth
- Czego asystent nie robi
- Nie wysyła odpowiedzi bez zatwierdzenia przez pracownika w domyślnym trybie szkiców notes
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z Help Scout w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Kolejka konwersacji Help Scout. Moduł zbiera aktywne konwersacje ze wszystkich skrzynek Help Scout i pokazuje je w jednym widoku z priorytetem i stanem przypisania. Zespół widzi od razu, które wątki czekają bez agenta, które mają gotowy szkic i które przekroczyły dopuszczalny czas oczekiwania.
- Wyświetla aktywne konwersacje ze wszystkich skrzynek z bieżącym statusem i przypisaniem
- Oznacza wątki bez przypisania i te, które przekroczyły próg czasu reakcji
- Informuje, czy asystent wstawił już szkic odpowiedzi jako notatkę wewnętrzną
- Pozwala jednym kliknięciem przypisać konwersację do agenta i zatwierdzić szkic
- Filtruje według skrzynki, tagu i stanu, żeby każdy widział swój fragment kolejki

Pytanie w czacie
Zamiast ręcznego sortowania poniedziałkowej kolejki asystent proponuje podział w kilka sekund: pracownicy otwierają Help Scout i widzą własne sprawy z gotowym szkicem.
Które konwersacje na biuro@ wpłynęły w ostatnich 3 dniach i nie mają jeszcze przypisanej osoby? Powiedz, kto z zespołu powinien się każdą zająć.

Karta w narzędziu
Karta konwersacji łączy historię wątku z notatkami wewnętrznymi i gotowym szkicem, żeby przejmujący sprawę agent miał wszystko w jednym miejscu bez czytania całego wątku od nowa.
Jeden ekran zastępuje ręczne przeglądanie trzech skrzynek: zespół widzi priorytety, gotowe szkice i luki w kolejce bez przełączania zakładek w Help Scout.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Help Scout włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyconversationId, mailbox.name, status (active, pending, closed), assignee, subject, preview, customFields
AsystentPrzypisuje konwersację do agenta przez PATCH /v2/conversations/{id} i nadaje tagi na podstawie treści maila
Czytamytreść każdej wiadomości z rolą (customer, user), timestampem i danymi nadawcy
AsystentGeneruje streszczenie długiego wątku jako notatkę wewnętrzną, żeby przejmujący sprawę agent nie musiał czytać całej historii
Czytamytreść i autor notatek widocznych tylko dla zespołu, niedostępnych po stronie klienta
AsystentWstawia szkic odpowiedzi przez POST /v2/conversations/{id}/notes, pracownik sprawdza treść i wysyła jednym kliknięciem
CzytamyID i nazwa każdej skrzynki mailbox przypisanej do adresu email w koncie Help Scout
AsystentDobiera właściwy zestaw reguł routingu do skrzynki, np. inne priorytety dla reklamacje@ i inne dla sprzedaz@
Czytamytablica tagów przypisanych do konwersacji, np. reklamacja, pilne, logistyka
AsystentAktualizuje tagi przez API po analizie treści, co pozwala filtrować sprawy i tworzyć raporty bez ręcznego tagowania
Czytamytyp zdarzenia (convo.created, convo.assigned, convo.status.changed, convo.note.created) i ID konwersacji
AsystentUruchamia analizę w sekundy od wpłynięcia maila, bez cyklicznego odpytywania API, co skraca opóźnienie i ogranicza liczbę żądań
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Które wiadomości na biuro@ czekają bez odpowiedzi ponad 4 godziny?”
- „Kto z zespołu powinien odpowiedzieć na ten mail od klienta?”
- „Czy jest gotowy szkic odpowiedzi do tego wątku reklamacyjnego?”
- „Ile spraw oznaczono jako pilne i do kogo trafiły w tym tygodniu?”
Co się zmienia
Każdy mail trafia do właściwej osoby z gotowym szkicem w notes w ciągu sekund od wpłynięcia, a wątki bez reakcji nie znikają już w kolejce.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Help Scout to platforma obsługi klienta, z której korzystają firmy prowadzące wspólne skrzynki biuro@ lub sprzedaz@ w kilkuosobowym zespole. Każda wchodząca wiadomość staje się konwersacją z własnym ID, statusem i możliwością przypisania do agenta. Na co dzień pracownik otwiera Help Scout w przeglądarce, widzi swoje sprawy i odpowiada z poziomu platformy, bez przełączania się do osobnego klienta pocztowego.
Dane Help Scout trzyma w chmurze producenta. Obok wiadomości publicznych każda konwersacja może mieć notatki wewnętrzne notes, widoczne tylko dla zespołu, pola niestandardowe customFields i tablicę tagów. System reaguje webhookami na zdarzenia takie jak nowy mail czy zmiana przypisania, dzięki czemu asystent dostaje sygnał do działania w sekundy, bez oczekiwania na cykliczne odpytywanie API.
Gdzie to działa najlepiej
kierownik biura
Poniedziałek rano. Przez weekend wpłynęło ponad dwadzieścia maili na wspólną skrzynkę biuro@. Bez podziału cały zespół widzi te same wiadomości w kolejce Unassigned i nikt nie jest pewien, kto ma co zrobić jako pierwszy.
Z asystentem: Każda wiadomość trafia do właściwej osoby z gotowym szkicem odpowiedzi w notatce wewnętrznej. Kierownik otwiera Help Scout i widzi puste Unassigned, zamiast zajmować się ręcznym sortowaniem.
agent sprzedaży
Klient wysyła jeden mail z trzema sprawami naraz: pyta o status dostawy, prosi o fakturę proforma i zgłasza, że poprzednia paczka była niekompletna. W Help Scout to jeden wątek bez tagów, lądujący u pierwszej wolnej osoby z kolejki.
Z asystentem: AI rozpoznaje wiele tematów w jednym mailu, nadaje tagi reklamacja i zamówienie, przypisuje do właściwego agenta i wstawia szkic odpowiadający każdej sprawie osobno.
pracownik obsługi
Wraca po urlopie i przejmuje od kolegi wątek z kilkunastoma wiadomościami rozłożonymi na trzy tygodnie. Zanim napisze cokolwiek, musi przeczytać całą historię i połapać się, co ustalono i co zostało otwarte.
Z asystentem: AI generuje streszczenie jako notatkę na górze konwersacji: czego chciał klient, co ustalono, co czeka na odpowiedź. Pracownik czyta jedną notatkę zamiast całego wątku.
Jak się łączymy
Łączymy się przez REST API Help Scout w wersji 2 pod adresem api.helpscout.net/v2/. Uwierzytelniamy się przez OAuth 2.0 (App ID i App Secret z sekcji Your Profile › My Apps) albo kluczem API z ustawień konta, wystarczającym do automatów działających w tle. Webhooki reagują na convo.created, convo.assigned i convo.status.changed, więc analiza startuje w sekundy od wpłynięcia nowej wiadomości.
Tryb pracy: odczyt pól konwersacji i zapis (przypisanie agenta, tagi, notatki) po każdej analizie. Przy szkicach odpowiedzi AI wstawia projekt jako notatkę wewnętrzną, a pracownik decyduje o wysyłce. Portal z danymi i historią rozmów stoi na serwerze klienta. Do modelu trafia treść analizowanego wątku i polecenie, bez trenowania modeli na danych firmy. Limit Help Scout to 400 żądań na minutę na wyższych planach.
Czego potrzebujemy od Was
- Konto Help Scout z rolą Owner lub Administrator do wygenerowania klucza API lub aplikacji OAuth
- App ID i App Secret z sekcji My Apps lub klucz API wygenerowany w ustawieniach konta Help Scout
- Aktywne webhooki Help Scout na zdarzenia convo.created i convo.assigned skierowane na nasz adres
- Lista agentów z opisem obszarów (imię, email, zakres tematyczny) do konfiguracji routingu AI
- Weryfikacja limitu historycznych konwersacji przez API na Waszym planie przed uruchomieniem
Czego asystent nie robi
- Nie wysyła odpowiedzi bez zatwierdzenia przez pracownika w domyślnym trybie szkiców notes
- Nie pobiera automatycznie treści załączników PDF ani obrazów, tylko pola tekstowe z API
- Nie zmienia statusów konwersacji (pending, closed) bez wyraźnej reguły zatwierdzonej przez klienta
- Nie zastępuje oceny pracownika przy sprawach wymagających wiedzy branżowej lub decyzji handlowej
Częste pytania
Czy AI zobaczy maile ze skrzynek, do których nasze konto nie ma dostępu?
Nie. Integracja działa w ramach uprawnień konta, z którego pochodzi klucz API lub aplikacja OAuth. Jeśli konto ma dostęp tylko do wybranych skrzynek mailboxes, AI też widzi wyłącznie te. Zakres uprawnień ustalamy razem przed uruchomieniem.
Czy AI przeanalizuje starsze maile sprzed wdrożenia, czy tylko nowe?
Przez API Help Scout można sięgnąć do historycznych konwersacji. Na najtańszych planach dostęp może być ograniczony do ostatnich kilku tysięcy rozmów. Zakres historii sprawdzamy przed uruchomieniem i informujemy, gdzie zaczyna się analiza wsteczna.
Jak zaktualizować listę agentów, gdy ktoś dołącza do zespołu lub odchodzi?
Lista agentów z opisem ich obszarów to plik konfiguracyjny, który możecie zaktualizować bez wiedzy technicznej. Zmiana wchodzi w życie od następnej analizowanej wiadomości, bez ponownej instalacji ani kontaktu z nami.
Czy integracja zadziała, gdy klienci piszą do nas po angielsku lub innym języku?
Tak. Routing odbywa się na podstawie treści maila, a model językowy rozumie wiadomości w polskim, angielskim i innych językach. Opisy ról agentów podajecie po polsku, nawet gdy interfejs Help Scout macie ustawiony w angielskiej wersji.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
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ąć.
Inne programy: obsługa klienta i marketing
Help Scout jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.