🎧 Freshdesk w raportach, nie tylko w skrzynce
Integracja Freshdesk
Liczby z Freshdeska trafiają tam, gdzie zapadają decyzje: ile zgłoszeń wpłynęło, ile rozwiązano, ile czeka po terminie i jak długo trwa rozwiązanie. Firmy z Freshdeska łączymy z klientami w Twoim systemie, żeby dane o zgłoszeniach szły do właściwego konta.
Integracja Freshdesk w skrócie
Integracja Freshdesk to połączenie helpdesku Freshdesk z innymi systemami firmy przez Freshdesk API v2, dzięki któremu zgłoszenia, ich statusy, terminy i firmy klientów są dostępne w raportach, panelach i rozliczeniach bez ręcznego przepisywania. Budujemy ją własnym kodem albo przez n8n i Make.
Metryki zespołu obsługi.
Nowe, rozwiązane, otwarte i po terminie zgłoszenia, dziś i w bieżącym tygodniu.
Uczciwy czas rozwiązania.
Mediana i p90 tylko dla zgłoszeń z godzin pracy, żeby noc i weekend nie zawyżały wyniku.
Firmy dopasowane do klientów.
System podpowiada parę po nazwie, a człowiek ją zatwierdza.
Limity API pod kontrolą.
Zapytania rozłożone w czasie po naszej stronie i ponowienie po czasie, który podaje Freshdesk.
Freshdesk bez przepisywania liczb
Dziś: Liczby z Freshdeska przepisywane ręcznie do raportu
Po wdrożeniu: Metryki liczone z Freshdesk API według ustalonych reguł
Dziś: Średni czas rozwiązania zawyżony przez zgłoszenia z nocy
Po wdrożeniu: Mediana i p90 dla zgłoszeń z godzin pracy
Dziś: Firma we Freshdesku nazywa się inaczej niż klient w rozliczeniach
Po wdrożeniu: Podpowiedź pary po nazwie, zapis po zatwierdzeniu
Dziś: Rozliczenie klienta bez danych o zgłoszeniach
Po wdrożeniu: ID firmy z Freshdeska w danych do rozliczenia
Dziś: Limit API kończy się w połowie raportu
Po wdrożeniu: Zapytania rozłożone w czasie, ponowienie po czasie z nagłówka Retry-After
Freshdesk zostaje narzędziem zespołu obsługi, a liczby z niego trafiają tam, gdzie są potrzebne.
Co łączymy z Freshdeskiem
Zakres ustalamy na konsultacji. Najczęściej obejmuje te elementy.
Metryki zgłoszeń.
Nowe i rozwiązane dziś i w tygodniu, otwarte, po terminie i zgłoszenia oznaczone typem płatnym.
Czas rozwiązania.
Z dat rozwiązania z Freshdeska: mediana, średnia i p90, liczone tylko dla zgłoszeń utworzonych w dni robocze w godzinach pracy.
Firmy i klienci.
Lista firm z Freshdeska porównana z klientami w Twoim systemie. Para zapisuje się po zatwierdzeniu.
Dane do rozliczeń.
ID firmy z Freshdeska idzie razem z okresem rozliczenia do scenariusza w Make albo n8n.
Ekran dla zespołu.
Metryki na ekranie obsługi klienta w panelu albo na dashboardzie, obok danych z innych systemów.
Kontrola limitów i błędów.
Limit zapytań po naszej stronie, ponowienie po 429 i po chwilowych błędach serwera, stronicowanie po 100 rekordów.
Freshdesk w naszych wdrożeniach
Firma fulfillment: rozliczenia klientów magazynu
Firmy z Freshdeska dopasowane do klientów rozliczeń. ID firmy idzie razem z okresem rozliczenia do Make lub n8n.
- Freshdesk
- dopasowanie firm
- rozliczenie
- Make lub n8n
Ten sam magazyn: dashboard z ekranem obsługi klienta
Obok danych o pakowaniu jest ekran z metrykami zgłoszeń z Freshdeska: nowe, rozwiązane, otwarte i po terminie.
- Freshdesk
- metryki
- dashboard
Jak pracujemy
Konsultacja
Ustalamy, które liczby z Freshdeska są potrzebne, komu i z jakimi regułami, np. godziny pracy przy czasie rozwiązania.
Dostęp do API
Klucz API trzymany po stronie serwera. Zalecamy osobne konto agenta dla integracji.
Integracja
Pobieranie zgłoszeń i firm, metryki, dopasowanie firm do klientów, limit zapytań, kod albo scenariusz n8n lub Make.
Test i uruchomienie
Porównanie metryk z widokami we Freshdesku, potem start i opieka po wdrożeniu.
Czego nie robimy
- Nie kopiujemy treści zgłoszeń z danymi klientów do innych systemów, gdy wystarczą liczby.
- Nie przypisujemy firm do klientów automatycznie, bez zatwierdzenia człowieka.
- Nie trzymamy klucza API w przeglądarce ani w repozytorium.
- Nie wypuszczamy odpowiedzi AI do klientów bez testów na prawdziwych zgłoszeniach i zgody zespołu.
Narzędzia
Freshdesk API v2
Zgłoszenia ze statystykami, firmy, kontakty, wyszukiwanie i baza wiedzy.
n8n lub Make
Prostsze przepływy i dalsza obróbka danych rozliczenia. n8n → Make →
Python i Django
Metryki, dopasowanie firm, limit zapytań i harmonogram.
Next.js
Panel z dopasowaniem firm i ekranami dla zespołu.
Modele językowe
Przygotowanie artykułów z bazy wiedzy jako danych dla asystenta AI.
Opisz, co chcesz połączyć z Freshdeskiem
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak połączyć się z Freshdesk API?
Freshdesk API v2 działa pod adresem Twojej domeny Freshdesk z końcówką /api/v2, tylko przez HTTPS. Uwierzytelnienie to Basic Auth: klucz API jako nazwa użytkownika i dowolny znak jako hasło, zwykle X. Dane są w formacie JSON.
Gdzie znaleźć klucz API we Freshdesku?
Klucz API jest w ustawieniach profilu agenta: kliknij zdjęcie profilowe w prawym górnym rogu, wejdź w ustawienia profilu, a klucz jest obok zmiany hasła. To klucz osobisty, dlatego do integracji zalecamy osobne konto agenta zamiast klucza konkretnej osoby.
Ile zgłoszeń zwraca Freshdesk API na stronę?
Domyślnie 30, a parametrem per_page możesz ustawić do 100. Lista zgłoszeń bez filtra zwraca tylko zgłoszenia utworzone w ostatnich 30 dniach. Starsze pobierzesz z filtrem updated_since. Wyszukiwanie zgłoszeń zwraca 30 wyników na stronę i najwyżej 10 stron.
Jak policzyć czas rozwiązania zgłoszeń w Freshdesku przez API?
Pobierz zgłoszenia z parametrem include=stats, który dodaje m.in. datę rozwiązania i pierwszej odpowiedzi, i policz różnicę od daty utworzenia. My podajemy medianę i p90, a nie samą średnią, i liczymy tylko zgłoszenia utworzone w dni robocze w godzinach pracy. Dodatkowe dane w odpowiedzi zużywają więcej zapytań z limitu.
Jak dopasować firmy z Freshdeska do klientów w innym systemie?
Najpewniej po nazwie z podpowiedzią i zatwierdzeniem przez człowieka. System pobiera firmy z Freshdeska, usuwa z nazw formy prawne i znaki interpunkcyjne, porównuje je z nazwami klientów i pokazuje najlepszą parę z procentem podobieństwa. Po zatwierdzeniu ID firmy zapisuje się przy kliencie.
Co oznacza błąd 429 w Freshdesk API?
Błąd 429 oznacza przekroczenie limitu zapytań na minutę, który zależy od planu Freshdesk. Nagłówek Retry-After mówi, ile sekund czekać przed kolejnym zapytaniem. Integracja powinna trzymać zapytania w kolejce po swojej stronie i ponawiać je dopiero po tym czasie.
Czy bazę wiedzy z Freshdeska można wykorzystać do AI?
Tak. Artykuły z bazy wiedzy (kategorie, foldery, artykuły) da się pobrać przez API albo z eksportu i zamienić na pary pytanie i odpowiedź dla asystenta AI. Robiliśmy to technicznie: z eksportu bazy wiedzy wyciągnęliśmy tytuły i treści artykułów i przygotowaliśmy z nich dane dla modelu.
Co daje integracja Freshdesk z Twoimi systemami?
Freshdesk dobrze obsługuje rozmowy z klientami, ale liczby z niego zwykle są potrzebne gdzie indziej: na ekranie dla kierownika, w raporcie dla zarządu, w rozliczeniu klienta. Integracja przez Freshdesk API sprawia, że te liczby liczą się same, według reguł ustalonych z zespołem, zamiast być przepisywane z widoków helpdesku.
Drugi powód to łączenie danych. Firma we Freshdesku jest często tym samym klientem, który ma konto w systemie zamówień, magazynu czy fakturowania. Gdy obie strony znają wspólny identyfikator, dane o zgłoszeniach można przypisać do właściwego klienta w każdym z tych systemów.
Jakie metryki obsługi klienta policzysz z Freshdesk API?
| Metryka | Jak liczymy |
|---|---|
| Nowe zgłoszenia dziś i w tygodniu | data utworzenia w strefie czasowej firmy, tydzień od poniedziałku |
| Rozwiązane dziś i w tygodniu | status rozwiązane albo zamknięte i data rozwiązania z include=stats |
| Otwarte | zgłoszenia zmienione w ostatnich 7 dniach, które nie są rozwiązane ani zamknięte |
| Po terminie | zgłoszenia zmienione w ostatnich 7 dniach, których termin due_by minął przed rozwiązaniem |
| Płatne w tygodniu | zgłoszenia oznaczone typem płatnym |
| Czas rozwiązania | mediana, średnia i p90, tylko zgłoszenia z dni roboczych od 7:00 do 15:00 |
Zgłoszenia pobieramy z filtrem zmian z ostatnich 7 dni. Reguły, np. godziny pracy albo to, co znaczy zgłoszenie płatne, ustalamy z zespołem przy wdrożeniu.
Jak połączyć firmy z Freshdeska z klientami w rozliczeniach?
- Pobranie firm z Freshdesk API, po 100 na stronę.
- Porównanie nazw z klientami, którzy nie mają jeszcze przypisanej firmy, po usunięciu form prawnych typu sp. z o.o. i znaków interpunkcyjnych.
- Podpowiedź pary z procentem podobieństwa, od najpewniejszych.
- Zatwierdzenie przez osobę z zespołu i zapis ID firmy przy kliencie.
- Użycie ID w danych do rozliczenia, które idą do scenariusza w Make albo n8n.
Limity i pułapki Freshdesk API
- Limit na minutę zależy od planu (stan na listopad 2026). Aktualny stan pokazują nagłówki X-RateLimit-Total i X-RateLimit-Remaining w każdej odpowiedzi.
- Lista zgłoszeń bez filtra to tylko 30 dni. Starsze zgłoszenia trzeba pobierać z filtrem updated_since, a lista ma limit 300 stron.
- Wyszukiwanie ma swoje granice: 30 wyników na stronę, najwyżej 10 stron, bez zgłoszeń zarchiwizowanych, a zmiany pojawiają się w wynikach po kilku minutach.
- Zamknięte zgłoszenia mogą trafić do archiwum po 120 dniach bez aktywności, zależnie od ruchu na koncie. Dane do raportów historycznych warto zapisywać u siebie.
- Większa strona to mniej zapytań: per_page do 100 zamiast domyślnych 30.
Baza wiedzy z Freshdeska jako dane dla AI
Artykuły z bazy wiedzy Freshdeska to gotowy materiał dla asystenta AI: tytuł jest zwykle pytaniem klienta, a treść odpowiedzią. Przygotowaliśmy już technicznie taki zestaw z eksportu bazy wiedzy: wyciągnięcie tytułów i treści bez HTML i zamianę na pary pytanie i odpowiedź dla modelu. Zanim taki asystent odpowie klientom, testujemy go na prawdziwych zgłoszeniach i ustalamy z zespołem, kiedy przekazuje rozmowę człowiekowi. Więcej o tym przeczytasz na stronie automatyzacja obsługi klienta.

