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

# Hive

> Zeige Hive-Fulfillment-Bestellungen im Posteingang und lass KI-Agenten Bestellungen nachschlagen, pausieren, stornieren und aktualisieren.

Die Hive-Integration verbindet Chatarmin CX mit deinem Hive-Lager, damit Agenten und KI-Agenten Fulfillment-Status sehen, Bestellungen vor dem Picking pausieren und WISMO- sowie Adressänderungs-Tickets bearbeiten können — ohne den Posteingang zu verlassen.

## Wann du es nutzt

Nutze Hive in Chatarmin CX, wenn:

* du über Hive fulfilst und Kunden fragen, wo ihre Bestellung ist, stornieren wollen oder die Lieferadresse korrigieren müssen
* Agenten Hive-Bestellstatus, Tracking und Hold-Steuerung neben dem Ticket-Gespräch brauchen
* KI-Agenten Bestellungen per E-Mail nachschlagen, Sendungen prüfen und Hold-, Storno- oder Adressänderungen mit Freigabe vorschlagen sollen

<Note>
  Hive-Bestellungen im Posteingang werden über **Shopify** aufgelöst. Verbinde [Shopify](/de/integrations/shopify) im selben Workspace, damit cx Kundenbestellungen über die Shopify-Merchant-Order-ID mit Hive verknüpft.
</Note>

## Einrichten

Du brauchst einen Hive-API-Key aus deinem Hive-Konto. Shopify muss im selben Workspace verbunden sein — für die Bestellanzeige im Posteingang und für die Aktion **Bestellungen für Kunden abrufen**.

