Freshdesk | ElevenLabs Documentation

Dzięki narzędziu webhook twoja recepcjonistka może otworzyć zgłoszenie Freshdesk, gdy rozmówca zgłosi problem lub poprosi o pomoc, aby twój zespół mógł się nim zająć. W planach Growth, Pro i Enterprise możesz też połączyć serwer MCP Freshdesk, aby wyszukiwać istniejące zgłoszenia.

Tworzenie zgłoszeń

Pobierz klucz API

W Freshdesk wybierz swoje zdjęcie profilowe, otwórz Profile settings i wybierz View API key. Skopiuj klucz. Działa jak konto agenta, więc zgłoszenia są tworzone z twoimi uprawnieniami.

Utwórz nagłówek autoryzacji

Freshdesk używa klucza API jako nazwy użytkownika, a X jako hasła. Zakoduj go w terminalu, zastępując YOUR_API_KEY swoim kluczem:

printf 'YOUR_API_KEY:X' | base64

Wartość nagłówka to Basic , a po nim wynik.

Nie wklejaj klucza API do internetowego kodera. Każdy, kto ma klucz lub zakodowany nagłówek, może odczytywać i zmieniać twoje zgłoszenia.

Utwórz narzędzie webhook

Przejdź do Integrations, wybierz Add integration, a potem Webhook Tool.

Pole	Wartość
Nazwa	`create_freshdesk_ticket`
Opis	”Otwórz zgłoszenie do pomocy technicznej, gdy rozmówca zgłosi problem lub potrzebuje pomocy zespołu.”
Metoda	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Nagłówki żądania	`Authorization`: `Basic` , po którym znajduje się zakodowany klucz
Parametry body	`name` (string, wymagane): “Pełne imię i nazwisko rozmówcy.” `phone` (string): “Numer telefonu rozmówcy.” `email` (string): “Adres e-mail rozmówcy, jeśli go podał.” `subject` (string, wymagane): “Krótkie podsumowanie problemu.” `description` (string, wymagane): “Co zgłosił rozmówca, jego słowami, wraz ze wszystkimi podanymi szczegółami.” `status` (number, wymagane): “Zawsze dokładnie wartość `2`.” `priority` (number, wymagane): “Zawsze dokładnie wartość `1`.” `source` (number, wymagane): “Zawsze dokładnie wartość `3`.”
Przypisz agentom	Recepcjonistka

Zastąp YOURDOMAIN subdomeną Freshdesk. Wybierz Enable.

Przetestuj

Przetestuj recepcjonistkę, zgłaszając problem. Zgłoszenie pojawi się w Freshdesk.

Stałe wartości tworzą zgłoszenie jako Open (status 2) z Low priorytetem (priority 1) i oznaczają je jako pochodzące z Phone (source 3). Aby pozwolić recepcjonistce ustawiać priorytet, opisz zamiast tego wartości, na przykład: “1 dla niskiego, 2 dla średniego, 3 dla wysokiego, 4 dla pilnego.”

Freshdesk potrzebuje numeru telefonu lub e-maila, aby znaleźć albo utworzyć osobę zgłaszającą. Powiedz recepcjonistce, by zawsze zbierała numer telefonu rozmówcy.

Wyszukiwanie zgłoszeń przez serwer MCP

Serwer MCP Freshdesk jest dostępny w planach Growth, Pro i Enterprise. Użyj go, aby recepcjonistka mogła wyszukiwać istniejące zgłoszenia rozmówcy. Akcje MCP są wliczane do rocznego limitu zależnego od twojego planu.

W Reception.ai przejdź do Integrations, wybierz Add integration, a potem MCP Server.

Pole	Wartość
Nazwa	Freshdesk
Typ serwera	Streamable HTTP
URL serwera	`https://YOURDOMAIN.freshdesk.com/mcp`
Nagłówki HTTP	`Authorization`: twój klucz API, bez prefiksu

Pozostaw Secret Token puste, aby Reception.ai wysyłało nagłówek Authorization dokładnie tak, jak został wpisany. Użyj subdomeny freshdesk.com, nawet jeśli masz własną domenę. Wybierz Enable.

Otwórz kartę Tools i przypisz narzędzia do wyszukiwania zgłoszeń, takie jak fetchSearchTickets i fetchTicket, do Client (recepcjonistki). Nie przypisuj narzędzi aktualizujących zgłoszenia, agentów, grupy lub artykuły.

Rozwiązywanie problemów

Problem	Co sprawdzić
401 z Freshdesk	Zakoduj klucz z `:X` na końcu i zacznij wartość nagłówka od `Basic` oraz spacji.
400 dotyczący zgłaszającego	Zgłoszenie wymaga numeru telefonu lub e-maila oraz imienia i nazwiska. Upewnij się, że recepcjonistka je zbiera.
400 dotyczący statusu lub priorytetu	`status`, `priority` i `source` muszą być parametrami typu number, a nie string.
Serwer MCP nie wyświetla narzędzi	Użyj subdomeny `freshdesk.com` i umieść surowy klucz API w nagłówku `Authorization` bez `Basic` ani `Bearer`.