Unzer erscheint im Kundenpanel eines Tickets. Die Integration erzeugt keine Tickets und sendet keine Benachrichtigungen. Die Karte selbst liest ausschließlich. Ein KI-Agent kann zusätzlich das Mahnwesen einmalig verzögern – aber nur, wenn du ihm diese Aktion gibst, und er fragt vorher nach deiner Freigabe, siehe Unzer in KI-Agenten nutzen.
Wann du es brauchst
Nutze Unzer, wenn du über Unzer auf Rechnung oder in Raten verkaufst und dein Team oft Folgendes bearbeitet:- „Ist meine Rechnung angekommen?“ und „Auf welches Konto zahle ich?“
- „Welchen Verwendungszweck gebe ich an?“
- „Ich kann vor dem Gehalt nicht zahlen – könnt ihr die Mahnungen stoppen?“
- Rückfragen zu Retouren und Erstattungen, für die jemand wissen muss, was tatsächlich eingezogen wurde
Was die Karte sagt, und was nicht
Die Unzer-API meldet, was dein Shop eingezogen hat, nicht ob die Kundin bezahlt hat. Es gibt dort weder ein Fälligkeitsdatum noch eine Kennzeichnung „ausgeglichen“. Deshalb zeigt die Karte „Charged“ (eingezogen) und „Left to charge“ (noch einzuziehen) – nie „Paid“. „Eingezogen 59,90 €, noch einzuziehen 0,00 €“ heißt: Unzer hat die Rechnung für dich eingezogen. Die Überweisung der Kundin kann trotzdem noch unterwegs sein. Ob tatsächlich gezahlt wurde, steht in Unzer Insights und in den Abstimmungsdateien von Unzer, nicht auf dieser Karte.Einrichten
Du brauchst den Private Key deines Unzer-Kontos. Wenn du über Unzer abrechnest, hast du ihn bereits – er steht in Unzer Insights bei deinen API-Keys. Das Verbinden dauert etwa zwei Minuten und braucht keine Freigabe von Unzer.1
Private Key in Unzer kopieren
Öffne in Unzer Insights deine API-Keys und kopiere den Private Key. Er beginnt mit
p-priv- für dein Live-Konto oder mit s-priv- für ein Sandbox-Konto.Der Public Key (p-pub-/s-pub-) ist für Checkout-Seiten und funktioniert hier nicht.2
Integrationen öffnen
Öffne die Integrationen in deinen Workspace-Einstellungen und wähle Unzer.Wird Unzer nicht angezeigt, wende dich an dein Chatarmin-CX-Team, damit es für deinen Workspace freigeschaltet wird.
3
Unzer-Konto verbinden
Klicke Connect, füge den Private Key ein und speichere. Chatarmin CX prüft ihn vorher bei Unzer. Lehnt Unzer ihn ab, siehst du den Grund und es wird nichts gespeichert.Eine Umgebung wählst du nicht aus: Der Key sagt selbst, wohin er gehört – ein Sandbox-Key spricht immer mit der Sandbox.
Unzer im Posteingang nutzen
Ist Unzer verbunden, erscheint im Kundenpanel eines Tickets eine Unzer-Karte. Aufgeklappt zeigt sie die Zahlungen zu den jüngsten Bestellungen des Kontakts, neueste zuerst – bis zu drei. Pro Zahlung zeigt die Karte:- Den Status von Unzer: „Charged“, „Partly charged“, „Pending“, „Canceled“, „In review“ oder „Chargeback“
- Den Gesamtbetrag, den eingezogenen Betrag („Charged“), den Betrag, der noch einzuziehen ist („Left to charge“), sowie stornierte oder erstattete Beträge („Cancelled or refunded“)
- Die Bankverbindung für die Überweisung: IBAN, Kontoinhaber und den Verwendungszweck – beide mit einem Klick kopierbar
- „Dunning delayed“, wenn die eine Verzögerung, die Unzer erlaubt, bereits genutzt wurde
- Die Payment-ID von Unzer, damit du sie dem Unzer-Support nennen kannst
Wenn die Karte nichts zeigt
Die Texte der Unzer-Karte sind vorerst nur auf Englisch verfügbar; die Übersetzung folgt. Unten stehen sie daher im Original.
Die Karte muss wissen, welche Bestellungen zum Kontakt gehören, und die Unzer-Referenz steht auf der Shopify-Bestellung. Fehlt diese Verknüpfung, bleibt die Karte leer – meist bei Social-DMs und bei Bestellungen aus einem Shop, der nicht mit Chatarmin CX verbunden ist.
Unzer in KI-Agenten nutzen
Gib einem KI-Agenten Unzer-Aktionen und wähle die Unzer-Verbindung, die er nutzen darf. Es gibt zwei, und du entscheidest, welche er bekommt:
Aktiviere Unzer-Zahlung lesen zusammen mit deiner Shopify-Aktion Bestellung lesen. Der Agent nimmt die Unzer-Referenz aus der gerade gelesenen Bestellung; einen anderen Weg zur Zahlung hat er nicht.
Drei Grenzen sind fest eingebaut:
- Chatarmin CX prüft jede Zahlungsreferenz gegen die Bestellungen des Ticket-Kontakts, bevor Unzer überhaupt aufgerufen wird. Eine Referenz von woanders wird abgelehnt – beim Lesen, beim Schreiben und auch nach deiner Freigabe.
- Geht die Antwort auf eine Verzögerung verloren – Timeout, Störung –, meldet der Agent das als unklares Ergebnis statt als schlichten Fehlschlag und liest die Zahlung erneut, bevor er es noch einmal versucht; ein zweiter Versuch würde abgelehnt.
- In einem Testlauf erreicht kein Schreibvorgang Unzer; er wird simuliert.
Daten und Zugriff
Pro Abfrage sendet Chatarmin CX nur die auf der Bestellung hinterlegte Zahlungsreferenz an Unzer. Dein Private Key wird verschlüsselt gespeichert und nach dem Speichern nie wieder angezeigt. Nach Unzer geschrieben wird nur, wenn du einem KI-Agenten die Aktion Unzer-Mahnwesen verzögern gibst. Das ist der einzige Schreibvorgang dieser Integration; er ist standardmäßig freigabepflichtig und wird im Lauf mit der betroffenen Zahlung protokolliert – nie mit Kundendaten.Ein Unzer Private Key ist nicht auf Lesen beschränkt: Es ist derselbe Key, der einziehen und erstatten kann. Chatarmin CX authentifiziert sich, liest eine Zahlung samt Transaktion und führt den einen Schreibvorgang „Mahnwesen verzögern“ aus – mehr nicht. Behandle den Key trotzdem wie jedes Zahlungs-Credential und rotiere ihn in Unzer Insights, falls er je offenliegt.
Unzer ändern oder trennen
Zum Ändern klickst du die Verbindung in den Integrationen an. Lass Private Key leer, um den gespeicherten zu behalten. Zum Trennen öffnest du im Menü Connected der Verbindung Disconnect und bestätigst mit Delete. Die Unzer-Karte verschwindet aus den Tickets, und KI-Agenten-Aktionen auf dieser Verbindung funktionieren nicht mehr. An deinen Zahlungen und deinem Unzer-Konto ändert sich nichts.Fehlerbehebung
Die Verbindung lässt sich nicht speichern
- Prüfe, ob der Key vollständig und ohne Leerzeichen kopiert wurde.
- Stelle sicher, dass es der Private Key ist (
p-priv-oders-priv-), nicht der Public Key. - Meldet Unzer, dass es nicht erreichbar ist, statt den Key abzulehnen, ist das eine Störung bei Unzer. Versuche es gleich noch einmal; gespeichert wurde nichts.