> 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

## Översikt

Anslut dina ElevenLabs AI-agenter till Freshdesk för kundtjänstarbetsflöden. Integrationen omfattar två områden:

* **Verktyg**: låt en agent söka upp ärenden och kontakter, söka i kundtjänsten, publicera svar och interna anteckningar samt skapa nya ärenden medan en konversation pågår.
* **Utlösare**: låt en agent automatiskt svara på nya ärenden eller kundsvar på befintliga ärenden. Svar publiceras som adminsvar via Freshdesk Conversations API, eller som en privat anteckning när skuggläge är aktiverat.

## Funktioner

| Funktion              | Stöd                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------ |
| Nollagringsläge (ZRM) | Stöds inte                                                                           |
| Bilagor i utlösare    | Stöds inte — bilagor i inkommande ärenden och svar vidarebefordras inte till agenten |
| Bilagor i verktyg     | Stöds inte — verktyg hanterar endast text                                            |

## Konfiguration

#### Hämta din Freshdesk API-nyckel

I Freshdesk klickar du på din profilbild (uppe till höger) → **Profile settings**. Din API-nyckel visas under avsnittet för lösenordsändring. Kopiera den.

#### Hitta din Freshdesk-underdomän

Det är delen av din portal-URL före `.freshdesk.com`. Om din portal till exempel är `acme.freshdesk.com` är din underdomän `acme`.

#### Anslut i ElevenLabs

På sidan för Freshdesk-integrationen i ElevenLabs klickar du på **Connect** och anger:

* **API Key**: token från steg 1.
* **Subdomain**: sluggen från steg 2.

ElevenLabs autentiserar med HTTP Basic-autentisering med din API-nyckel som användarnamn och `X` som lösenord — Freshdesks standardmetod för autentisering.

#### Aktivera utlösaren (valfritt)

Om du vill att agenten automatiskt ska svara på kundaktivitet i ärenden aktiverar du utlösaren **Freshdesk Ticket Event** och väljer:

* **Agent**: agenten som ska hantera inkommande konversationer.
* **Responder**: Freshdesk-agentidentiteten som boten publicerar svar som.
* **Shadow Mode** (valfritt): när detta är aktiverat skriver agenten en privat anteckning för personalens granskning i stället för att skicka ett offentligt svar.

När du aktiverar utlösaren skapar ElevenLabs en Freshdesk-automatiseringsregel i ditt konto som skickar POST till vår webhook när ett ärende skapas och när en kund svarar. Inaktivering tar bort regeln. Inga manuella administratörsåtgärder i Freshdesk krävs.

> **Warning**
>
> **Ordning för automatiseringsregler för nya ärenden.** Freshdesk kör automatiseringsregler för **Ticket Creation**
> uppifrån och ned och kör endast den **första** regeln vars villkor matchar ett nytt ärende — sedan
> stoppas processen. Om du redan har en eller flera Ticket Creation-regler som matchar samma ärenden och ligger
> **ovanför** ElevenLabs-regeln kommer vår regel aldrig att köras och agenten svarar inte på nya
> ärenden. Om detta händer öppnar du **Admin → Workflows → Automations → Ticket Creation** och flyttar
> regeln `ElevenLabs agent …` ovanför eventuella motstridiga regler. (Utlösare för ärendesvar använder kategorin \*\*Ticket
> Updates \*\*, där alla matchande regler körs, så detta påverkar endast svar på helt nya
> ärenden.)

### Skuggläge

Aktivera skuggläge på en Freshdesk-utlösare för att låta agenten utforma svar utan att skicka dem till kunder. När skuggläget är aktivt skriver agenten sina svar som **privata anteckningar** i ärendet i stället för offentliga svar. Endast Freshdesk-agenter kan se privata anteckningar — den som skickade begäran får ingen avisering.

Freshdesk erbjuder inget API för utkast till ärendesvar. Privata anteckningar är den motsvarande funktion som stöds: personalen kopierar det föreslagna svaret till ärendets svarsredigerare, redigerar vid behov och skickar det.

> **Warning**
>
> Skuggläge påverkar endast hur agenten publicerar sina svar. Om agenten använder verktyg som ändrar
> ärendet (till exempel ändrar status, lägger till taggar eller tilldelar ärendet) tillämpas dessa ändringar
> fortfarande. För att förhindra oavsiktliga ändringar använder du en separat gren av agenten där
> anrop till ändrande verktyg har tagits bort.

Skuggläge är användbart för att utvärdera agentens kvalitet innan du går live. Granska de privata anteckningarna tillsammans med de faktiska kundtjänstsvaren för att jämföra träffsäkerhet och ton, och stäng sedan av skuggläget när du är säker på resultatet.

### CLI

> **Note**
>
> CLI-dokumentation för den här integrationen kommer snart.

### SDK

> **Note**
>
> SDK-dokumentation för den här integrationen kommer snart.

## Användbara länkar

* [Freshdesk REST API-referens](https://developers.freshdesk.com/api/)
* [Syntax för Freshdesk-sökfrågor](https://developers.freshdesk.com/api/#filter_tickets)
* [Freshdesk-automatiseringsregler med webhooks](https://support.freshdesk.com/en/support/solutions/articles/132589-using-webhooks-in-automation-rules-that-run-on-ticket-updates)