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