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, seltener zu liefern, die Menge pro Lieferung oder die Lieferadresse zu ändern
- Abo-Kündigungen
Recharge einrichten
Du brauchst:- die Berechtigung Manage integrations in cx (Admins haben sie standardmäßig — siehe Rollen und Berechtigungen)
- ein Recharge-API-Token für jeden Store, den du verbinden willst
1
Integrationen öffnen
Öffne Integrationen in den Workspace-Einstellungen und wähle Recharge.
2
Store verbinden
Klick auf Verbinden, füge das Token in API Token ein und klick im Dialog auf Connect. Danach zeigt die Verbindung Connected an.
3
Lesend testen
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.
4
Weitere Stores verbinden (optional)
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.
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.- Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
- Klapp im Kundenpanel die Recharge-Zeile auf (mit dem Recharge-Logo).
- Jedes Abo zeigt Produkt, Variante, Menge, Status, Nächste Abbuchung, Betrag und Häufigkeit (z. B. „Every 2 weeks“). Aktive Abos stehen oben.
- 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.Abo-Aktionen im Posteingang
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, 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.- 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.
- Get subscription charges listet die Abbuchungen eines Abos (Status, geplantes Datum, Abbuchungsdatum) und für wie viele Lieferungen Recharge schon abgerechnet hat — gezählt werden nur erfolgreich abgerechnete Abbuchungen, eine anstehende, übersprungene oder fehlgeschlagene zählt nicht, und ob ein Paket ankam, weiß Recharge nicht. Recharge hebt nur die letzten 90 Tage an Abbuchungen auf: Ist das Abo älter, steht das im Ergebnis, und die Zahl ist eine Untergrenze, nicht die Gesamtzahl der Lieferungen.
- Change delivery interval legt fest, wie oft das Abo geliefert wird (zum Beispiel statt alle 4 Wochen alle 8 Wochen). Recharge bucht im selben Takt, in dem es liefert, also verschiebt cx das Abbuchungsintervall mit. Die Recharge-API kennt kein Pausieren oder Fortsetzen; biete stattdessen ein längeres Intervall, ein späteres Abbuchungsdatum oder eine in Recharge übersprungene Lieferung an.
- Change subscription quantity legt fest, wie viele Einheiten pro Lieferung verschickt werden (zum Beispiel statt 1 Box 2). Recharge berechnet jede Lieferung anhand der Menge, das ändert also, was der Kunde pro Abbuchung zahlt.
- Change delivery address setzt eine neue Lieferadresse für das Abo (zum Beispiel nach einem Umzug). Recharge speichert pro Lieferort eine Adresse, cx ändert also diesen Datensatz: Jedes weitere Abo desselben Kunden an diese Adresse zieht mit um, und die Freigabe-Anfrage nennt die Anzahl. Der Agent muss die vollständige Adresse senden (Straße, Stadt, Postleitzahl, Land) — eine Teiländerung würde eine nicht zustellbare Adresse hinterlassen, und eine Adresszeile oder Provinz, die die neue Adresse nicht hat, wird gelöscht statt übernommen. Die Freigabe-Anfrage zeigt die neue Adresse vollständig.
- 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“.
Auf einem Ticket, das einem Kunden antwortet, arbeiten KI-Aktionen nur auf dessen eigenen Abos: cx sucht den Recharge-Kunden zur E-Mail des Kontakts und liest das Abo eines anderen Kunden als „nicht gefunden“, ohne etwas zu ändern. Für Mitarbeiter-Läufe (Einrichtung, Ask Torben) gilt diese Einschränkung nicht. In beiden Fällen prüft cx zusätzlich, ob die Abo-ID in genau einer ausgewählten Recharge-Verbindung existiert.
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.