Zum Hauptinhalt springen
Die Unzer-Integration verbindet dein Unzer-Konto mit Chatarmin CX. Hat eine Kundin per Rechnungskauf oder Ratenkauf bezahlt, sieht dein Team die Zahlung zur Bestellung direkt im Ticket – inklusive Bankverbindung und Verwendungszweck – statt dafür das Unzer Merchant Portal in einem zweiten Tab zu öffnen.
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
Das gezeigte Konto gehört Unzer, nicht der Kundin. Es ist dasselbe Konto, das auf ihrer Rechnung steht.

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.
Unzer erlaubt eine Verzögerung pro Zahlung und lehnt eine zweite ab. Der Agent prüft das vor dem Schreiben und sagt dir, wenn bereits eine genutzt wurde, statt vor der Kundin zu scheitern.
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.
Schreib deinem Agenten in die Instruktionen, dass „eingezogen“ nicht „bezahlt“ heißt. Die Aktion sagt es ihm auch – aber deine Formulierung ist die, die bei der Kundin ankommt.

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- oder s-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.

Die Verbindung verlangt eine Neuverbindung

Wird der Key in Unzer Insights rotiert oder gelöscht, ist er ungültig. Kopiere den neuen Private Key und trage ihn in der Verbindung ein.

Die Karte zeigt eine Zahlung, die Kundin sagt, sie habe bezahlt

Das ist erwartbar – siehe Was die Karte sagt, und was nicht. Die Überweisung der Kundin meldet Unzer hier nicht. Prüfe Unzer Insights oder deine Abstimmungsdatei, bevor du einer Kundin sagst, ihre Rechnung sei abgeschlossen.

Der Agent findet die Zahlung nicht

Der Agent braucht die Referenz aus der Shopify-Bestellung. Prüfe, ob die Shopify-Aktion Bestellung lesen auf demselben Agenten aktiv ist und ob die Bestellung tatsächlich über Unzer bezahlt wurde – Bestellungen per Karte oder PayPal tragen keine Unzer-Referenz. Hilft das alles nicht, wende dich an den Chatarmin-CX-Support. Nenne den Ticket-Link und die Unzer-Payment-ID, niemals deinen Private Key.