Freshdesk | ElevenLabs Documentation

Mit einem Webhook-Tool 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 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:

printf 'YOUR_API_KEY:X' | base64

Der Header-Wert ist Basic gefolgt von der Ausgabe.

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