Skip to main content
Die 8returns-Integration bringt Retourenstatus, zurückgesendete Artikel und Versanddetails in Chatarmin CX. So beantwortet dein Team Retourenfragen direkt im Ticket. KI-Agenten können außerdem eine Retoure anmelden und ein Versandlabel mit Sendungsnummer anfordern.

​
Wann du es brauchst

Nutze 8returns, um Fragen wie „Was passiert gerade mit meiner Retoure?“ zu beantworten oder die Artikel anzumelden, die ein Kunde zurücksenden möchte. Dein Team sieht bestehende Retouren im Posteingang; neue Retouren meldest du über KI-Agenten-Aktionen an.

​
8returns einrichten

Du brauchst den API Key und das Password deiner 8returns-API-Verbindung. Die Integration verlinkt auf die 8returns-Seite für die öffentliche API.
1

Integrationen öffnen

Öffne Integrationen in deinen Workspace-Einstellungen und wähle 8returns.Wenn 8returns nicht in der Liste steht, frag dein Chatarmin-CX-Team nach der Verfügbarkeit für deinen Workspace.
2

Konto verbinden

Klick auf Connect, um das Formular zu öffnen. Gib API Key und Password ein und klick zum Speichern auf Connect. cx prüft die Zugangsdaten bei 8returns, bevor die Verbindung gespeichert wird. Nach erfolgreicher Verbindung siehst du Connected.
3

Eine bestehende Retoure prüfen

Öffne ein Ticket, dessen Kontakt die E-Mail-Adresse einer bestehenden 8returns-Retoure hat. Klappe die 8returns-Karte im Kundenpanel auf und prüfe Bestellnummer und Retourenstatus. Diese Abfrage erstellt oder ändert keine Retoure.

​
8returns im Posteingang nutzen

cx sucht Retouren über die E-Mail-Adresse des Ticket-Kontakts. Klappe die verbundene 8returns-Karte im Kundenpanel auf. Du siehst:
  • Bestellnummer und Retourenstatus
  • Artikelnamen und Mengen sowie Retourengründe, wenn vorhanden
  • Versanddienstleister und Sendungsnummer, wenn 8returns sie liefert
Wenn eine Label-URL vorhanden ist, öffnet ein Klick auf die Sendungsnummer das Versandlabel, nicht die Sendungsverfolgung des Versanddienstleisters. Auch Retouren ohne Tracking-Daten zeigen Status und Artikel. Die Karte zeigt zunächst drei Retouren; über die Schaltfläche darunter blendest du weitere Ergebnisse ein.
Die Karte im Posteingang ist schreibgeschützt. Sie hat keine Schaltfläche zum Anmelden einer Retoure oder Erstellen eines Labels. Nutze dafür die KI-Agenten-Aktion unten.

​
KI-Agenten-Aktionen

Verbinde zuerst 8returns. Öffne dann KI-Agenten, wähle deinen Agenten und aktiviere die passenden Aktionen. Wähle die verbundenen 8returns-Konten aus, die der Agent nutzen darf.

​
Get 8returns return

Diese Lese-Aktion sucht Retouren per Bestellnummer oder Kunden-E-Mail. Sie liefert Status, Artikel und verfügbare Versanddetails wie Sendungsnummer, Versanddienstleister und Label-URL. Sie braucht keine menschliche Freigabe. Nutze die Bestellnummer, wenn der Kunde sie nennt. Ansonsten reicht seine E-Mail, statt nur für die Retourensuche nach einer Bestellnummer zu fragen. Sind beide angegeben, nutzt die Suche die Bestellnummer. Die Abfrage verwendet die ersten 50 Suchergebnisse von 8returns, neueste zuerst, und behält exakte Treffer für Bestellnummer oder E-Mail. Sie ist kein vollständiger Export der Retourenhistorie.

​
Create 8returns return

Diese Aktion meldet eine Retoure in 8returns an. Dafür braucht sie:
  • die Bestellnummer des Shops
  • jeden Artikel, den der Kunde zurücksenden möchte, mit SKU und Menge
  • eine ausdrückliche Entscheidung, ob ein Versandlabel erstellt werden soll
