> 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 Met een [webhooktool](/docs/nl/reception-ai/integrations/webhooks) 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](#look-up-tickets-with-the-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: ```bash printf 'YOUR_API_KEY:X' | base64 ``` De headerwaarde bestaat uit `Basic ` gevolgd door de uitvoer. > **Warning** > > 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](/docs/nl/reception-ai/receptionist/testing) 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](/docs/nl/reception-ai/integrations/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. |