Freshdesk | ElevenLabs Documentation

Met een webhooktool kan je receptionist een Freshdesk-ticket openen wanneer een beller een probleem meldt of om hulp vraagt, zodat je team het kan oppakken. Met Growth-, Pro- en Enterprise-abonnementen kun je ook de MCP-server van Freshdesk koppelen om bestaande tickets op te zoeken.

Tickets maken

Haal je API-sleutel op

Selecteer in Freshdesk je profielfoto, open Profielinstellingen en selecteer API-sleutel bekijken. Kopieer de sleutel. Deze fungeert als je agentaccount, waardoor tickets met jouw rechten worden gemaakt.

Maak de autorisatieheader

Freshdesk gebruikt de API-sleutel als gebruikersnaam en X als wachtwoord. Codeer deze in een terminal en vervang YOUR_API_KEY door je sleutel:

printf 'YOUR_API_KEY:X' | base64

De headerwaarde bestaat uit Basic gevolgd door de uitvoer.

Plak je API-sleutel niet in een online encoder. Iedereen met de sleutel of de gecodeerde header kan je tickets lezen en wijzigen.

Maak de webhooktool

Ga naar Integraties, selecteer Integratie toevoegen en kies Webhook Tool.

Veld	Waarde
Naam	`create_freshdesk_ticket`
Beschrijving	”Open een supportticket wanneer een beller een probleem meldt of hulp van het team nodig heeft.”
Methode	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Requestheaders	`Authorization`: `Basic` gevolgd door de gecodeerde sleutel
Bodyparameters	`name` (string, verplicht): “De volledige naam van de beller.” `phone` (string): “Het telefoonnummer van de beller.” `email` (string): “Het e-mailadres van de beller, als die dit heeft gegeven.” `subject` (string, verplicht): “Een korte samenvatting van het probleem.” `description` (string, verplicht): “Wat de beller heeft gemeld, in diens eigen woorden, met alle gegeven details.” `status` (number, verplicht): “Altijd exact de waarde `2`.” `priority` (number, verplicht): “Altijd exact de waarde `1`.” `source` (number, verplicht): “Altijd exact de waarde `3`.”
Toewijzen aan agents	Receptionist

Vervang YOURDOMAIN door je Freshdesk-subdomein. Selecteer Inschakelen.

Testen

Test je receptionist door een probleem te melden. Het ticket verschijnt in Freshdesk.

De vaste waarden maken het ticket als Open (status 2) met Lage prioriteit (prioriteit 1) en markeren het als afkomstig van Telefoon (bron 3). Als je de receptionist de prioriteit wilt laten instellen, beschrijf je de waarden in plaats daarvan, bijvoorbeeld: “1 voor laag, 2 voor gemiddeld, 3 voor hoog, 4 voor urgent.”

Freshdesk heeft een telefoonnummer of e-mailadres nodig om de aanvrager te vinden of te maken. Vertel je receptionist altijd het telefoonnummer van de beller te verzamelen.

Tickets opzoeken met de MCP-server

De MCP-server van Freshdesk is beschikbaar met Growth-, Pro- en Enterprise-abonnementen. Gebruik deze om je receptionist bestaande tickets van een beller te laten opzoeken. MCP-acties tellen mee voor een jaarlijkse limiet die afhankelijk is van je abonnement.

Ga in Reception.ai naar Integraties, selecteer Integratie toevoegen en kies MCP Server.

Veld	Waarde
Naam	Freshdesk
Servertype	Streamable HTTP
Server-URL	`https://YOURDOMAIN.freshdesk.com/mcp`
HTTP-headers	`Authorization`: je API-sleutel, zonder prefix

Laat Secret Token leeg, zodat Reception.ai je Authorization-header precies verstuurt zoals ingevoerd. Gebruik je freshdesk.com-subdomein, ook als je een aangepast domein hebt. Selecteer Inschakelen.

Open het tabblad Tools en wijs de tools voor het opzoeken van tickets, zoals fetchSearchTickets en fetchTicket, toe aan de Client (receptionist). Laat tools die tickets, agents, groepen of artikelen bijwerken niet toegewezen.

Problemen oplossen

Probleem	Wat je moet controleren
401 van Freshdesk	Codeer de sleutel met `:X` erachter en begin de headerwaarde met `Basic` en een spatie.
400 over de aanvrager	Het ticket heeft een telefoonnummer of e-mailadres nodig, plus de naam. Zorg dat de receptionist deze verzamelt.
400 over status of prioriteit	`status`, `priority` en `source` moeten number-parameters zijn, geen strings.
De MCP-server toont geen tools	Gebruik je `freshdesk.com`-subdomein en plaats de onbewerkte API-sleutel zonder `Basic` of `Bearer` in de `Authorization`-header.