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

# GoKarla

> GoKarla-Sendungsverfolgung im Posteingang sehen und Bestellungen mit KI-Agenten abfragen.

Die GoKarla-Integration verbindet [GoKarla](https://gokarla.io), eine Plattform für Bestell- und Sendungsverfolgung, mit Chatarmin CX. Wenn die E-Mail des Ticket-Kontakts zu Bestellungen in deinem GoKarla-Shop passt, erscheinen diese Bestellungen samt Tracking-Status im Kundenpanel. So beantworten Agenten Lieferfragen, ohne GoKarla zu öffnen.

<Note>
  GoKarla ist in cx **nur lesend**. Agenten und KI-Agenten können Bestellungen und Sendungen abfragen, aber nichts in GoKarla ändern.
</Note>

## Wann du es brauchst

Nutze GoKarla, wenn dein Shop Sendungen bereits in GoKarla verfolgt und dein Support-Team regelmäßig Folgendes bearbeitet:

* Fragen wie „Wo ist meine Bestellung?“ oder „Wann kommt mein Paket?“
* prüfen, mit welchem Versanddienstleister eine Bestellung verschickt wurde, und die Tracking-Seite öffnen
* bestätigen, was bestellt wurde und wohin geliefert wird

## GoKarla einrichten

Du brauchst drei Werte aus deinem GoKarla-Konto: einen **Username**, einen **API Key** und deinen **Shop Slug**. GoKarlas [API-Dokumentation](https://docs.gokarla.io/api/v1/) beschreibt den API-Zugang. Frag deinen GoKarla-Kontakt, falls du die Werte noch nicht hast.

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

  <Step title="Shop verbinden">
    Klick auf **Verbinden**, trag **Username**, **API Key** und **Shop Slug** ein und klick im Dialog auf **Connect**. Die Verbindung erscheint unter deinen verbundenen Konten, benannt nach dem Username.
  </Step>

  <Step title="Verbindung prüfen">
    Öffne ein Ticket von einem Kunden mit einer GoKarla-Bestellung und prüfe, ob die Bestellung im Kundenpanel erscheint.
  </Step>
</Steps>

<Warning>
  cx speichert die Zugangsdaten, ohne sie gegen GoKarla zu testen. Ein falscher API Key oder Shop Slug fällt erst auf, wenn eine Bestellabfrage fehlschlägt. Prüf deshalb direkt nach dem Verbinden ein echtes Ticket.
</Warning>

## GoKarla im Posteingang nutzen

Wenn GoKarla verbunden ist und der Ticket-Kontakt eine E-Mail-Adresse hat, sucht cx die Bestellungen dieses Kontakts in GoKarla.

1. Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
2. Im **Kundenpanel** findest du den Bereich **GoKarla**, sobald der Kontakt eine oder mehrere GoKarla-Bestellungen hat.
3. Jede Bestellung zeigt:
   * die Bestellnummer mit Link zur GoKarla-Tracking-Seite und Kopier-Button
   * den Gesamtpreis und das Bestelldatum
   * ein Status-Badge aus dem letzten Tracking-Ereignis (zum Beispiel die aktuelle Lieferphase)
   * die Lieferadresse
   * eine Karte pro Sendung mit Versanddienstleister, Status, Trackingnummer und Tracking-Link
   * eine **Products**-Liste mit Titel, Menge, Preis, SKU und Bild

### Bestellungen Kontakten zuordnen

Die Zuordnung läuft über die **E-Mail-Adresse**. cx prüft die Haupt-E-Mail des Kontakts und alle weiteren E-Mail-Adressen am Kontakt und zeigt jede Bestellung nur einmal.

| Situation | Was du siehst |
| - | - |
| GoKarla nicht verbunden | Kein Bereich GoKarla |
| Kontakt hat keine E-Mail | Keine GoKarla-Bestellungen. Ergänze eine E-Mail am Kontakt |
| E-Mail vorhanden, keine Bestellungen in GoKarla | Keine GoKarla-Bestellungen für diesen Kontakt |
| Kunde hat mit einer anderen E-Mail bestellt | Kein Treffer. Ergänze diese E-Mail am Kontakt |

Telefonnummern und Bestellnummern werden im Kundenpanel nicht zur Zuordnung genutzt.

## Aktionen für KI-Agenten

Gib einem [KI-Agenten](/de/ai-agents/skills-and-actions) GoKarla-Aktionen, wenn Automatisierung Tracking-Fragen beantworten soll.

Verbinde zuerst GoKarla, aktiviere dann die Aktionen am Agenten und wähle aus, welche verbundenen GoKarla-Konten der Agent nutzen darf.

### Lese-Aktionen

* **Get order**: Fragt eine GoKarla-Bestellung per Bestellnummer ab.
* **Get shipment**: Fragt eine GoKarla-Sendung per Trackingnummer ab.

Beide Aktionen brauchen die Bestell- oder Trackingnummer. Weise den Agenten in seinen Anweisungen an, den Kunden danach zu fragen, wenn sie nicht im Gespräch steht. Jede Aktion unterstützt [menschliche Freigabe](/de/ai-agents/human-in-the-loop), falls du Abfragen vor der Ausführung prüfen willst.

## GoKarla trennen

Öffne in den [Integrationen](https://armin.cx/app/_/settings/integrations) **GoKarla**, öffne am Konto das Menü **Connected** und wähle **Disconnect**. Bestätige mit **Delete**. GoKarla-Bestellungen verschwinden aus dem Kundenpanel, und KI-Agenten können dieses Konto nicht mehr nutzen.

## Fehlerbehebung

### Keine Bestellungen für einen Kunden

* Prüfe, ob die E-Mail des Kontakts zur E-Mail der Bestellung in GoKarla passt. Ergänze die Bestell-E-Mail am Kontakt, wenn der Kunde von einer anderen Adresse geschrieben hat.
* Stell sicher, dass die Bestellung zu dem Shop gehört, dessen Shop Slug du verbunden hast.

### Bestellabfragen schlagen fehl

* Die Zugangsdaten werden beim Verbinden nicht getestet. Prüf Username, API Key und Shop Slug erneut: Klick in den Integrationen auf das Konto, um es zu bearbeiten.
* Wenn der API Key in GoKarla erneuert wurde, aktualisiere ihn in cx.

### Ein KI-Agent meldet, dass eine Bestellung oder Sendung nicht gefunden wurde

* GoKarla hat zu dieser Bestell- oder Trackingnummer keinen Treffer geliefert. Prüf die Nummer mit dem Kunden und versuch es erneut.
* Stell sicher, dass der Agent das GoKarla-Konto des Shops nutzen darf, aus dem die Bestellung stammt.


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