---
title: "Freshservice"
description: "Tickets, Requester, Assets und Lösungsartikel lesen sowie Tickets, Antworten und Notizen bearbeiten"
canonical_url: "https://meingpt.com/docs/integrations/connectors/freshservice"
language: de
---

# Freshservice

Der Freshservice-Connector verbindet Assistenten direkt mit einem Freshservice-Konto. Er unterstützt lesende und schreibende ITSM-Aktionen über die Freshservice API v2.

## Voraussetzungen

- Die Domain des Freshservice-Kontos, zum Beispiel `beispiel.freshservice.com`
- Ein persönlicher Freshservice API-Schlüssel
- Ein Freshservice-Nutzer mit genau den Rechten, die der Connector verwenden soll

Der Connector übernimmt die Berechtigungen des Schlüsselinhabers. Verwende deshalb einen Nutzer mit minimal erforderlichen Rechten und keinen unbeschränkten Administratorschlüssel.

## Einrichtung

1. Freshservice im Assistenten-Editor unter den Connectoren aktivieren.
2. Unter **Freshservice Domain** nur den Hostnamen ohne `https://` eintragen.
3. Unter **API Key** den persönlichen Schlüssel aus den Freshservice-Profileinstellungen hinterlegen.
4. Verbindung testen und die benötigten Methoden für den Assistenten freigeben.

## Verfügbare Funktionen

### Tickets

- Tickets mit der Freshservice-Filter-Syntax suchen
- Ticketdetails einschließlich Verlauf, Requester, SLA, Tags, Abteilung und verknüpften Assets lesen
- Tickets anlegen und Felder wie Status, Priorität, Gruppe, Agent oder Tags aktualisieren
- Öffentliche Antworten ergänzen, die für Requester sichtbar sind und Benachrichtigungen auslösen
- Interne Notizen ergänzen, die standardmäßig privat sind
- Ausgewählte Ticketanhänge in den Chat-Kontext laden

### Requester, Assets und Wissen

- Requester suchen und Details lesen
- Assets in der CMDB suchen und abrufen
- Lösungsartikel durchsuchen
- Agenten, Gruppen und Abteilungen auflisten
- Ticketformularfelder einschließlich accountabhängiger Auswahlwerte lesen

## Feldwerte vor Änderungen auflösen

Status, Priorität, Quelle, Dringlichkeit, Auswirkung und benutzerdefinierte Auswahlfelder verwenden IDs, die sich zwischen Freshservice-Konten unterscheiden. Der Assistent muss deshalb zuerst die Ticketformularfelder lesen, wenn der korrekte Wert nicht bereits eindeutig bekannt ist.

## Anhänge und öffentliche Antworten

Ticketanhänge werden nicht automatisch in den KI-Kontext geladen. Der Connector listet sie am Ticket auf und lädt nur ausdrücklich ausgewählte Dateien über eine separate Methode. Inline-Bilder in HTML-Beschreibungen werden in der ersten Version nicht eingelesen.

Eine öffentliche Antwort ist für den Requester sichtbar und kann Benachrichtigungen auslösen. Nutze für interne Bearbeitung eine private Notiz und gib öffentliche Antworten nur dort frei, wo eine Person den Inhalt vor dem Senden prüfen kann.

## Grenzen

- Alle Aktionen sind auf die Rechte des API-Schlüsselinhabers begrenzt.
- Accountabhängige Feldwerte müssen vor schreibenden Aktionen aufgelöst werden.
- Asset-Links und Detailabrufe verwenden die sichtbare `display_id`, nicht die interne ID.
- Inline-Bilder aus HTML-Beschreibungen werden nicht als Anhänge eingelesen.

## Sicherheit

- Der API-Schlüssel wird als Geheimnis gespeichert und nicht im Chat angezeigt.
- Die Domain ist Konfigurationsbestandteil und kein Geheimnis.
- Lese- und Schreibmethoden können am Assistenten und durch die Organisationsrichtlinie begrenzt werden.
- Der Schlüssel kann in Freshservice widerrufen und anschließend in meinGPT ersetzt werden.