<Steps>
  <Step title="Shopify verbinden">
    [Verbinde Shopify](https://armin.cx/app/_/settings/integrations) im selben Workspace. Siehe [Shopify](/de/integrations/shopify). Hive verknüpft Bestellungen über `merchant_order_id`.
  </Step>

  <Step title="Integrationen öffnen">
    Geh zu [Integrationen](https://armin.cx/app/_/settings/integrations) und wähle **Hive**.
  </Step>

  <Step title="Hive verbinden">
    Klick auf **Verbinden**, gib einen Anzeige-**Namen** für das Konto ein und füge deinen **API-Key** aus Hive ein. Speichere die Verbindung.
  </Step>

  <Step title="KI-Agenten-Aktionen aktivieren">
    Öffne in [KI-Agenten](https://armin.cx/app/_/ai/agents-v2) die Agenten für Bestell-Tickets und aktiviere die benötigten Hive-Aktionen. Schreibaktionen bis zu sicheren Testläufen auf Freigabe stellen.
  </Step>
</Steps>

<Tip>
  Du kannst mehrere Hive-Konten pro Workspace verbinden. Nutze einen klaren Anzeigenamen bei mehreren Shops oder Marken.
</Tip>

## Hive im Posteingang nutzen

Passt ein Ticket-Kontakt zu einem Kunden mit Shopify-Bestellungen, die mit Hive verknüpft sind, zeigt das Kundenpanel Hive-Bestellungen mit Fulfillment-Status, Shop und Positionen.

<Steps>
  <Step title="Ticket öffnen">
    Öffne das Ticket des Kunden, der zur Bestellung geschrieben hat.
  </Step>

  <Step title="Hive-Bestellungen prüfen">
    Im Integrationsbereich klappst du Hive auf. Jede Bestellung zeigt Bestellnummer, Status-Badge, Shop, Summe und Lieferadresse.
  </Step>

  <Step title="Hold setzen oder aufheben">
    Bei Status **waiting for picking** nutzt du **Put on Hold**, um Fulfillment zu pausieren. Ist die Bestellung on hold, nutzt du **Release Hold** zum Fortsetzen. Hold und Release taggen die verknüpfte Shopify-Bestellung mit `cx-on-hold` — der Inbox-Button ruft keine separate Hive-Hold-API auf.
  </Step>

  <Step title="Lieferadresse bearbeiten">
    Nutze **Edit address**, solange die Bestellung nicht terminal ist (nicht shipped, cancelled oder ignored). Änderungen gehen über die verbundene Integration an Hive.
  </Step>

  <Step title="In Hive öffnen">
    Klick auf die Bestellnummer, um die Bestellung im Hive-Merchant-Portal zu öffnen, wenn ein Portal-Link verfügbar ist.
  </Step>
</Steps>

### Fulfillment-Status für Agenten

| Status                                  | Bedeutung für Agenten                                        |
| --------------------------------------- | ------------------------------------------------------------ |
| **waiting for picking**                 | Bestellung kann im Posteingang noch on hold gesetzt werden   |
| **on hold** / Tag `cx-on-hold`          | Fulfillment pausiert — Release, wenn der Kunde bestätigt     |
| **shipped**, **cancelled**, **ignored** | Terminal — Hold, Release und Adressbearbeitung nicht möglich |

## KI-Agenten-Aktionen

Gib Bestell-KI-Agenten Hive-Aktionen, damit sie im Ticket arbeiten können. Für neue Automation empfiehlt sich **KI-Agenten**; Legacy-**Workflows** können dieselben Hive-Nodes für feste Abläufe nutzen.

### Lese-Aktionen

| Aktion                                   | Zweck                                                                                   |
| ---------------------------------------- | --------------------------------------------------------------------------------------- |
| **Hive-Bestellung abrufen**              | Eine Bestellung per ID nachschlagen                                                     |
| **Hive-Bestellungen für Kunden abrufen** | Letzte Bestellungen per E-Mail oder Telefon (WISMO) — Shopify im selben Workspace nötig |
| **Hive-Sendungen abrufen**               | Sendungen mit Tracking, Lieferstatus und Positionen zu einer Bestellung                 |

### Schreib-Aktionen (Freigabe empfohlen)

| Aktion                                                         | Zweck                                                                           |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Hive-Bestellung holden / freigeben** (`hive_set_order_hold`) | `hold: true` pausiert Picking, `hold: false` gibt frei. Bevorzugte Hold-Aktion. |
| **Hive-Bestellung stornieren**                                 | Bestellung stornieren, die noch nicht versendet wurde                           |
| **Hive-Lieferadresse aktualisieren**                           | Lieferdaten vor Versand korrigieren                                             |

<Warning>
  Für **Hold / Release** und **Lieferadresse aktualisieren** übergib die Shopify-**legacyResourceId** aus **Shopify-Bestellung abrufen** — nicht die Hive-interne ID oder den Shopify-Bestellnamen. Hold-Aktionen taggen Shopify; eine verbundene Shopify-Integration ist nötig.
</Warning>

### Bestell-ID-Formate

Für **Bestellung abrufen**, **Stornieren** und **Sendungen abrufen** akzeptiert cx:

* Hive-interne ID (z. B. `4829103`)
* Shopify `legacyResourceId` (z. B. `11592011448585`)
* Shopify-GID (z. B. `gid://shopify/Order/11592011448585`)
* Shopify-Bestellname (z. B. `DE13778080`)

### Veraltete Hold-Aktionen

`hive_hold_order` und `hive_release_order` existieren noch für ältere Workflows. Nutze stattdessen **`hive_set_order_hold`** mit `hold: true` oder `hold: false` — eine Aktion für beide Richtungen.

<Steps>
  <Step title="Hive und Shopify verbinden">
    Schließe die Einrichtung oben im selben Workspace ab.
  </Step>

  <Step title="Aktionen am Agenten aktivieren">
    Aktiviere in [KI-Agenten](https://armin.cx/app/_/ai/agents-v2) Lese-Aktionen für Lookup und Schreib-Aktionen für Storno, Hold und Adressänderung. Wähle, welche Hive-Konten der Agent nutzen darf.
  </Step>

  <Step title="Freigaben setzen">
    Lass **Hive-Bestellung stornieren**, **Hold / Release** und **Lieferadresse aktualisieren** auf **Immer Freigabe erforderlich**, bis du den Produktionsbetrieb vertraust.
  </Step>

  <Step title="Anweisungen ergänzen">
    Weise den Agenten an, zuerst **Hive-Bestellungen für Kunden** oder **Shopify-Bestellung abrufen** zu nutzen, bei Tracking **Hive-Sendungen abrufen** aufzurufen und zu erklären, wenn die Bestellung schon versendet oder storniert ist. Für Holds die Shopify-legacy-ID aus **Shopify-Bestellung abrufen** verwenden.
  </Step>
</Steps>

## Best practices

* Verbinde Shopify vor Hive, damit Posteingang-Bestellungen und WISMO-Lookups stimmen
* Schreibaktionen auf Freigabe, bis Test-Tickets sicher aussehen
* Nutze **Hold / Release** (`hive_set_order_hold`) statt der veralteten Hold- und Release-Aktionen
* Pausiere Bestellungen nur, solange der Kunde eine Änderung bestätigt — danach Release
* Agenten und KI sollen eskalieren, wenn die Bestellung schon shipped, cancelled oder ignored ist
* Achte bei stark frequentierten Shops auf Hive-API-Rate-Limits; bei wiederholten Fehlern retry oder Eskalation
* Bei Multi-Store-Setups klare Hive-Anzeigenamen nutzen, damit die richtige Integration gewählt wird

## FAQ

**Brauche ich Shopify, wenn ich nur Hive nutze?**\
Ja, für die Bestellanzeige im Posteingang und **Bestellungen für Kunden abrufen**. Hive-Bestellungen werden über Shopify-Merchant-Order-IDs im selben Workspace gematcht.

**Warum taggt Hold im Posteingang Shopify?**\
Der Inbox-Hold-Button taggt die verknüpfte Shopify-Bestellung mit `cx-on-hold`. So pausiert cx Fulfillment für Agenten in der UI. KI-Agenten-Hold-Aktionen nutzen denselben Shopify-Pfad.

**Wann können Agenten eine Bestellung on hold setzen?**\
Wenn der Fulfillment-Status **waiting for picking** ist und die Bestellung nicht schon shipped, cancelled oder ignored ist.

**Welche Bestell-ID sollen KI-Agenten für Hold und Adressänderung nutzen?**\
Die numerische Shopify-**legacyResourceId** aus **Shopify-Bestellung abrufen**. Nicht die Hive-interne ID aus einer Hive-Antwort für diese Schreibaktionen.

**Was tun bei Hive-Rate-Limit-Fehlern?**\
Warten und erneut versuchen oder die Aktion manuell in Hive erledigen. Starke Automation auf einem Shop kann Hive-API-Limits auslösen.

**Kann ich weiter Workflows nutzen?**\
Ja. Legacy-Workflows können Hive-Nodes für feste Abläufe aufrufen. Für neue Automation nutze KI-Agenten und die Aktionen oben.