> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# GLS

> Prüfe den Status von GLS-Paketen in der Ticket-Seitenleiste und mit KI-Agenten.

Die GLS-Integration verbindet deine GLS-App über „Track And Trace V1“ mit Chatarmin CX. Agenten sehen direkt im Ticket, wo ein GLS-Paket gerade ist, und KI-Agenten können „Wo ist mein Paket?“ mit aktuellen Tracking-Daten beantworten. Sie deckt GLS-Sendungen in Österreich und Deutschland ab.

<Note>
  GLS erscheint im **Kundenpanel** eines Tickets. Die Integration erzeugt keine Tickets und sendet keine Benachrichtigungen. Sie liest nur Tracking-Daten und ändert nie eine Sendung.
</Note>

## Wann du es brauchst

Nutze GLS, wenn du mit GLS versendest und dein Team oft Folgendes bearbeitet:

* „Wo ist mein Paket?“ und „Wann kommt es an?“
* „Laut Tracking zugestellt, aber ich habe nichts bekommen“
* Pakete, die nicht zugestellt wurden oder in einem ParcelShop warten

## Einrichten

Du brauchst den **API Key** und das **API Secret** einer GLS-App, die Zugriff auf die **Track And Trace V1**-API hat. Die App kannst du im GLS-Entwicklerportal anlegen.

<Steps>
  <Step title="Integrationen öffnen">
    [Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **GLS**.

    Wenn GLS nicht in der Liste steht, wende dich an dein Chatarmin-CX-Account-Team, damit es für deinen Workspace freigeschaltet wird.
  </Step>

  <Step title="GLS-App verbinden">
    Klick auf **Verbinden**, gib den **API Key** und das **API Secret** ein und speichere. Chatarmin CX prüft sie vor dem Speichern bei GLS. Lehnt GLS sie ab, siehst du den Grund von GLS und es wird nichts gespeichert.
  </Step>
</Steps>

<Note>
  GLS muss deine App für Track And Trace V1 freigeben, bevor Abfragen funktionieren. Sind Key und Secret richtig, aber GLS hat die Freigabe noch nicht abgeschlossen, wird die Verbindung gespeichert, Abfragen schlagen aber fehl, bis GLS fertig ist. Bitte den GLS-Support, die Freigabe abzuschließen.
</Note>

## GLS im Posteingang nutzen

Ist GLS verbunden, erscheint in jedem Ticket eine **GLS**-Karte im Kundenpanel, auch wenn der Kontakt keine E-Mail-Adresse hat. Klapp sie auf, um Folgendes zu sehen:

* Die **Sendungsnummer**. Hat der Kunde eine Shop-Bestellung mit Sendungsnummer, trägt cx die Nummer der neuesten Bestellung ein. Du kannst sie ersetzen.
* Den aktuellen **Status** und wann er sich zuletzt geändert hat.
* Den **Verlauf** des Pakets, neueste Einträge zuerst, mit Zeit und Ort.

Um ein anderes Paket abzufragen, gib dessen Sendungsnummer ein und klick auf **Status prüfen** oder drück Enter. Paketnummer, Track-ID und Benachrichtigungskarten-ID funktionieren alle.

<Note>
  cx trägt die Sendungsnummer der neuesten Bestellung ein, ohne zu prüfen, zu welchem Versanddienstleister sie gehört. Gehört die Nummer zu einem anderen Dienstleister, zeigt die Karte, dass GLS sie nicht kennt.
</Note>

### Was du siehst

| Situation | Was die Karte zeigt |
| - | - |
| Noch keine Sendungsnummer | „Noch keine Sendungsnummer. Geben Sie oben eine ein, um den Status zu prüfen.“ |
| GLS kennt die Nummer nicht | „GLS kennt kein Paket zu dieser Nummer. Prüfen Sie die Nummer und versuchen Sie es erneut.“ |
| GLS nicht erreichbar | „GLS-Sendungsverfolgung konnte nicht geladen werden.“ mit einem **Erneut versuchen**-Button |

Die Status werden in der Sprache deiner App angezeigt. Die Beschreibungen im Verlauf kommen von GLS auf Englisch.

| GLS-Status | Angezeigt als |
| - | - |
| Planned pickup | Abholung geplant |
| In pickup | Wird abgeholt |
| Not picked up | Nicht abgeholt |
| Pre-advice | Bei GLS angemeldet |
| In transit | Unterwegs |
| In delivery | In Zustellung |
| Delivered to a ParcelShop | Im Paketshop zugestellt |
| Delivered | Zugestellt |
| In warehouse | Im Lager |
| Not delivered | Nicht zugestellt |
| Canceled | Storniert |
| Final | Abgeschlossen |

Falls GLS einmal einen neuen Status einführt, zeigt die Karte den Originaltext von GLS statt eines leeren Felds.

## GLS in KI-Agenten nutzen

Füge einem [KI-Agenten](/de/ai-agents/skills-and-actions) die Aktion **Track shipment** hinzu und wähle die GLS-Verbindung, die er nutzen darf. Der Agent fragt immer eine Sendungsnummer auf einmal ab und antwortet mit aktuellem Status und Verlauf.

**Track shipment** liest nur Daten und braucht deshalb nie eine [menschliche Freigabe](/de/ai-agents/human-in-the-loop).

<Tip>
  Sag dem Agenten in den Anweisungen, dass er die Sendungsnummer aus der Bestellung des Kunden nutzen und es klar sagen soll, wenn GLS die Nummer nicht kennt, statt zu raten.
</Tip>

## Daten und Zugriff

Bei jeder Abfrage sendet Chatarmin CX nur die Sendungsnummer an GLS. API Key und API Secret werden verschlüsselt gespeichert und nur für Tracking-Abfragen genutzt. Bei GLS wird nichts geschrieben.

## GLS ändern oder trennen

Um eine Verbindung zu ändern, klick sie in den [Integrationen](https://armin.cx/app/_/settings/integrations) an. Lass **API Secret** leer, um das aktuelle zu behalten.

Zum Trennen öffne das Menü **Connected** der Verbindung, wähle **Disconnect** und bestätige mit **Delete**. Die GLS-Karte verschwindet aus den Tickets, und **Track shipment**-Aktionen von KI-Agenten, die diese Verbindung nutzen, funktionieren nicht mehr. Deine Pakete und dein GLS-Konto bleiben unverändert.

## Fehlerbehebung

### Die Verbindung lässt sich nicht speichern

* Prüfe, ob **API Key** und **API Secret** vollständig und ohne Leerzeichen kopiert sind.
* Stell sicher, dass sie zu der GLS-App gehören, die du für Track And Trace V1 angelegt hast.

### Jede Abfrage schlägt fehl

* Hat GLS die Freigabe deiner App für Track And Trace V1 noch nicht abgeschlossen, bitte den GLS-Support darum.
* Wurden die Zugangsdaten bei GLS erneuert, aktualisiere sie in der Verbindung.

### Die Karte sagt, GLS kenne kein Paket zu der Nummer

* Prüfe die Nummer auf Tippfehler. GLS akzeptiert Paketnummer, Track-ID oder Benachrichtigungskarten-ID.
* Die Nummer gehört vielleicht zu einem anderen Versanddienstleister oder zu einer Sendung außerhalb von Österreich und Deutschland.

Wenn nichts davon hilft, wende dich an den Chatarmin-CX-Support. Nenne den Ticket-Link und die Uhrzeit der Abfrage, aber nie dein API Secret.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.