> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Freshdesk Dzięki [narzędziu webhook](/docs/pl/reception-ai/integrations/webhooks) 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](#look-up-tickets-with-the-mcp-server) 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: ```bash printf 'YOUR_API_KEY:X' | base64 ``` Wartość nagłówka to `Basic `, a po nim wynik. > **Warning** > > 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ę](/docs/pl/reception-ai/receptionist/testing), 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](/docs/pl/reception-ai/integrations/mcp-server) 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`. |