Today Automate logo

🎧 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.

Tablet z wyszukiwarką i dymkiem rozmowy, symbol zgłoszeń klientów

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.

Niebieski dymek rozmowy, symbol obsługi klienta

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.

Tablet z wykresami, symbol metryk obsługi klienta

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.

    1. Freshdesk
    2. dopasowanie firm
    3. rozliczenie
    4. Make lub n8n
    Czytaj case study →
  • 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.

    1. Freshdesk
    2. metryki
    3. dashboard
    Czytaj case study →

Jak pracujemy

  1. Konsultacja

    Ustalamy, które liczby z Freshdeska są potrzebne, komu i z jakimi regułami, np. godziny pracy przy czasie rozwiązania.

  2. Dostęp do API

    Klucz API trzymany po stronie serwera. Zalecamy osobne konto agenta dla integracji.

  3. Integracja

    Pobieranie zgłoszeń i firm, metryki, dopasowanie firm do klientów, limit zapytań, kod albo scenariusz n8n lub Make.

  4. 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.

  • Logo n8nLogo Make

    n8n lub Make

    Prostsze przepływy i dalsza obróbka danych rozliczenia. n8n → Make →

  • Logo PythonLogo Django

    Python i Django

    Metryki, dopasowanie firm, limit zapytań i harmonogram.

  • Logo Next.js

    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

  1. Odpisujemy w ciągu 1 dnia roboczego.
  2. Umawiamy 30-minutową rozmowę.
  3. Przygotowujemy propozycję i wycenę.

pole wymagane

Administratorem Twoich danych jest Today Group spółka z ograniczoną odpowiedzialnością (KRS 0001253446, NIP 9542911671). Użyjemy ich tylko po to, żeby odpowiedzieć na Twoje zapytanie. Podstawą jest nasz uzasadniony interes, czyli odpowiedź na Twoje zapytanie (art. 6 ust. 1 lit. f RODO). Masz prawo dostępu do danych, ich poprawienia, usunięcia i sprzeciwu. Szczegóły są w polityce prywatności.

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?

Metryki z naszego wdrożenia i skąd je liczymy
MetrykaJak liczymy
Nowe zgłoszenia dziś i w tygodniudata utworzenia w strefie czasowej firmy, tydzień od poniedziałku
Rozwiązane dziś i w tygodniustatus rozwiązane albo zamknięte i data rozwiązania z include=stats
Otwartezgłoszenia zmienione w ostatnich 7 dniach, które nie są rozwiązane ani zamknięte
Po terminiezgłoszenia zmienione w ostatnich 7 dniach, których termin due_by minął przed rozwiązaniem
Płatne w tygodniuzgłoszenia oznaczone typem płatnym
Czas rozwiązaniamediana, ś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?

  1. Pobranie firm z Freshdesk API, po 100 na stronę.
  2. 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.
  3. Podpowiedź pary z procentem podobieństwa, od najpewniejszych.
  4. Zatwierdzenie przez osobę z zespołu i zapis ID firmy przy kliencie.
  5. Użycie ID w danych do rozliczenia, które idą do scenariusza w Make albo n8n.
Dlaczego nie automatycznie? Podobne nazwy dwóch różnych firm to częsty przypadek. Błędna para to dane o zgłoszeniach przypisane do złego klienta, więc decyzję zostawiamy człowiekowi.

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.