> 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.

# Zendesk

## Översikt

Anslut dina AI-agenter från ElevenLabs till [Zendesk](https://www.zendesk.com/) för att hantera supportärenden, användare och organisationer. Den här integrationen gör det möjligt för dina agenter att skapa och uppdatera ärenden, söka efter befintliga poster, hantera användare och svara på inkommande kommentarer i ärenden.

## Funktioner

| Funktion              | Stöd                                                                                                                                                                                                     |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nollagringsläge (ZRM) | Stöds inte                                                                                                                                                                                               |
| Bilagor i utlösare    | Bilder (PNG, JPEG, GIF, WebP) och PDF-filer i inkommande kommentarer i ärenden, när **Allow file attachments** är aktiverat i agentinställningarna och agentens LLM stöder bild- eller dokumentinmatning |
| Bilagor i verktyg     | Stöds inte — verktyg som `zendesk_show_ticket` och `zendesk_list_ticket_comments` returnerar textfält och laddar inte ned bilagor                                                                        |

## Konfigurera

Den här integrationen stöder tre autentiseringsmetoder: ElevenLabs OAuth-app, din egen OAuth-klient och en API-token.

> **Note**
>
> Zendesk [avvecklar API-token](https://support.zendesk.com/hc/en-us/articles/10851263566234)
> som autentiseringsmetod och övergår till åtkomst endast via OAuth. Befintliga Zendesk-
> integrationer som använder API-token fortsätter att fungera till den 30 april 2027. ElevenLabs arbetar med att stödja denna
> migrering och kontaktar proaktivt berörda kunder för att hjälpa dem övergå till OAuth innan
> dess. Du kan när som helst byta till metoden **Custom OAuth client** nedan.

#### OAuth

#### Hitta din underdomän

Din Zendesk-underdomän är den första delen av din Zendesk-URL (t.ex. `mycompany` i `mycompany.zendesk.com`).

#### Anslut i ElevenLabs

Välj autentiseringsuppgiften **OAuth2**, ange din **subdomain** och klicka på **Connect** i inställningarna för ElevenLabs-integrationen.

#### Auktorisera anslutningen

Zendesk visar en auktoriseringssida med den åtkomst som ElevenLabs-appen begär: läsåtkomst i hela ditt konto samt skrivåtkomst till ärenden, användare, webhooks och utlösare. Logga in som en användare med de behörigheter din agent behöver och klicka på **Allow**. Zendesk omdirigerar dig tillbaka till ElevenLabs och anslutningen skapas.

Auktorisera som administratör om du planerar att använda Zendesk-utlösare — att skapa webhooks och redigera utlösare är begränsat till Zendesk-administratörer.

#### API-token

#### Aktivera åtkomst med API-token

Gå till **Apps and integrations > APIs > Zendesk API** i [Zendesk Admin Center](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Admin-Center) och aktivera **Token Access**.

#### Generera en API-token

Gå till **Apps and integrations > APIs > API tokens** och klicka på **Add API token**. Kopiera token omedelbart — den visas inte igen när du har stängt dialogrutan.

#### Hitta din underdomän

Din Zendesk-underdomän är den första delen av din Zendesk-URL (t.ex. `mycompany` i `mycompany.zendesk.com`).

#### Anslut i ElevenLabs

Ange din **email**, **API token** och **subdomain** i inställningarna för ElevenLabs-integrationen.

#### Anpassad OAuth-klient

#### Kopiera omdirigerings-URL:en

Kopiera **redirect URL** i inställningarna för ElevenLabs Zendesk-integration.

#### Skapa en OAuth-klient i Zendesk

Gå till **Apps and integrations > APIs > OAuth clients** i [Zendesk Admin Center](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Admin-Center) och klicka på **Add Client**. Ange ett **name** och en unik **identifier**.

#### Lägg till omdirigerings-URL:en

Klistra in **redirect URL** som du kopierade från ElevenLabs i OAuth-klientens konfiguration.

#### Spara hemligheten

Spara OAuth-klienten. Zendesk visar en **secret** — kopiera och lagra den säkert. Den visas inte igen när du har stängt dialogrutan.

#### Anslut i ElevenLabs

Ange **identifier** som klient-ID och ange **secret** i inställningarna för ElevenLabs-integrationen. Zendesk omdirigerar dig för att auktorisera anslutningen.

## OAuth-omfattningar

Anslutning med autentiseringsuppgiften **OAuth2** ger ElevenLabs följande [Zendesk OAuth-omfattningar](https://developer.zendesk.com/api-reference/ticketing/oauth/grant_type_tokens/). Läsåtkomst ges för hela kontot, medan skrivåtkomst begärs per resurs så att token inte kan ändra resurser som integrationen inte använder.

| Omfattning       | Syfte                                                                                                                                                                                                                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read`           | Läsåtkomst till GET-slutpunkter. Används för att hämta ärenden, ärendekommentarer och deras bilagor, användare, organisationer, problemärenden och sökresultat samt — när en utlösare är ansluten — för att slå upp Zendesk-utlösaren och läsa signeringshemligheten för webhooken som ElevenLabs skapar. |
| `tickets:write`  | Skapa, uppdatera, radera och slå samman ärenden, publicera offentliga och interna kommentarer samt lägga till eller ta bort taggar. Används av ärendeverktygen och för att publicera agentens svar när en Zendesk-utlösare aktiveras.                                                                     |
| `users:write`    | Skapa, uppdatera och radera användare, inklusive masskapande eller massuppdatering. Används av verktygen för användarhantering.                                                                                                                                                                           |
| `webhooks:write` | Skapa webhooken som levererar ärendehändelser till din agent när du aktiverar en Zendesk-utlösare, och radera webhooken när du inaktiverar utlösaren.                                                                                                                                                     |
| `triggers:write` | Lägg till ElevenLabs webhook-åtgärd i Zendesk-utlösaren som du anger och ta bort åtgärden när du inaktiverar utlösaren.                                                                                                                                                                                   |

En token överskrider aldrig behörigheterna för användaren som auktoriserade den — den faktiska åtkomsten är skärningen mellan dessa omfattningar och användarens Zendesk-roll.

Dessa omfattningar gäller inte de andra två autentiseringsmetoderna: en anpassad OAuth-klient begär `read` och `write` (full läs- och skrivåtkomst), och en API-token har alla behörigheter för Zendesk-användaren som den tillhör.

## Uppgiftsredovisning

Tabellen nedan listar varje fält som integrationen får åtkomst till i ditt Zendesk-konto, om ElevenLabs lagrar det samt när och varför det används. **Läst** betyder att värdet används under bearbetningen men inte sparas permanent. **Läst och lagrat** betyder att det sparas i ElevenLabs konversationspost. **Skrivet** betyder att integrationen skickar det till Zendesk.

| Data                                                        | Åtkomst         | Orsak                                                                                                                                                                                                                                      |
| ----------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Ärende-ID                                                   | Läst och lagrat | Ingår i trigger-webhookens nyttolast — den enda ärendedata som Zendesk skickar till ElevenLabs. Lagras som konversationens externa ID, som den dynamiska variabeln `integration__zendesk_ticket_id` och som en länk tillbaka till ärendet. |
| Ärendeämne                                                  | Läst och lagrat | Läser från ärendet när en trigger aktiveras. Lagras som den dynamiska variabeln `integration__zendesk_ticket_subject` så att systemprompten och verktygen kan referera till vad ärendet handlar om.                                        |
| Tidsstämpel för när ärendet skapades                        | Läst och lagrat | Läser tillsammans med ärendet. Lagras som den dynamiska variabeln `integration__zendesk_ticket_created_at` för användning i prompten, till exempel för att bedöma ärendets ålder.                                                          |
| Begärar-ID                                                  | Läst och lagrat | Läser tillsammans med ärendet. Lagras som den dynamiska variabeln `integration__zendesk_ticket_requester_id` och används för att tillskriva kommentarer — en begärare som även är personal behandlas fortfarande som kund.                 |
| Ärendetaggar                                                | Läst            | Läser vid varje triggerkörning för att upptäcka en `agent-rating-<score>`-tagg och en `force-agent`-tagg. Endast det resulterande betyget lagras i konversationen; själva tagglistan sparas inte permanent.                                |
| Kommentarstext, offentlig och intern                        | Läst och lagrat | Läser från ärendets kommentarer vid varje triggerkörning. Lagras som konversationstranskriptet och skickas till agentens LLM — det här är konversationen som agenten svarar på.                                                            |
| Kommentar-ID:n                                              | Läst och lagrat | Läser tillsammans med kommentarerna. Det senaste ID:t lagras som markör för senast bearbetat så att nästa triggerkörning hoppar över kommentarer som agenten redan har svarat på.                                                          |
| Kommentarens författar-ID                                   | Läst och lagrat | Läser tillsammans med kommentarerna och används för att slå upp författaren. Lagras som transkriptmeddelandets användaridentifierare när författaren saknar e-postadress.                                                                  |
| Kommentarens författarroll                                  | Läst            | Läser för varje kommentarsförfattare för att avgöra om en kommentar blir ett kundmeddelande eller ett personalmeddelande i transkriptet. Rollen i sig sparas inte permanent, endast den resulterande tillskrivningen på varje meddelande.  |
| Kommentarens författares e-postadress                       | Läst och lagrat | Läser för varje kommentarsförfattare. Lagras som användaridentifierare på transkriptmeddelanden som tillskrivs kunden, så att konversationer kan kopplas till en person mellan ärenden.                                                    |
| Begärarens e-postadress                                     | Läst och lagrat | Läser med begärarens användarpost. Lagras som den dynamiska variabeln `integration__zendesk_ticket_requester_email` så att prompten och verktygen kan tilltala eller slå upp kunden.                                                       |
| Bifogad fils metadata: filnamn, MIME-typ, storlek           | Läst och lagrat | Läser med kommentarerna för att kontrollera att en bilaga har en typ som stöds och ryms inom storleksgränserna. Lagras på transkriptmeddelandet som bilagan tillhör.                                                                       |
| Bifogade filers innehåll                                    | Läst och lagrat | Laddas endast ned när **Tillåt filbilagor** är aktiverat för agenten och dess LLM stöder filtypen. Lagras som konversationsfiler så att agenten kan läsa vad kunden skickade.                                                              |
| Zendesk-underdomän                                          | Läst och lagrat | Tillhandahålls av dig vid anslutning. Lagras i integrationens anslutningsinställningar eftersom den utgör API:ets bas-URL.                                                                                                                 |
| Zendesk-kontots e-postadress, endast API-tokenautentisering | Läst och lagrat | Tillhandahålls av dig vid anslutning. Lagras i anslutningsinställningarna eftersom API-tokenautentisering skickar kontots e-postadress tillsammans med tokenen.                                                                            |
| API-token, OAuth-åtkomst- och uppdateringstoken             | Läst och lagrat | Lagras krypterat i vila och används endast för att autentisera API-anrop. Exponeras aldrig för agenten, prompten eller API:et.                                                                                                             |
| Webhookens signeringshemlighet                              | Läst och lagrat | Läser en gång när du aktiverar en trigger. Lagras krypterat och används för att verifiera att inkommande webhooks verkligen kommer från ditt Zendesk-konto.                                                                                |
| Triggertitel, villkor och åtgärder                          | Läst            | Läser när du aktiverar en trigger för att hitta triggern efter namn och bevara dess befintliga åtgärder när ElevenLabs webhookåtgärd läggs till. Sparas inte permanent.                                                                    |
| Agentens svar                                               | Skrivet         | Publiceras som en offentlig kommentar på ärendet eller som en intern kommentar när skuggläge är aktiverat. Det är integrationens syfte.                                                                                                    |
| Konversationslänk                                           | Skrivet         | Publiceras en gång per ärende som en intern kommentar så att personalen kan öppna konversationen i ElevenLabs.                                                                                                                             |
| Felmeddelande om bilaga                                     | Skrivet         | Publiceras som en intern kommentar när en bilaga hoppades över eftersom den har en typ som inte stöds, är för stor eller inte kunde laddas ned, så att personalen vet att agenten inte såg den.                                            |
| Registrering av ElevenLabs-webhook                          | Skrivet         | Skapas när du aktiverar en Zendesk-trigger och tas bort när du inaktiverar den. Detta är den slutpunkt som Zendesk anropar vid ärendehändelser.                                                                                            |
| Webhookåtgärd för din trigger                               | Skrivet         | Läggs till i triggern du anger när du aktiverar den och tas bort när du inaktiverar den. Befintliga åtgärder i triggern bevaras.                                                                                                           |
| Ärenden, kommentarer, taggar, användare och organisationer  | Skrivet         | Skriver endast via Zendesk-verktygen som du aktiverar för agenten, med de parametrar som agenten anger under en konversation. Inga skrivningar sker utanför ett verktygsanrop eller ett triggersvar.                                       |

Integrationen anropar Zendesk API endast när en ansluten trigger aktiveras eller när en agent använder ett Zendesk-verktyg. Den avsöker inte ditt Zendesk-konto och exporterar inte data i stora mängder.

Poster som returneras av Zendesk-verktyg lagras i konversationstranskriptet som en del av verktygsanropsresultatet, så ett verktyg som läser en post lagrar den också. Lagringstiden för lagrade data följer sekretessinställningarna för agenten som hanterade ärendet, inklusive radering av transkript och personligt identifierbar information.

## Zendesk-verktyg

Lägg till Zendesk-verktyg till din agent för att hantera ärenden, användare och organisationer under konversationer. När integrationen är ansluten kan du aktivera enskilda verktyg på agentens konfigurationssida.

### Tillgängliga verktyg

Integrationen erbjuder över 30 verktyg i följande kategorier:

* **Ärenden** — skapa, uppdatera, ta bort, lista och sök efter ärenden. Massåtgärder (skapa flera, uppdatera flera, ta bort flera) är också tillgängliga.
* **Kommentarer och taggar** — lägg till offentliga eller interna kommentarer i ärenden samt lägg till eller ta bort taggar.
* **Användare** — slå upp, skapa, uppdatera och ta bort användare. Masskapande eller -uppdatering stöds för synkronisering av användardata.
* **Organisationer** — hämta organisationsuppgifter och lista en organisations ärenden.
* **Sök** — kör Zendesk-sökfrågor i ärenden, användare och organisationer (t.ex. `type:ticket status:open`).

### Exempelverktyg

#### zendesk\_create\_ticket

Skapar ett nytt supportärende. Agenten samlar in uppgifter från uppringaren och öppnar ett ärende åt dem.

| Parameter                | Typ     | Beskrivning                                               |
| ------------------------ | ------- | --------------------------------------------------------- |
| `ticket.subject`         | string  | Kort ämnesrad för ärendet                                 |
| `ticket.comment.body`    | string  | Detaljerad beskrivning av problemet                       |
| `ticket.requester.email` | string  | Begärarens e-postadress                                   |
| `ticket.requester.name`  | string  | Begärarens fullständiga namn                              |
| `ticket.priority`        | string  | `urgent`, `high`, `normal` eller `low`                    |
| `ticket.status`          | string  | `new`, `open`, `pending`, `hold`, `solved` eller `closed` |
| `ticket.assignee_id`     | integer | Agent-ID som ärendet ska tilldelas till                   |
| `ticket.group_id`        | integer | Grupp-ID som ärendet ska dirigeras till                   |
| `ticket.custom_fields`   | array   | Matris med `{id, value}`-objekt för anpassade fält        |

#### zendesk\_search

Söker i Zendesk efter ärenden, användare eller organisationer med Zendesks syntax för sökfrågor.

| Parameter | Typ    | Beskrivning                                                                         |
| --------- | ------ | ----------------------------------------------------------------------------------- |
| `query`   | string | Sökfråga (t.ex. `type:ticket status:open` eller `type:user email:user@example.com`) |

#### zendesk\_add\_comment

Lägger till en offentlig eller intern kommentar i ett befintligt ärende — användbart för att publicera samtalssammanfattningar eller uppföljningsanteckningar.

| Parameter                  | Typ     | Beskrivning                            |
| -------------------------- | ------- | -------------------------------------- |
| `ticket_id`                | integer | Ärendet att kommentera                 |
| `ticket.comment.body`      | string  | Kommentarstext i oformaterad text      |
| `ticket.comment.html_body` | string  | HTML-version av kommentaren (valfritt) |
| `ticket.comment.public`    | boolean | Om kommentaren är synlig för begäraren |

#### zendesk\_get\_user

Hämtar en användarprofil så att agenten kan hälsa uppringare med namn eller verifiera deras identitet.

| Parameter | Typ     | Beskrivning                            |
| --------- | ------- | -------------------------------------- |
| `user_id` | integer | Zendesk-användar-ID:t som ska slås upp |

### Konfigurera verktyg

#### Lägg till ett integrationsverktyg

På agentens konfigurationssida klickar du på **Lägg till verktyg** och väljer **Lägg till integrationsverktyg**.

![Lägg till integrationsverktyg](/docs/_fern-img/ef3a82e0747f1b1da18fb6b4755812abe161d436582312e47836e621a44d83c7.webp)

#### Välj Zendesk-verktyg

Välj din Zendesk-anslutning och aktivera de verktyg du vill att agenten ska använda. Du kan aktivera så många eller få som behövs — en skrivskyddad agent för första sortering kanske bara behöver sök- och listverktyg, medan en agent med full service också kan skapa och uppdatera ärenden.

![Välj Zendesk-verktyg](/docs/_fern-img/9161ae75a4c514d477174622bd4857d6faf62a11825bc7d4d191176e52a72f91.webp)

#### (Valfritt) Ange parametrar

Varje verktygs parametrar fylls i av agenten under konversationen utifrån vad uppringaren säger. Du behöver inte hårdkoda parametervärden. Du kan dock valfritt förifylla eller begränsa specifika parametrar — till exempel genom att ange en standard för `priority` eller `group_id` — för att styra agentens beteende.

#### Äldre webhookkonfiguration

> **Note**
>
> Om du använder den inbyggda Zendesk-integrationen konfigureras verktygen automatiskt. Stegen nedan
> gäller endast manuell webhookkonfiguration.

Den äldre integrationen använder tre webhookverktyg för att skapa supportagenten. Granska konfigurationen för varje verktyg på flikarna nedan.

#### zendesk\_get\_ticket\_comments

**Namn:** zendesk\_get\_ticket\_comments
**Beskrivning:** Hämtar kommentarerna för ett ärende.
**Metod:** GET
**URL:** `https://acmecorp.zendesk.com/api/v2/tickets/{ticket_id}/comments.json`

**Headers:**

* **Content-Type:** `application/json`
* **Authorization:** *(Hemlighet: `zendesk_key`)*

**Sökvägsparametrar:**

* **ticket\_id:** Extrahera värdet från fältet `id` i resultaten från get\_resolved\_tickets.

**Verktygs-JSON:**

```json
{
  "type": "webhook",
  "name": "zendesk_get_ticket_comments",
  "description": "Retrieves the comments of a ticket.",
  "api_schema": {
    "url": "https://acmecorp.zendesk.com/api/v2/tickets/{ticket_id}/comments.json",
    "method": "GET",
    "path_params_schema": [
      {
        "id": "ticket_id",
        "type": "string",
        "description": "Extract the value from the id field in the get_resolved_tickets results.",
        "dynamic_variable": "",
        "constant_value": "",
        "required": false,
        "value_type": "llm_prompt"
      }
    ],
    "query_params_schema": [],
    "request_body_schema": null,
    "request_headers": [
      {
        "type": "secret",
        "name": "Authorization",
        "secret_id": "zendesk_api_token"
      },
      {
        "type": "value",
        "name": "Content-Type",
        "value": "application/json"
      }
    ]
  },
  "response_timeout_secs": 20,
  "dynamic_variables": {
    "dynamic_variable_placeholders": {}
  }
}
```

#### zendesk\_get\_resolved\_tickets

**Namn:** zendesk\_get\_resolved\_tickets
**Beskrivning:** Hämtar alla lösta supportärenden från Zendesk.
**Metod:** GET
**URL:** `https://acmecorp.zendesk.com/api/v2/search.json?query=type:ticket+status:solved`

**Headers:**

* **Content-Type:** `application/json`
* **Authorization:** *(Hemlighet: `zendesk_key`)*

**Verktygs-JSON:**

```json
{
  "type": "webhook",
  "name": "zendesk_get_resolved_tickets",
  "description": "Retrieves all resolved support tickets from Zendesk.",
  "api_schema": {
    "url": "https://acmecorp.zendesk.com/api/v2/search.json?query=type:ticket+status:solved",
    "method": "GET",
    "path_params_schema": [],
    "query_params_schema": [],
    "request_body_schema": null,
    "request_headers": [
      {
        "type": "secret",
        "name": "Authorization",
        "secret_id": "zendesk_api_token"
      },
      {
        "type": "value",
        "name": "Content-Type",
        "value": "application/json"
      }
    ]
  },
  "response_timeout_secs": 20,
  "dynamic_variables": {
    "dynamic_variable_placeholders": {}
  }
}
```

#### zendesk\_open\_ticket

**Namn:** zendesk\_open\_ticket
**Beskrivning:** Öppnar ett nytt supportärende.
**Metod:** POST
**URL:** `https://acmecorp.zendesk.com/api/v2/tickets.json`

**Headers:**

* **Content-Type:** `application/json`
* **Authorization:** *(Hemlighet: `zendesk_key`)*

**Body-parametrar:**

* **ticket:** Ett objekt som innehåller:
  * **comment:**
    * **body:** Detaljerad beskrivning av supportproblemet.
  * **subject:** En kort ämnesrad.
  * **requester:**
    * **name:** Begärarens fullständiga namn.
    * **email:** En giltig e-postadress.

**Verktygs-JSON:**

```json
{
  "type": "webhook",
  "name": "zendesk_open_ticket",
  "description": "API endpoint to open a customer support ticket\nMake sure the authorization header is formated as \"Authorization: Basic <auth>\".",
  "api_schema": {
    "url": "https://acmecorp.zendesk.com/api/v2/tickets.json",
    "method": "POST",
    "path_params_schema": [],
    "query_params_schema": [],
    "request_body_schema": {
      "id": "body",
      "type": "object",
      "description": "Details for the support ticket",
      "required": false,
      "properties": [
        {
          "id": "ticket",
          "type": "object",
          "description": "This is the main ticket body which contains all of the information needed to open a ticket.",
          "required": true,
          "properties": [
            {
              "id": "comment",
              "type": "object",
              "description": "This is the comment with information about the issue.",
              "required": true,
              "properties": [
                {
                  "id": "body",
                  "type": "string",
                  "description": "Body of the issue. Include all relevant details for the issue. ",
                  "dynamic_variable": "",
                  "constant_value": "",
                  "required": true,
                  "value_type": "llm_prompt"
                }
              ]
            },
            {
              "id": "subject",
              "type": "string",
              "description": "Create a short subject line for the support issue. Add \"DEMO: \" before the subject.",
              "dynamic_variable": "",
              "constant_value": "",
              "required": true,
              "value_type": "llm_prompt"
            },
            {
              "id": "requester",
              "type": "object",
              "description": "The details of the support requester",
              "required": true,
              "properties": [
                {
                  "id": "email",
                  "type": "string",
                  "description": "The email address of the requester. This should look like \njohnsmith@hotmail.com\nYou MUST use the @ symbol and remove any spaces.",
                  "dynamic_variable": "",
                  "constant_value": "",
                  "required": true,
                  "value_type": "llm_prompt"
                },
                {
                  "id": "name",
                  "type": "string",
                  "description": "The full name of the requester. ",
                  "dynamic_variable": "",
                  "constant_value": "",
                  "required": true,
                  "value_type": "llm_prompt"
                }
              ]
            }
          ]
        }
      ]
    },
    "request_headers": [
      {
        "type": "secret",
        "name": "Authorization",
        "secret_id": "zendesk_api_token"
      },
      {
        "type": "value",
        "name": "Content-Type",
        "value": "application/json"
      }
    ]
  },
  "response_timeout_secs": 20,
  "dynamic_variables": {
    "dynamic_variable_placeholders": {}
  }
}
```

> **Warning**
>
> Se till att lägga till arbetsytans Zendesk-hemlighet i agentens hemligheter.

## Zendesk-triggers

Konfigurera Zendesk-triggers så att din agent övervakar och reagerar på inkommande ärendekommentarer och ger första linjens support.

### Konfiguration

#### Skapa en trigger i Zendesk

I Zendesk Admin Center går du till **Objects and rules > Business rules > Triggers** och klickar på **Add trigger**. Konfigurera de villkor som avgör vilka ärendehändelser agenten ska svara på (t.ex. nya ärenden i en viss grupp eller ärendekommentarer med en viss tagg). Notera triggerns namn — du behöver det i nästa steg.

Om du inte kan spara triggern eftersom en åtgärd saknas lägger du till en enkel åtgärd, till exempel att lägga till taggen "agent is processing" i ärendet.

#### Anslut triggern i ElevenLabs

På agentens konfigurationssida lägger du till en ny trigger och väljer **Zendesk Trigger**. Konfigurera fälten:

* **Agent**: agenten som hanterar inkommande konversationer.
* **Namn på triggerregel**: namnet på Zendesk-triggern som du skapade i föregående steg.
* **Daglig ärendegräns** (valfritt): högsta antal ärenden som agenten hanterar per dag. Lämna tomt för obegränsat antal.

När du aktiverar triggern skapar ElevenLabs en webhook i ditt Zendesk-konto och lägger till den som en åtgärd i triggern du angav. När du inaktiverar triggern tas webhooken och åtgärden bort.

#### (Valfritt) Kontrollera triggern i Zendesk

I Zendesk Admin Center går du till **Objects and rules > Business rules > Triggers** och visar triggern som du skapade tidigare. Du bör se en ny åtgärd som har lagts till i den.

Om du tidigare skapade en annan åtgärd kan du nu ta bort den igen.

### Skuggläge

Aktivera skuggläge för en Zendesk-trigger så att agenten kan observera och utforma svar utan att svara kunder direkt. När skuggläge är aktivt skriver agenten sina svar som **interna kommentarer** i ärendet i stället för offentliga svar. Endast Zendesk-agenter och administratörer kan se interna kommentarer — slutanvändaren får ingen avisering.

> **Warning**
>
> Skuggläge påverkar endast hur agenten publicerar sina svar. Om agenten använder verktyg som ändrar
> ärendet (t.ex. ä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 interna kommentarerna tillsammans med de faktiska supportsvaren för att jämföra precision och ton, och flytta sedan agenten till aktivt läge när du är säker på dess resultat.

### Undvik loopar

När agenten svarar på en ärendekommentar via Zendesk API blir svaret självt en ny kommentar — vilket kan aktivera agenten igen och skapa en oändlig loop. Lägg till något av följande villkor i din Zendesk-trigger för att förhindra detta.

**Uteslut tjänstkontot från triggern.** Skapa en separat Zendesk-användare för integrationen (t.ex. `ai-agent@yourcompany.com`) och använd kontots inloggningsuppgifter vid anslutning i ElevenLabs. Lägg sedan till det här villkoret i din Zendesk-trigger:

* **Current User**, **Is Not**, **\<ditt tjänstkonto>**

**Uteslut API-uppdateringar från triggern.** Detta filtrerar bort alla uppdateringar som görs via Zendesk API, oavsett vilken användare som gjorde dem:

* **Ticket > Update Via**, **Is Not**, **Web Service (API)**

## Användbara länkar

* [Zendesk API-dokumentation](https://developer.zendesk.com/api-reference/)
* [Hantera API-token](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API)
* [Guide till Zendesk-triggers](https://support.zendesk.com/hc/en-us/articles/203662246-About-triggers-and-how-they-work)