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

# Memberr

> Guthaben und Mitgliedschaftsstufen im Posteingang prüfen und Guthaben mit KI-Agenten anpassen.

Die Memberr-Integration verbindet [Memberr](https://www.memberr.de), eine Plattform für Guthaben, Loyalty und Mitgliedschaften, mit Chatarmin CX. Wenn die E-Mail des Ticket-Kontakts zu einem Kunden in einem verbundenen Memberr-Shop passt, zeigt das Kundenpanel sein Guthaben, den Guthaben-Verlauf und seine Mitgliedschaftsstufe. Agenten können Guthaben direkt im Ticket hinzufügen oder reduzieren.

<Note>
  Memberr-Daten erscheinen im **Kundenpanel** eines Tickets. Memberr erzeugt keine Tickets und keine Benachrichtigungen in Chatarmin CX.
</Note>

## Wann du es brauchst

Nutze Memberr, wenn dein Shop ein Loyalty- oder Mitgliedschaftsprogramm über Memberr betreibt und dein Support-Team regelmäßig Folgendes bearbeitet:

* Fragen wie „Wie viel Guthaben habe ich?“ oder „Wo ist mein Guthaben hin?“
* Guthaben, das bald verfällt, oder ein Guthaben, das niedriger wirkt als erwartet
* Fragen wie „In welcher Stufe bin ich?“ oder „Wie viel muss ich noch für die nächste Stufe ausgeben?“
* Kulanz-Guthaben oder Entschädigung für eine verspätete oder beschädigte Bestellung
* Korrektur von doppelt gebuchtem Guthaben

## Memberr einrichten

Du brauchst für jeden Memberr-Shop, den du verbinden willst, einen **Secret API Key** und einen Wert für **Shop System** aus deinem Memberr-Konto. Memberr ist für Shopify-Shops gebaut, Shop System ist also `shopify`, außer dein Memberr-Kontakt sagt dir etwas anderes.

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

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

  <Step title="Zugangsdaten eintragen">
    Klick auf **Verbinden** und füll das Formular aus:

    | Feld | Was du einträgst |
    | - | - |
    | **Secret API Key** | Der Secret API Key aus deinem Memberr-Konto. |
    | **Shop System** | Das Shop-System, zu dem Memberr diesen Shop zuordnet. Trag `shopify` ein, außer Memberr sagt dir etwas anderes. |
    | **Ticket-Ursprungsdomain (optional)** | Die genaue Shop-Domain, auf der dein Chat-Widget läuft, zum Beispiel `shop.example.com`. Nur nötig, wenn du mehr als einen Memberr-Shop verbindest. |

    Speichere mit **Connect**. Du siehst **Integration connected successfully** und der Shop steht auf der Memberr-Integrationsseite.
  </Step>

  <Step title="Sicher testen">
    Chatarmin CX prüft den Schlüssel beim Speichern nicht. Öffne ein Ticket von einem Kunden, den es in Memberr sicher gibt, und prüfe, ob die Memberr-Karte sein Guthaben zeigt. Dabei werden nur Daten gelesen – du kannst das gefahrlos mit einem echten Kunden testen.
  </Step>

  <Step title="Weitere Shops verbinden (optional)">
    Wiederhole **Verbinden** für jeden Memberr-Shop, den dein Team betreut. Setz bei jedem Shop mit Chat-Widget eine **Ticket-Ursprungsdomain**, damit Chatarmin CX Widget-Tickets automatisch dem richtigen Shop zuordnet.
  </Step>
</Steps>

Um eine Verbindung später zu ändern, klick in den [Integrationen](https://armin.cx/app/_/settings/integrations) auf den verbundenen Shop. Lass **Secret API Key** leer, um den aktuellen Schlüssel zu behalten.

<Warning>
  Chatarmin CX fragt keinen Verbindungsnamen ab. Deshalb heißt jeder Memberr-Shop in den Einstellungen **Integration** und im Shop-Auswähler im Posteingang **Memberr** – bei mehreren Shops sehen sie identisch aus. Notier dir, welches Shop System oder welche Ticket-Ursprungsdomain zu welchem echten Shop gehört, und setz bei jedem Shop mit Chat-Widget eine **Ticket-Ursprungsdomain**, damit Chatarmin CX Widget-Tickets automatisch zuordnen kann.
</Warning>

### So funktioniert die Ticket-Ursprungsdomain

Mit einem Memberr-Shop nutzt jedes Ticket diesen Shop. Mit mehreren Shops muss Chatarmin CX wissen, zu welchem Shop ein Ticket gehört:

* Bei **Chat-Widget-Tickets** vergleicht Chatarmin CX die Website, von der der Kunde schreibt, mit der **Ticket-Ursprungsdomain** jedes Shops. Passt genau ein Shop, öffnet die Karte ihn automatisch.
* Bei allen anderen Tickets, zum Beispiel E-Mail, oder wenn keine Domain passt, wählt der Agent den Shop auf der Karte aus.

## Memberr im Posteingang nutzen

Wenn Memberr verbunden ist und der Ticket-Kontakt eine E-Mail-Adresse hat, sucht Chatarmin CX diese E-Mail in den verbundenen Memberr-Shops. Die **Memberr**-Karte erscheint im Kundenpanel nur, wenn es den Kunden in mindestens einem Shop gibt.

1. Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
2. Klapp im **Kundenpanel** die **Memberr**-Karte auf.
3. Hast du mehrere Shops verbunden und die Karte kann keinen auswählen, wähle den Shop über **Memberr-Shop auswählen**.

Die Karte zeigt:

| Bereich | Was du siehst |
| - | - |
| **Guthaben** | Das aktuelle Guthaben und die Währung. Ist noch Guthaben ausstehend, zeigt eine Zeile wie „+5,00 € bald verfügbar“ den kommenden Betrag. |
| **Guthaben-Verlauf** | Öffnet alle Gutschriften und Abbuchungen mit Quelle (zum Beispiel **Bestellung**, **Cashback**, **Empfehlung** oder **Manuelle Anpassung**), Datum und Betrag sowie das nächste Verfallsdatum. Abbuchungen aus derselben Bestellung werden zu einer Zeile zusammengefasst. |
| **Mitgliedschaft** | Die aktive Stufe, ob sie **Aktiv** oder **Inaktiv** ist, und wann sie abläuft. |
| **Nächste Stufe** | Der Fortschritt zur nächsten Stufe: bisheriger Umsatz, noch fehlender Umsatz und verbleibende Tage zur Qualifikation. |
| **Geburtstag** | Der Geburtstag des Kunden, wenn Memberr ihn kennt. |
| **Kunde ist gesperrt** | Ein Hinweis, wenn der Kunde in Memberr gesperrt ist. |
| **In Memberr öffnen** | Öffnet das Kundenprofil im Memberr-Dashboard. |

### Kunden Kontakten zuordnen

Die Zuordnung läuft über die **E-Mail-Adresse** des Kontakts gegen die Kunden-E-Mail in Memberr. Sie muss exakt passen (Groß- und Kleinschreibung zählt nicht).

| Situation | Was du siehst |
| - | - |
| Memberr nicht verbunden | Keine Memberr-Karte |
| Kontakt ohne E-Mail | Keine Memberr-Karte. Ergänze eine E-Mail am Kontakt. |
| E-Mail vorhanden, Kunde in keinem Memberr-Shop | Keine Memberr-Karte |
| Du wechselst zu einem Shop, in dem es den Kunden nicht gibt | **Kein Memberr-Profil für diesen Kunden gefunden** |
| Memberr-Abfrage schlägt fehl | Die Karte landet in der Zeile für Apps, die nicht geladen werden konnten. Klapp sie auf und klick auf **Erneut versuchen**. |

## Guthaben im Posteingang anpassen

Nutze **Hinzufügen** oder **Reduzieren** unter dem Guthaben.

1. Klick auf **Hinzufügen** oder **Reduzieren**.
2. Gib den Betrag ein. Der Dialog zeigt das **Aktuelle Guthaben** und das **Neue Guthaben** nach der Änderung.
3. Bestätige mit **… € hinzufügen** oder **… € reduzieren**.

Die Änderung wird in Memberr als manuelle Guthaben-Buchung gespeichert und erscheint im Verlauf als **Manuelle Anpassung**. Memberr braucht manchmal ein paar Sekunden, bis das neue Guthaben sichtbar ist. Bis dahin bleiben die Schaltflächen deaktiviert.

<Warning>
  Eine Guthaben-Änderung ändert das echte Guthaben des Kunden in Memberr. Hinzugefügtes Guthaben kann sofort im Shop ausgegeben werden. Es gibt keinen Rückgängig-Button: Um einen Fehler zu korrigieren, buchst du die Gegenrichtung (**Reduzieren** nach falschem **Hinzufügen**, oder **Hinzufügen** nach falschem **Reduzieren**). Beide Buchungen bleiben im Verlauf.
</Warning>

Gut zu wissen:

* Der Betrag muss mindestens 0,01 sein. Chatarmin CX setzt keine Obergrenze.
* Der Dialog hat kein Feld für einen Grund oder eine Notiz. Halte den Grund in einer internen Notiz am Ticket fest.
* Chatarmin CX verhindert nicht, dass du mehr reduzierst, als der Kunde Guthaben hat. Prüf das **Neue Guthaben**, bevor du bestätigst.
* Die Buchung nutzt die Währung des bestehenden Guthabens, oder EUR, wenn der Kunde noch keins hat.
* Chatarmin CX findet den Memberr-Kunden immer über die E-Mail des Ticket-Kontakts. Du kannst also nur das Guthaben dieses Kunden ändern.

## KI-Agenten-Aktionen

Aktiviere Memberr-Aktionen auf einem [KI-Agenten](/de/ai-agents/skills-and-actions), wenn Automatisierung Guthaben- und Stufenfragen beantworten oder bei Tickets wie verspäteten Lieferungen Guthaben gutschreiben soll.

Verbinde Memberr zuerst, aktiviere dann die Aktionen am Agenten und wähle unter **Memberr integrations**, welche verbundenen Shops der Agent nutzen darf.

### Lese-Aktion

* **Get loyalty profile** — Sucht einen Kunden per E-Mail und liefert aktuelles und kommendes Guthaben, aktive Mitgliedschaft mit Ablaufdatum, Fortschritt zur nächsten Stufe, ob er gesperrt ist, einen Link zum Memberr-Profil und den Guthaben-Verlauf mit dem nächsten Verfallsdatum. Diese Aktion braucht nie eine Freigabe.

### Schreib-Aktion

* **Adjust store credit** — Schreibt einem Kunden Guthaben gut oder zieht es ab. Der Agent muss einen Grund angeben, den die Person sieht, die die Freigabe prüft. Der Grund wird nicht an Memberr gesendet.

| Einstellung | Standard | Was sie macht |
| - | - | - |
| Freigabe | **Immer fragen** | Eine Person gibt jede Anpassung frei, bevor sie ausgeführt wird. Siehe [menschliche Freigabe](/de/ai-agents/human-in-the-loop). |
| **Allow deducting store credit** | Aus | Wenn aus, kann der Agent nur Guthaben hinzufügen. Schalte es nur ein, wenn der Agent Guthaben auch nach unten korrigieren soll. |

In Testläufen wird **Adjust store credit** nur simuliert und ändert kein Guthaben in Memberr.

<Warning>
  **Adjust store credit** bewegt echtes Geld. Lass die Freigabe an, bis du dem Playbook des Agenten vertraust, und schreib in seine Anweisungen, wie viel Guthaben er in welcher Situation anbieten darf. Die Aktion selbst hat keine Betragsgrenze.
</Warning>

<Tip>
  Schreib in die Agenten-Anweisungen, dass der Agent vor jeder Anpassung **Get loyalty profile** mit der E-Mail des Ticket-Kontakts aufruft und bei jedem genannten Guthaben die Währung angibt.
</Tip>

## Best Practices

* Halte die Kontakt-E-Mail mit der E-Mail synchron, die der Kunde in deinem Shop nutzt. Aktualisiere den Kontakt, wenn er von einer anderen Adresse schreibt.
* Setz bei jedem Shop mit Chat-Widget eine **Ticket-Ursprungsdomain**, damit automatisch der richtige Shop öffnet, statt dass ein Agent ihn auswählen muss.
* Gib KI-Anpassungen erst frei, wenn du geprüft hast, dass die E-Mail im Vorschlag zum Kunden im Ticket gehört.
* Lass **Allow deducting store credit** aus, solange der Agent keine doppelten Gutschriften korrigieren muss.
* Schreib eine kurze interne Notiz ans Ticket, wenn du Guthaben von Hand änderst – so weiß dein Team, warum.

## Memberr trennen

Öffne in den [Integrationen](https://armin.cx/app/_/settings/integrations) beim Shop das Menü **Connected**, wähle **Disconnect** und bestätige mit **Delete**. Die Memberr-Karte verschwindet aus den Tickets, und KI-Agenten-Aktionen für diesen Shop funktionieren nicht mehr. Guthaben und Verlauf in Memberr bleiben unverändert.

## Fehlerbehebung

### Die Memberr-Karte erscheint nicht

* Hat der Kontakt eine E-Mail-Adresse, und passt sie zur Kunden-E-Mail in Memberr?
* Gibt es den Kunden in einem Memberr-Shop, den du in diesem Workspace verbunden hast?
* Bei mehreren Shops und einem Widget-Ticket: Passt die **Ticket-Ursprungsdomain** des Shops exakt zur Shop-Domain, ohne `https://` und ohne Pfad?

### Die Karte zeigt „Laden fehlgeschlagen“

* Prüf, ob der **Secret API Key** stimmt und in Memberr noch aktiv ist. Chatarmin CX prüft den Schlüssel beim Speichern nicht, deshalb zeigt sich ein falscher Schlüssel erst hier.
* Trag in den [Integrationen](https://armin.cx/app/_/settings/integrations) einen neuen Schlüssel in die Verbindung ein und klick dann auf der Karte auf **Erneut versuchen**.

### Eine Guthaben-Anpassung schlägt fehl

* **No Memberr customer found for this contact**: Die E-Mail des Kontakts passt zu keinem Memberr-Kunden mehr. Prüf die E-Mail in Memberr und am Kontakt.
* **Memberr store-credit adjustment failed: …**: Memberr hat die Anfrage abgelehnt. Der Rest der Meldung kommt von Memberr. Prüf das Guthaben in Memberr, bevor du es erneut versuchst – so buchst du dasselbe Guthaben nicht doppelt.

### Das Guthaben hat sich nach einer Anpassung nicht geändert

Memberr braucht manchmal einige Sekunden. Warte, bis die Schaltflächen wieder aktiv sind, und prüf im **Guthaben-Verlauf** die Buchung **Manuelle Anpassung**, bevor du erneut anpasst.

Hält ein Problem an, wende dich mit der Ticketnummer und der Uhrzeit der fehlgeschlagenen Aktion an den Chatarmin-CX-Support. Schick niemals den Secret API Key mit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.