Freshdesk | ElevenLabs Documentation

Med ett webhook-verktyg kan din receptionist öppna ett Freshdesk-ärende när en uppringare rapporterar ett problem eller ber om hjälp, så att ditt team kan ta hand om det. Med abonnemangen Growth, Pro och Enterprise kan du även ansluta Freshdesks MCP-server för att söka efter befintliga ärenden.

Skapa ärenden

Hämta din API-nyckel

I Freshdesk väljer du din profilbild, öppnar Profile settings och väljer View API key. Kopiera nyckeln. Den fungerar som ditt agentkonto, så ärenden skapas med dina behörigheter.

Skapa auktoriseringshuvudet

Freshdesk använder API-nyckeln som användarnamn och X som lösenord. Koda den i en terminal och ersätt YOUR_API_KEY med din nyckel:

printf 'YOUR_API_KEY:X' | base64

Huvudvärdet är Basic följt av resultatet.

Klistra inte in din API-nyckel i en onlinekodare. Alla som har nyckeln eller det kodade huvudet kan läsa och ändra dina ärenden.

Skapa webhook-verktyget

Gå till Integrations, välj Add integration och sedan Webhook Tool.

Fält	Värde
Namn	`create_freshdesk_ticket`
Beskrivning	”Öppna ett supportärende när en uppringare rapporterar ett problem eller behöver hjälp från teamet.”
Metod	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Request Headers	`Authorization`: `Basic` följt av den kodade nyckeln
Body Parameters	`name` (sträng, obligatoriskt): “Uppringarens fullständiga namn.” `phone` (sträng): “Uppringarens telefonnummer.” `email` (sträng): “Uppringarens e-postadress, om de angav den.” `subject` (sträng, obligatoriskt): “En kort sammanfattning av problemet.” `description` (sträng, obligatoriskt): “Vad uppringaren rapporterade, med egna ord och med alla detaljer de angav.” `status` (nummer, obligatoriskt): “Alltid exakt värdet `2`.” `priority` (nummer, obligatoriskt): “Alltid exakt värdet `1`.” `source` (nummer, obligatoriskt): “Alltid exakt värdet `3`.”
Tilldela agenter	Receptionist

Ersätt YOURDOMAIN med din Freshdesk-underdomän. Välj Enable.

Testa det

Testa din receptionist genom att rapportera ett problem. Ärendet visas i Freshdesk.

De fasta värdena skapar ärendet som Open (status 2) med Low prioritet (prioritet 1) och markerar det som inkommet via Phone (källa 3). Om du vill låta receptionisten ange prioriteten beskriver du värdena i stället, till exempel: “1 för låg, 2 för medel, 3 för hög, 4 för brådskande.”

Freshdesk behöver ett telefonnummer eller en e-postadress för att hitta eller skapa den som begär ärendet. Be din receptionist att alltid samla in uppringarens telefonnummer.

Sök efter ärenden med MCP-servern

Freshdesks MCP-server är tillgänglig med abonnemangen Growth, Pro och Enterprise. Använd den för att låta din receptionist söka efter en uppringares befintliga ärenden. MCP-åtgärder räknas mot en årlig kvot som beror på ditt abonnemang.

I Reception.ai går du till Integrations, väljer Add integration och sedan MCP Server.

Fält	Värde
Namn	Freshdesk
Servertyp	Streamable HTTP
Server-URL	`https://YOURDOMAIN.freshdesk.com/mcp`
HTTP Headers	`Authorization`: din API-nyckel, utan prefix

Låt Secret Token vara tomt så att Reception.ai skickar ditt Authorization-huvud exakt som du angav det. Använd din freshdesk.com-underdomän även om du har en egen domän. Välj Enable.

Öppna fliken Tools och tilldela verktygen för ärendesökning, till exempel fetchSearchTickets och fetchTicket, till Client (receptionisten). Låt verktyg som uppdaterar ärenden, agenter, grupper eller artiklar vara otilldelade.

Felsökning

Problem	Kontrollera
401 från Freshdesk	Koda nyckeln med `:X` efter den och börja huvudvärdet med `Basic` följt av ett mellanslag.
400 om den som begär ärendet	Ärendet behöver ett telefonnummer eller en e-postadress, samt namnet. Se till att receptionisten samlar in dem.
400 om status eller prioritet	`status`, `priority` och `source` måste vara nummerparametrar, inte strängar.
MCP-servern listar inga verktyg	Använd din `freshdesk.com`-underdomän och ange den råa API-nyckeln i `Authorization`-huvudet utan `Basic` eller `Bearer`.