Zum Hauptinhalt springen
Die Recharge-Integration verbindet Recharge, 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, seltener zu liefern, die Menge pro Lieferung oder die Lieferadresse zu ändern
  • 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)
  • 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 und zusätzlich Lesezugriff auf Abbuchungen für die KI-Aktion Get subscription charges. 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.
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.
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.

Abo-Aktionen im Posteingang

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, 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“.
Alle Schreib-Aktionen starten mit menschlicher Freigabe auf Immer fragen. In Agenten-Tests werden Schreib-Aktionen simuliert und ändern nichts in Recharge.
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.
Dieser Abgleich läuft über die E-Mail-Adresse des Kontakts — er ist kein Identitätsnachweis. Im Website-Chat wird eine E-Mail-Adresse, die ein Besucher eingibt, am Kontakt gespeichert; wer dort eine fremde Adresse einträgt, erreicht deren Abos. Lass die Freigabe an, prüf das Abo in der Freigabe-Anfrage, bevor du zustimmst, und verlange auf Kanälen ohne authentifizierte Absenderadresse eine Identitätsprüfung.
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 mit Ticketnummer, Zeitpunkt des Fehlers und der genauen Meldung. Schick nie dein Recharge-API-Token mit.