> 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

Med ett [webhook-verktyg](/docs/sv/reception-ai/integrations/webhooks) 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](#look-up-tickets-with-the-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:

```bash
printf 'YOUR_API_KEY:X' | base64
```

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

> **Warning**
>
> 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](/docs/sv/reception-ai/receptionist/testing) 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](/docs/sv/reception-ai/integrations/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`. |