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

# Sendcloud

> Sieh den Sendungsstatus aus Sendcloud zu den Bestellungen eines Kunden in der Ticket-Seitenleiste und mit KI-Agenten.

Die Sendcloud-Integration verbindet dein Sendcloud-Konto mit Chatarmin CX. Agenten sehen direkt im Ticket, wo die Pakete einer Kundin gerade sind, und KI-Agenten können „Wo ist mein Paket?“ mit aktuellen Tracking-Daten beantworten – über alle Carrier hinweg, mit denen du über Sendcloud versendest.

> [!NOTE]
>
> Sendcloud 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 ein Paket stornieren oder eine Retoure anlegen – aber nur, wenn du ihm diese Aktionen gibst, und beide fragen vorher nach deiner Freigabe, siehe [Sendcloud in KI-Agenten nutzen](#sendcloud-in-ki-agenten-nutzen).

## Wann du es brauchst

Nutze Sendcloud, wenn du deine Labels in Sendcloud erstellst und dein Team oft Folgendes bearbeitet:

* „Wo ist mein Paket?“ und „Wann kommt es an?“
* „Laut Tracking zugestellt, aber ich habe nichts bekommen“
* Pakete, die nicht zugestellt wurden oder zur Abholung liegen
* Bestellungen mit unterschiedlichen Carriern, für die du sonst jede Carrier-Seite einzeln aufrufen müsstest

## Einrichten

Du brauchst den **Public Key** und den **Secret Key** einer *Sendcloud API*-Integration in deinem eigenen Sendcloud-Panel. Das dauert etwa zwei Minuten und braucht keine Freigabe von Sendcloud.

**1. API-Keys in Sendcloud erstellen**

Öffne im Sendcloud-Panel **Einstellungen → Integrationen**, suche **Sendcloud API** und klicke auf **Verbinden**. Gib ihr einen Namen wie `Chatarmin CX`. Sendcloud erzeugt einen **Public Key** und einen **Secret Key**.

Kopiere beide sofort – den Secret Key zeigt Sendcloud nur einmal an.

**2. Integrationen öffnen**

[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **Sendcloud**.

Wenn Sendcloud nicht in der Liste steht, wende dich an dein Chatarmin-CX-Account-Team, damit es für deinen Workspace freigeschaltet wird.

**3. Sendcloud-Konto verbinden**

Klicke auf **Verbinden**, gib **Public Key** und **Secret Key** ein und speichere. Chatarmin CX prüft die Keys bei Sendcloud, bevor gespeichert wird. Lehnt Sendcloud sie ab, siehst du den Grund und es wird nichts gespeichert.

## Sendcloud im Posteingang nutzen

Wenn Sendcloud verbunden ist, erscheint im Kundenpanel eines Tickets eine **Sendcloud**-Karte. Klappe sie auf, um die Sendungen zu den neuesten Bestellungen des Kontakts zu sehen, neueste zuerst – bis zu fünf Bestellungen und jedes Paket darin.

Pro Paket zeigt die Karte:

* Den aktuellen **Status** und den **Carrier**, der es transportiert
* Die **Sendungsnummer** und einen Link auf die Tracking-Seite des Carriers
* Das **voraussichtliche Zustelldatum**, sofern der Carrier eines nennt
* Den **Sendungsverlauf**, neueste Ereignisse zuerst
* Die **Empfängerdaten** und die **Artikel** im Paket

Die Karte ist an den Kontakt gebunden: Sie nimmt die Bestellungen, die Chatarmin CX zu dieser Kundin bereits kennt, und fragt Sendcloud nach deren Sendungen. Niemand muss eine Bestellnummer eintippen.

> [!NOTE]
>
> Die Karte ist nur so gut wie die Bestellzuordnung. Auf einem Ticket, bei dem Chatarmin CX nicht erkennen kann, welche Bestellungen zum Kontakt gehören – etwa in einer Social-DM –, zeigt sie einen sauberen Leerzustand statt zu raten.

### Empfängerdaten

Name, Adresse, E-Mail-Adresse und Telefonnummer der Empfängerin sowie die Artikel im Paket erscheinen nur bei einem Paket, das zum Kontakt dieses Tickets gehört. Bei jedem anderen Paket zeigt die Karte weiterhin Status, Carrier, Tracking-Link und Verlauf, lässt Empfängerdaten und Artikel aber weg.

Das ist Absicht. Sendungsnummern von Carriern sind weitgehend fortlaufend; ohne diese Regel wäre die Karte eine Möglichkeit, Name, Adresse und Telefonnummer fremder Personen nachzuschlagen.

### Was du siehst

| Situation | Was die Karte zeigt |
| - | - |
| Keine zugeordneten Bestellungen auf diesem Ticket | „Keine Sendcloud-Pakete für diesen Kunden gefunden“ |
| Sendcloud kennt keine Sendung zu diesen Bestellungen | Derselbe Leerzustand – vielleicht wurde noch kein Label erstellt |
| Sendcloud drosselt die Anfragen | „Sendcloud begrenzt derzeit die Anfragen. Versuchen Sie es in Kürze erneut.“ mit **Erneut versuchen** |
| Die API-Keys wurden abgelehnt | „Sendcloud hat die API-Schlüssel dieser Verbindung abgelehnt. Verbinden Sie sie in den Integrationseinstellungen neu.“ |
| Sendcloud ist nicht erreichbar | „Sendcloud-Pakete konnten nicht geladen werden.“ mit **Erneut versuchen** |

Status werden in deiner App-Sprache angezeigt. Fügt Sendcloud einen Status hinzu, den Chatarmin CX noch nicht kennt, zeigt die Karte die Formulierung von Sendcloud statt eines leeren Felds.

## Sendcloud in KI-Agenten nutzen

Füge einem [KI-Agenten](https://docs.armin.cx/de/ai-agents/skills-and-actions.md) Sendcloud-Aktionen hinzu und wähle jeweils die Sendcloud-Verbindung aus, die er nutzen darf. Vier stehen zur Verfügung, und du entscheidest, welche der Agent bekommt:

| Aktion | Was sie tut | Freigabe |
| - | - | - |
| **Sendung verfolgen** | Schlägt eine Bestellnummer nach – oder eine Sendungsnummer, wenn die Bestellnummer unbekannt ist – und antwortet mit Status, Carrier, Tracking-Link, voraussichtlichem Zustelldatum und Verlauf. | Nicht nötig, sie liest nur |
| **Sendcloud-Retourenlink abrufen** | Gibt den Link in dein eigenes Retourenportal für dieses Paket zurück, den der Agent der Kundin schicken kann, damit sie die Retoure selbst startet. | Nicht nötig, sie legt nichts an |
| **Sendcloud-Retoure anlegen** | Legt eine Retoure samt Label für ein bereits erhaltenes Paket an. | **Wird jedes Mal erfragt** (Standard) |
| **Sendcloud-Sendung stornieren** | Storniert ein Paket, das der Carrier noch nicht übernommen hat. | **Wird jedes Mal erfragt** (Standard) |

> [!NOTE]
>
> **Sendcloud-Retoure anlegen** braucht an der Aktion einen **Retouren-Versandoptions-Code**, denn der entscheidet, welchen Carrier du bezahlst. Ohne ihn legt der Agent nichts an: Er bricht ab und nennt die Codes, die dein Konto anbietet, damit du den richtigen eintragen kannst. Die kostenlose Option `sendcloud:letterreturn` eignet sich zum Testen.

> [!WARNING]
>
> Carrier lehnen eine Stornierung ab, sobald ein Paket manifestiert ist, und Sendcloud weist darauf hin, dass ein zuvor storniertes und dann doch versendetes Paket seinen Versicherungsschutz verliert. Ein bereits zugestelltes, abgeholtes oder zurückgesendetes Paket storniert der Agent nicht – er sagt es stattdessen.

Drei Grenzen sind fest eingebaut und lassen sich nicht wegkonfigurieren:

* Ein Agent sieht und bearbeitet ausschließlich Sendungen der Kundin aus dem Gespräch, das er gerade beantwortet. Ein Paket einer anderen Person liest sich für ihn wie gar kein Paket, und keine Schreibaktion kann es anfassen.
* Ein Agent sieht nie Empfängerdaten oder Artikelzeilen – auch nicht beim Paket der eigenen Kundin. Er bekommt Status, Carrier, Tracking-Link, Daten und Verlauf.
* In einem Testlauf erreicht keine Schreibaktion Sendcloud; sie wird simuliert.

> [!TIP]
>
> Bevorzuge **Sendcloud-Retourenlink abrufen** gegenüber **Sendcloud-Retoure anlegen**, sofern der Agent nicht wirklich Labels auf deinem Konto erzeugen soll: Die Frage der Kundin ist damit genauso beantwortet, und es entsteht nichts.

## Daten und Zugriff

Pro Abfrage sendet Chatarmin CX an Sendcloud nur eine Bestellnummer oder eine Sendungsnummer. Public Key und Secret Key werden verschlüsselt gespeichert.

Nach Sendcloud wird nichts geschrieben, solange du einem KI-Agenten nicht die Aktion **Sendcloud-Retoure anlegen** oder **Sendcloud-Sendung stornieren** gibst. Das sind die einzigen beiden Schreibvorgänge dieser Integration; beide sind standardmäßig freigabepflichtig, und jeder wird am Lauf protokolliert – mit Paket und Aktion, nie mit Kundendaten.

## Sendcloud ändern oder trennen

Um eine Verbindung zu ändern, klicke sie in den [Integrationen](https://armin.cx/app/_/settings/integrations) an. Lass **Secret Key** leer, um den gespeicherten Key zu behalten.

Zum Trennen öffnest du im Menü **Verbunden** den Punkt **Trennen** und bestätigst mit **Löschen**. Die Sendcloud-Karte verschwindet aus den Tickets, und alle KI-Agenten-Aktionen, die diese Verbindung nutzen, funktionieren nicht mehr. An deinen Sendungen und deinem Sendcloud-Konto ändert sich nichts.

## Fehlerbehebung

### Die Verbindung lässt sich nicht speichern

* Prüfe, ob **Public Key** und **Secret Key** vollständig und ohne Leerzeichen kopiert wurden.
* Stelle sicher, dass beide aus derselben *Sendcloud API*-Integration in deinem Sendcloud-Panel stammen.
* Ist der Secret Key verloren, lege in Sendcloud eine neue *Sendcloud API*-Integration an und verwende das neue Paar.

### Die Verbindung verlangt ein erneutes Verbinden

Wird die *Sendcloud API*-Integration im Sendcloud-Panel gelöscht, verliert ihr Key-Paar die Gültigkeit. Lege eine neue an und trage die neuen Keys bei der Verbindung ein.

### Die Karte ist auf den meisten Tickets leer

Die Karte muss wissen, welche Bestellungen zum Kontakt gehören. Wo diese Zuordnung fehlt, bleibt sie leer – am häufigsten bei Social-DMs und bei Bestellungen aus einem Shop, der nicht mit Chatarmin CX verbunden ist.

### Bei einem Paket fehlen Empfängerdaten und Artikel

Dieses Paket gehört – soweit Chatarmin CX das erkennen kann – nicht zum Kontakt des Tickets. Das ist so vorgesehen, siehe [Empfängerdaten](#empf%C3%A4ngerdaten).

Hilft nichts davon, wende dich an den Chatarmin-CX-Support. Nenne den Ticket-Link und den Zeitpunkt der Abfrage, aber nicht deinen Secret Key.


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