Übergib die vollständige gewünschte Artikelliste in einem Aufruf. Die Aktion warnt: Gibt es bereits eine offene Retoure zur Bestellung, werden nicht mitgesendete Artikel als fehlend markiert.
Um im selben Aufruf ein Label mit Sendungsnummer anzufordern, hinterlege die Methoden-ID aus deinem 8returns-Dashboard im Feld Return method ID der Aktion. Beschreibe in den Agenten-Anweisungen, wann ein Label angefordert werden soll. Die Aktion fordert es mit generateLabel: true an. Für eine Retoure ohne Label nutzt du generateLabel: false. Dafür kann Return method ID leer bleiben. Fordert der Agent ohne konfigurierte Methoden-ID ein Label an, schlägt die Aktion vor der Retourenanmeldung fehl. Sie meldet nicht stillschweigend eine Retoure ohne Label an. Create 8returns return verlangt standardmäßig eine menschliche Freigabe. Du kannst die Freigabe an der Aktion anpassen. Lass sie aktiviert, solange du deinen Retourenprozess prüfst.
Die Aktion zeigt keinen Labelpreis an und zieht beim Kunden kein Rückporto ein. Geh nicht davon aus, dass Labels kostenlos sind. Kläre die Labelkosten separat und gib dem Agenten klare Anweisungen, wer zahlt und wann er ein Label anfordern darf.

​
Ergebnis vor der Antwort prüfen

Eine Retoure kann angemeldet sein, obwohl die Labelanforderung fehlgeschlagen ist. Prüfe die Artikel- und Labelergebnisse, bevor du dem Kunden bestätigst, dass seine Retoure oder sein Label bereit ist. Ein erfolgreiches Labelergebnis enthält Sendungsnummer und Versanddienstleister. Eine Label-URL ist nur vorhanden, wenn 8returns sie liefert. Die Aktion unterdrückt die automatische Kundenbenachrichtigung von 8returns. Die Retourenanmeldung verschickt also kein Label per E-Mail an den Kunden. Aktiviere eine Antwort-Aktion und beschreibe, wie der Agent das bestätigte Ergebnis mitteilen soll. Fehlt ein nutzbares Label, kann er das Ticket an dein Team übergeben.

​
Best Practices

  • Gib dem Agenten deine Retourenrichtlinie und Eskalationsregeln. Die Aktion prüft selbst keine Rückgabefrist und erstattet kein Geld.
  • Prüfe Bestellnummer, SKUs, Mengen und die vollständige Artikelliste, bevor du eine Retoure freigibst.
  • Nutze Get 8returns return für eine reine Leseprüfung, bevor du Schreib-Aktionen aktivierst. Erstelle keine echte Retoure nur zum Testen der Verbindung.
  • Schlägt die Labelerstellung nach der Anmeldung fehl, prüfe die bestehende Retoure in 8returns vor einem erneuten Versuch. Geh nicht davon aus, dass keine Retoure existiert.

​
8returns trennen

Öffne in den Integrationen das Connected-Menü des Kontos. Wähle Disconnect und bestätige Delete, um die Verbindung zu entfernen. Das storniert keine bestehende Retoure in 8returns.

​
Fehlerbehebung

​
Verbindung schlägt fehl

Prüfe beide API-Zugangsdaten. Wird die Anmeldung abgelehnt, meldet cx: “We couldn’t connect to 8returns. Please check your API Key and Password.”

​
Eine Retoure erscheint nicht

Prüfe, ob die E-Mail des Ticket-Kontakts zur Kunden-E-Mail der Retoure passt und ob du das richtige 8returns-Konto verbunden hast. Nutze die KI-Abfrage per Bestellnummer, um eine bestimmte Bestellung zu prüfen. Im Posteingang ist ohne Kontakt-E-Mail keine Suche möglich.

​
Ein Label fehlt

Prüfe, ob der Agent ein Label angefordert hat und ob Return method ID konfiguriert ist. Schau dir das Aktionsergebnis an: Die Retoure kann trotz fehlgeschlagenem Label existieren. Eine Sendungsnummer garantiert außerdem keine Label-URL. Schlägt die Verbindung oder Aktion weiterhin fehl, wende dich mit der Fehlermeldung und dem betroffenen Schritt an dein Chatarmin-CX-Team. Teile dabei weder API Key noch Password.