> 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 Mit einem [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) kann Ihr Empfangsassistent ein Freshdesk-Ticket öffnen, wenn ein Anrufer ein Problem meldet oder um Hilfe bittet, damit Ihr Team es bearbeiten kann. In den Tarifen Growth, Pro und Enterprise können Sie außerdem den [MCP-Server](#look-up-tickets-with-the-mcp-server) von Freshdesk verbinden, um bestehende Tickets abzurufen. ## Tickets erstellen ### API-Schlüssel abrufen Wählen Sie in Freshdesk Ihr Profilbild, öffnen Sie **Profileinstellungen** und wählen Sie **API-Schlüssel anzeigen**. Kopieren Sie den Schlüssel. Er fungiert als Ihr Agentenkonto, daher werden Tickets mit Ihren Berechtigungen erstellt. ### Autorisierungs-Header erstellen Freshdesk verwendet den API-Schlüssel als Benutzernamen und `X` als Passwort. Kodieren Sie ihn in einem Terminal und ersetzen Sie dabei `YOUR_API_KEY` durch Ihren Schlüssel: ```bash printf 'YOUR_API_KEY:X' | base64 ``` Der Header-Wert ist `Basic ` gefolgt von der Ausgabe. > **Warning** > > Fügen Sie Ihren API-Schlüssel nicht in einen Online-Kodierer ein. Jeder, der den Schlüssel oder den kodierten Header hat, kann > Ihre Tickets lesen und ändern. ### Webhook-Tool erstellen Gehen Sie zu **Integrationen**, wählen Sie **Integration hinzufügen** und dann **Webhook-Tool**. | Feld | Wert | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `create_freshdesk_ticket` | | **Beschreibung** | "Öffnen Sie ein Support-Ticket, wenn ein Anrufer ein Problem meldet oder Hilfe vom Team benötigt." | | **Methode** | POST | | **URL** | `https://YOURDOMAIN.freshdesk.com/api/v2/tickets` | | **Anfrage-Header** | `Authorization`: `Basic ` gefolgt vom kodierten Schlüssel | | **Body-Parameter** | `name` (String, erforderlich): "Vollständiger Name des Anrufers." `phone` (String): "Telefonnummer des Anrufers." `email` (String): "E-Mail-Adresse des Anrufers, falls angegeben." `subject` (String, erforderlich): "Eine kurze Zusammenfassung des Problems." `description` (String, erforderlich): "Was der Anrufer in eigenen Worten berichtet hat, einschließlich aller genannten Details." `status` (Zahl, erforderlich): "Immer genau der Wert `2`." `priority` (Zahl, erforderlich): "Immer genau der Wert `1`." `source` (Zahl, erforderlich): "Immer genau der Wert `3`." | | **Agenten zuweisen** | **Empfangsassistent** | Ersetzen Sie `YOURDOMAIN` durch Ihre Freshdesk-Subdomain. Wählen Sie **Aktivieren**. ### Testen [Testen Sie Ihren Empfangsassistenten](/docs/de/reception-ai/receptionist/testing), indem Sie ein Problem melden. Das Ticket wird in Freshdesk angezeigt. Die festen Werte erstellen das Ticket als **Offen** (Status `2`) mit **Niedriger** Priorität (Priorität `1`) und markieren es als von **Telefon** stammend (Quelle `3`). Damit der Empfangsassistent die Priorität festlegen kann, beschreiben Sie stattdessen die Werte, zum Beispiel: "1 für niedrig, 2 für mittel, 3 für hoch, 4 für dringend." Freshdesk benötigt eine Telefonnummer oder E-Mail-Adresse, um den Anfragenden zu finden oder zu erstellen. Weisen Sie Ihren Empfangsassistenten an, immer die Telefonnummer des Anrufers zu erfassen. ## Tickets mit dem MCP-Server abrufen Der [MCP-Server](/docs/de/reception-ai/integrations/mcp-server) von Freshdesk ist in den Tarifen Growth, Pro und Enterprise verfügbar. Nutzen Sie ihn, damit Ihr Empfangsassistent bestehende Tickets eines Anrufers abrufen kann. MCP-Aktionen werden auf ein jährliches Kontingent angerechnet, das von Ihrem Tarif abhängt. Gehen Sie in Reception.ai zu **Integrationen**, wählen Sie **Integration hinzufügen** und dann **MCP-Server**. | Feld | Wert | | --------------- | ----------------------------------------------- | | **Name** | Freshdesk | | **Servertyp** | Streamable HTTP | | **Server-URL** | `https://YOURDOMAIN.freshdesk.com/mcp` | | **HTTP-Header** | `Authorization`: Ihr API-Schlüssel, ohne Präfix | Lassen Sie **Secret Token** leer, damit Reception.ai Ihren `Authorization`-Header genau wie eingegeben sendet. Verwenden Sie Ihre `freshdesk.com`-Subdomain, auch wenn Sie eine eigene Domain haben. Wählen Sie **Aktivieren**. Öffnen Sie den Tab **Tools** und weisen Sie Ticket-Abruf-Tools wie `fetchSearchTickets` und `fetchTicket` dem **Client** (Empfangsassistenten) zu. Lassen Sie Tools zum Aktualisieren von Tickets, Agenten, Gruppen oder Artikeln nicht zugewiesen. ## Fehlerbehebung | Problem | Prüfen Sie Folgendes | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 von Freshdesk | Kodieren Sie den Schlüssel mit `:X` dahinter und beginnen Sie den Header-Wert mit `Basic ` und einem Leerzeichen. | | 400 zum Anfragenden | Das Ticket benötigt eine Telefonnummer oder E-Mail-Adresse sowie den Namen. Stellen Sie sicher, dass der Empfangsassistent diese erfasst. | | 400 zu Status oder Priorität | `status`, `priority` und `source` müssen Zahlenparameter sein, keine Strings. | | Der MCP-Server listet keine Tools auf | Verwenden Sie Ihre `freshdesk.com`-Subdomain und tragen Sie den unveränderten API-Schlüssel ohne `Basic` oder `Bearer` in den `Authorization`-Header ein. |