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

# Loop

> Kunden-Abos im Posteingang ansehen und verwalten — auch mit KI-Agenten.

Die Loop-Integration verbindet [Loop Subscriptions](https://www.loopsubscriptions.com), eine Abo-Commerce-App für Shopify, mit Chatarmin CX. Wenn die E-Mail des Ticket-Kontakts zu einem Kunden in einem verbundenen Loop-Konto passt, erscheinen dessen Abos im Kundenpanel — Agenten sehen Status und können Änderungen direkt im Ticket vornehmen.

<Note>
  Loop-Abos erscheinen im **Kundenpanel** eines Tickets. Sie erzeugen keine eigenen Posteingang-Tickets und keine Benachrichtigungen von Loop.
</Note>

## Wann du es brauchst

Nutze Loop, wenn du Abo-Produkte über Shopify verkaufst und dein Support-Team regelmäßig Folgendes bearbeitet:

* Fragen wie „Wann kommt meine nächste Bestellung?“ oder „Was ist in meiner nächsten Lieferung?“
* Pausieren, Überspringen oder Verschieben einer anstehenden Bestellung
* Kündigungen, Reaktivierungen und Mengenänderungen an einem Abo

Die Integration hält Ticket-Kontext und Abo-Details an einem Ort — statt im Loop-Händler-Dashboard nachzuschauen.

## Loop einrichten

Du brauchst ein Loop-**Admin API Token** für den Shopify-Store, dessen Abos du verbinden willst. Erzeuge eines über Loops [Anleitung für API-Tokens](https://developer.loopwork.co/reference/generate-admin-api-tokens).

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

    Wenn Loop nicht in der Liste steht, wende dich an dein Chatarmin-CX-Team, um die Funktion für deinen Workspace freizuschalten.
  </Step>

  <Step title="Store verbinden">
    Klick auf **Verbinden** und füge das Admin API Token aus deinem Loop-Dashboard ein. cx prüft das Token gegen Loop, bevor die Verbindung gespeichert wird.
  </Step>

  <Step title="Weitere Stores verbinden (optional)">
    Wiederhole **Verbinden** für jeden Shopify-Store mit Loop, den dein Team betreut. Jede Verbindung synchronisiert eigene Abos.
  </Step>
</Steps>

<Tip>
  Betreibst du mehr als einen Shopify-Store mit Loop, verbinde jeden einzeln — so unterscheiden Agenten und KI-Agenten beim Auswählen eines Abos, welcher Store gemeint ist.
</Tip>

## Loop im Posteingang nutzen

Wenn Loop verbunden ist und der Ticket-Kontakt eine E-Mail-Adresse hat, gleicht cx diese E-Mail mit den Abos des verbundenen Loop-Kontos ab.

1. Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
2. Im **Kundenpanel** findest du den Bereich **Abos**, sobald der Kontakt ein oder mehrere Loop-Abos hat.
3. Öffne ein Abo, um Status, Produktzeilen und Mengen, nächstes Bestelldatum, Abrechnungsintervall, Versandkosten, Lieferadresse, Zahlungsmethode, Rabatte und eine eventuelle Bestellnotiz zu sehen.
4. Nutze die Aktionsschaltflächen am Abo, um etwas zu ändern: **Pausieren**, **Fortsetzen**, **Kündigen**, **Reaktivieren**, **Nächste Bestellung verschieben**, **Nächste Bestellung überspringen** oder **Menge ändern** an einer Produktzeile.

### Abos Kontakten zuordnen

Die Zuordnung läuft über die **E-Mail-Adresse** des Kontakts gegen die Kunden-E-Mail des Loop-Abos.

| Situation                                         | Was du siehst                                 |
| ------------------------------------------------- | --------------------------------------------- |
| Loop nicht verbunden                              | Kein Bereich Abos                             |
| Kontakt ohne E-Mail                               | E-Mail am Kontakt ergänzen, um Abos zu suchen |
| E-Mail vorhanden, keine Abos in Loop              | Bereich Abos bleibt ausgeblendet              |
| Loop-Abfrage schlägt fehl (Verbindung fehlerhaft) | Fehlerzustand statt leerer Liste              |

## Abo-Aktionen im Posteingang

| Aktion                          | Was sie macht                                                                                   |
| ------------------------------- | ----------------------------------------------------------------------------------------------- |
| Pausieren                       | Pausiert das Abo unbefristet. Loop unterstützt kein Pausieren für eine feste Anzahl Tage.       |
| Fortsetzen                      | Setzt ein pausiertes Abo fort.                                                                  |
| Kündigen                        | Kündigt das Abo, optional mit einem Kommentar zur Kündigung.                                    |
| Reaktivieren                    | Bringt ein gekündigtes Abo zurück.                                                              |
| Nächste Bestellung verschieben  | Verschiebt nur das Datum der nächsten Bestellung. Spätere Bestellungen behalten ihren Zeitplan. |
| Nächste Bestellung überspringen | Überspringt nur die nächste Lieferung — das Abo läuft danach weiter.                            |
| Menge ändern                    | Ändert die Menge einer Produktzeile des Abos.                                                   |

<Warning>
  **Kündigen** beendet das Abo des Kunden in Loop. Stimme dich vorher mit dem Kunden ab und nutze **Reaktivieren**, um es rückgängig zu machen.
</Warning>

Jede Aktion prüft vor der Ausführung erneut, ob das Abo tatsächlich zum Kontakt des Tickets gehört — ein Agent kann also nur Abos ändern, die dieser E-Mail gehören.

## KI-Agenten-Aktionen

Aktiviere Loop-Aktionen auf einem [KI-Agenten](/de/ai-agents/skills-and-actions), wenn Automatisierung Abos nachschlagen oder Änderungen auf abobezogenen Tickets vornehmen soll.

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

### Lese-Aktionen

* **Get subscription** — Ein Abo per Abo-ID nachschlagen, oder per Kunden-E-Mail alle Abos eines Kunden finden (Status, nächstes Abrechnungsdatum, Produkte, Mengen). Immer zuerst nutzen, bevor eine Änderung vorgeschlagen wird — so handelt der Agent am richtigen Abo.

### Schreib-Aktionen

* **Pause subscription** — Ein Abo unbefristet pausieren.
* **Resume subscription** — Ein pausiertes Abo fortsetzen.
* **Cancel subscription** — Ein Abo kündigen, optional mit Kündigungskommentar.
* **Reactivate subscription** — Ein gekündigtes Abo zurückholen.
* **Reschedule next order** — Nur das Datum der nächsten Bestellung verschieben; spätere Bestellungen bleiben unberührt.
* **Skip next order** — Nur die nächste Lieferung überspringen.
* **Update line quantity** — Die Menge einer Produktzeile des Abos ändern.

Alle Loop-Schreib-Aktionen verlangen standardmäßig eine [menschliche Freigabe](/de/ai-agents/human-in-the-loop), bevor sie ausgeführt werden. Passe die Freigabe pro Aktion in der Agenten-Konfiguration an.

<Tip>
  Schreib in den Agenten-Anweisungen, dass zuerst **Get subscription** aufgerufen wird und die dort zurückgegebene Abo-ID und Zeilen-ID verwendet werden — nie eine geratene oder erinnerte ID — für jede Schreib-Aktion.
</Tip>

## Best Practices

* Halte die Kontakt-E-Mail mit der E-Mail synchron, die der Kunde bei Shopify genutzt hat. Aktualisiere den Kontakt, wenn er von einer anderen Adresse schreibt.
* Verbinde jeden Shopify-Store einzeln, wenn du Loop auf mehreren Stores betreibst, damit Agenten und KI-Agenten den richtigen wählen.
* Verlange weiterhin eine Freigabe für **Kündigen**, bis du dem Kündigungs-Playbook des Agenten vertraust — die Aktion beendet das Abo des Kunden.
* Denk daran: Verschieben und Überspringen wirken nur auf die nächste Bestellung, nicht auf den gesamten Abo-Zeitplan.

## Fehlerbehebung

### Verbindungstest schlägt fehl

* Prüfe, ob das Admin API Token für den richtigen Shopify-Store erzeugt wurde und in Loop nicht widerrufen ist.
* Erzeuge das Token in Loop neu, falls es rotiert wurde oder abgelaufen ist, und aktualisiere die Integration in cx.

### Keine Abos für einen Kunden

* Stimmt die Kontakt-E-Mail mit der Kunden-E-Mail des Loop-Abos überein?
* Gehört das Abo zu einem Loop-Store, den du in diesem Workspace verbunden hast?

### Eine Aktion schlägt fehl

* Loop-Aktionen werden vor der Ausführung erneut gegen die E-Mail des Kontakts geprüft — passt das Abo nicht mehr zu dieser E-Mail (z. B. weil sich die Kunden-E-Mail in Loop geändert hat), wird die Aktion abgelehnt. Öffne das Abo neu und prüfe die aktuelle Kunden-E-Mail in Loop.
* Eine Mengenänderung schlägt fehl, wenn die Zeilen-ID am Abo nicht mehr existiert — öffne das Abo erneut, um aktuelle Zeilen-IDs zu erhalten, bevor du es erneut versuchst.