> ## 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.
# Recharge
> Kunden-Abos im Posteingang sehen, Abbuchungsdaten verschieben oder kündigen — manuell oder mit KI-Agenten.
Die Recharge-Integration verbindet [Recharge](https://www.rechargepayments.com), eine Abo-Commerce-Plattform für Shopify, mit Chatarmin CX. Wenn die E-Mail des Ticket-Kontakts zu einem Kunden in einem verbundenen Recharge-Store passt, erscheinen dessen Abos im Kundenpanel. Agenten können das nächste Abbuchungsdatum verschieben oder ein Abo kündigen, ohne das Ticket zu verlassen.
Recharge-Abos erscheinen im **Kundenpanel** eines Tickets. Recharge erzeugt in cx keine Tickets und keine Benachrichtigungen.
## Wann du es brauchst
Nutze Recharge, wenn du Abo-Produkte über Shopify verkaufst und dein Support-Team regelmäßig Folgendes bearbeitet:
* Fragen wie „Wann wird meine nächste Bestellung abgebucht?“ oder „Was habe ich abonniert?“
* Wünsche, die nächste Abbuchung oder Lieferung nach hinten zu schieben
* Abo-Kündigungen
Die Integration hält Ticket-Kontext und Abo-Details an einem Ort — statt im Recharge-Händlerportal nachzuschauen.
## Recharge einrichten
Du brauchst:
* die Berechtigung **Manage integrations** in cx (Admins haben sie standardmäßig — siehe [Rollen und Berechtigungen](/de/settings/roles-and-permissions))
* ein Recharge-**API-Token** für jeden Store, den du verbinden willst
Nach den Recharge-API-Aufrufen, die cx macht, braucht das Token **Lesezugriff auf Kunden** sowie **Lese- und Schreibzugriff auf Abos**. Mit einem reinen Lese-Token siehst du die Abos, aber **Datum verschieben** und Kündigen schlagen fehl. Erstelle das Token in deinem Recharge-Händlerportal; aktuelle Token- und Scope-Optionen findest du in der [Recharge-API-Dokumentation](https://developer.rechargepayments.com/2021-11/).
[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **Recharge**.
Klick auf **Verbinden**, füge das Token in **API Token** ein und klick im Dialog auf **Connect**. Danach zeigt die Verbindung **Connected** an.
cx speichert das Token, ohne es gegen Recharge zu prüfen. Öffne ein Ticket von einem Kunden, der sicher ein Recharge-Abo hat, und klapp die Recharge-Zeile im Kundenpanel auf. Siehst du seine Abos, funktioniert das Token. Teste nicht mit **Datum verschieben** oder Kündigen — beides ändert das echte Abo.
Klick auf **+** (**Hinzufügen**) neben **Verbundene Konten** und wiederhole das für jeden Shopify-Store mit Recharge. Jede Verbindung sucht Kunden in ihrem eigenen Store.
cx fragt keinen Namen für die Verbindung ab. Jede Recharge-Verbindung heißt deshalb **Integration** — in den Einstellungen, im Kundenpanel und in der Store-Auswahl der KI-Agenten. Verbindest du mehrere Stores, notier dir, welchen Store du an welchem Tag hinzugefügt hast. Die Karte in den Einstellungen zeigt das Datum.
### Token ersetzen oder trennen
* **Token ersetzen:** Öffne die Verbindung auf der Recharge-Einstellungsseite, füge das neue Token in **API Token** ein und klick auf **Connect**.
* **Trennen:** Öffne das Menü **Connected** an der Verbindung, wähle **Disconnect** und bestätige mit **Delete**. Das lässt sich nicht rückgängig machen. Entferne die Verbindung aus allen KI-Agenten-Aktionen, die sie nutzen, und widerrufe das Token in Recharge, wenn du es nicht mehr brauchst.
## Recharge im Posteingang nutzen
cx sucht die E-Mail des Kontakts in jedem verbundenen Recharge-Store.
1. Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
2. Klapp im **Kundenpanel** die Recharge-Zeile auf (mit dem Recharge-Logo).
3. Jedes Abo zeigt Produkt, Variante, Menge, Status, **Nächste Abbuchung**, **Betrag** und **Häufigkeit** (z. B. „Every 2 weeks“). Aktive Abos stehen oben.
4. Bei einem **aktiven** Abo nutzt du **Datum verschieben** oder die Kündigen-Schaltfläche (im deutschen UI beschriftet mit **Abbrechen**). Pausierte und gekündigte Abos haben keine Aktionsschaltflächen.
### Abos Kontakten zuordnen
Die Zuordnung läuft über die **E-Mail-Adresse** des Kontakts gegen die Kunden-E-Mail in Recharge. Es zählt nur die Haupt-E-Mail des Kontakts.
| Situation | Was du siehst |
| - | - |
| Recharge nicht verbunden | Keine Recharge-Zeile |
| Kontakt ohne E-Mail | Keine Recharge-Zeile — ergänze eine E-Mail am Kontakt |
| E-Mail vorhanden, kein passender Recharge-Kunde oder keine Abos | „Keine Recharge-Abonnements für diesen Kunden gefunden“ |
| Recharge lehnt die Anfrage ab (z. B. ungültiges oder widerrufenes Token) | „Recharge-Abonnements konnten nicht geladen werden.“ |
| Der Verbindung fehlt das Token oder sie wird nicht gefunden | „Diese Recharge-Integration ist nicht korrekt konfiguriert.“ |
## Abo-Aktionen im Posteingang
| Aktion | Was sie macht |
| - | - |
| Datum verschieben | Öffnet **Nächstes Abbuchungsdatum verschieben**. Wähle ein neues **Nächstes Abbuchungsdatum** — heute oder später — und klick auf **Datum verschieben**. cx setzt es in Recharge als nächstes Abbuchungsdatum des Abos. |
| Kündigen (Schaltfläche **Abbrechen**) | Öffnet **Abonnement kündigen**. Optional gibst du einen **Grund** an (bis zu 500 Zeichen) und klickst auf **Abonnement kündigen**. Ohne Grund speichert cx „Cancelled via ArminCX“ als Kündigungsgrund in Recharge. **Abonnement behalten** schließt den Dialog ohne Änderung. |
Kündigen beendet das Abo des Kunden in Recharge, und cx hat keine Aktion, um das rückgängig zu machen. Stimm dich vorher mit dem Kunden ab. Ein versehentlich gekündigtes Abo stellst du direkt in Recharge wieder her. Ob Recharge dem Kunden eine eigene Kündigungs-E-Mail schickt, steuert cx nicht.
Bevor eine Änderung ausgeführt wird, sucht cx den Recharge-Kunden zur E-Mail des Ticket-Kontakts erneut und prüft, ob das Abo ihm gehört. Ein Agent kann also nur Abos ändern, die zu dieser E-Mail gehören. Nach einer erfolgreichen Änderung lädt die Abo-Liste neu.
## KI-Agenten-Aktionen
Aktiviere Recharge-Aktionen auf einem [KI-Agenten](/de/ai-agents/skills-and-actions), wenn Automatisierung Abo-Fragen beantworten oder Abos verschieben und kündigen soll.
Verbinde Recharge zuerst, aktiviere dann die Aktionen am Agenten und wähle unter **Recharge integrations**, welche Verbindungen der Agent nutzen darf.
| Aktion | Typ | Standard-Freigabe |
| - | - | - |
| **Get subscription** | Lesen | Nicht nötig |
| **Move next charge date** | Schreiben | Immer fragen |
| **Cancel subscription** | Schreiben | Immer fragen |
* **Get subscription** sucht ein Abo per Abo-ID oder alle Abos eines Kunden per E-Mail (Status, nächstes Abbuchungsdatum, Produkt, Menge). Gibt der Agent ID und E-Mail mit, liefert cx das Abo nur, wenn es zu dieser E-Mail gehört.
* **Move next charge date** setzt ein neues nächstes Abbuchungsdatum (heute oder später).
* **Cancel subscription** kündigt ein Abo, optional mit einem Grund, den der Agent formuliert. Ohne Grund speichert cx „Cancelled via ArminCX“.
Beide Schreib-Aktionen starten mit [menschlicher Freigabe](/de/ai-agents/human-in-the-loop) auf **Immer fragen**. In [Agenten-Tests](/de/ai-agents/testing-and-runs) werden Schreib-Aktionen simuliert und ändern nichts in Recharge.
Anders als die Schaltflächen im Posteingang prüfen KI-Schreib-Aktionen nicht, ob das Abo zum Kontakt des Tickets gehört. Sie prüfen nur, ob die Abo-ID in genau einer ausgewählten Recharge-Verbindung existiert. Lass die Freigabe an und prüf das Abo in der Freigabe-Anfrage, bevor du zustimmst.
Schreib in die Agenten-Anweisungen, dass zuerst **Get subscription** mit der E-Mail des Kunden aufgerufen wird und nur eine dort zurückgegebene Abo-ID verwendet wird — nie eine geratene oder erinnerte ID.
## 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.
* Stimm Kündigungen mit dem Kunden ab, bevor du oder ein Agent kündigt. In cx lässt sich eine Kündigung nicht rückgängig machen.
* Lass **Cancel subscription** auf **Immer fragen**, bis du dem Kündigungs-Playbook des Agenten vertraust.
* Verbindest du mehrere Stores, gib jedem KI-Agenten nur die Verbindungen, die er braucht. Taucht eine Abo-ID in mehr als einem ausgewählten Store auf, schlagen Schreib-Aktionen fehl.
## Fehlerbehebung
### „Recharge-Abonnements konnten nicht geladen werden.“
cx prüft das Token beim Verbinden nicht — ein falsches Token fällt deshalb zuerst hier auf.
* Prüfe, ob das Token zum richtigen Recharge-Store gehört und nicht widerrufen ist.
* Erstelle bei Bedarf ein neues Token in Recharge und ersetze es auf der Recharge-Einstellungsseite.
### „Diese Recharge-Integration ist nicht korrekt konfiguriert.“
Die Verbindung hat kein nutzbares Token. Ersetze das Token auf der Recharge-Einstellungsseite. Bleibt die Meldung, wende dich an den Support (siehe unten).
### Keine Recharge-Zeile oder keine Abos
* Prüfe, ob der Kontakt eine E-Mail-Adresse hat. Ohne E-Mail gibt es keine Recharge-Zeile.
* Stimmt die Kontakt-E-Mail mit der Kunden-E-Mail in Recharge überein?
* Gehört der Kunde zu einem Recharge-Store, den du in diesem Workspace verbunden hast?
### Eine Aktion im Posteingang schlägt fehl
Die Fehlermeldung enthält die Antwort von Recharge.
* **„Subscription does not belong to this contact“** oder **„No Recharge customer found for this contact“**: Die E-Mail des Kontakts passt nicht zum Kunden des Abos in Recharge. Prüf die Kunden-E-Mail in Recharge.
* Ein Berechtigungsfehler von Recharge heißt meist, dass das Token Abos lesen, aber nicht ändern darf. Erstelle ein Token mit Schreibzugriff auf Abos.
### Eine KI-Schreib-Aktion schlägt fehl
* **„…exists in multiple configured stores…“**: Dieselbe Abo-ID existiert in zwei ausgewählten Verbindungen. Beschränke die Aktion auf eine Recharge-Verbindung.
* **„This action is stale…“**: Das Ticket hat nach dem Vorschlag eine neuere Nachricht bekommen oder wurde gelöst. In Recharge hat sich nichts geändert; prüf das aktuelle Ticket, bevor du erneut handelst.
Hilft nichts davon, [schreib dem Support](mailto:support@chatarmin.com) mit Ticketnummer, Zeitpunkt des Fehlers und der genauen Meldung. Schick nie dein Recharge-API-Token mit.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.