Skip to main content
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
Hive-Bestellungen im Posteingang werden über Shopify aufgelöst. Verbinde Shopify im selben Workspace, damit cx Kundenbestellungen über die Shopify-Merchant-Order-ID mit Hive verknüpft.

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

Shopify verbinden

Verbinde Shopify im selben Workspace. Siehe Shopify. Hive verknüpft Bestellungen über merchant_order_id.
2

Integrationen öffnen

Geh zu Integrationen und wähle Hive.
3

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

KI-Agenten-Aktionen aktivieren

Öffne in KI-Agenten die Agenten für Bestell-Tickets und aktiviere die benötigten Hive-Aktionen. Schreibaktionen bis zu sicheren Testläufen auf Freigabe stellen.
Du kannst mehrere Hive-Konten pro Workspace verbinden. Nutze einen klaren Anzeigenamen bei mehreren Shops oder Marken.

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

Ticket öffnen

Öffne das Ticket des Kunden, der zur Bestellung geschrieben hat.
2

Hive-Bestellungen prüfen

Im Integrationsbereich klappst du Hive auf. Jede Bestellung zeigt Bestellnummer, Status-Badge, Shop, Summe und Lieferadresse.
3

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

Lieferadresse bearbeiten

Nutze Edit address, solange die Bestellung nicht terminal ist (nicht shipped, cancelled oder ignored). Änderungen gehen über die verbundene Integration an Hive.
5

In Hive öffnen

Klick auf die Bestellnummer, um die Bestellung im Hive-Merchant-Portal zu öffnen, wenn ein Portal-Link verfügbar ist.

Fulfillment-Status für Agenten

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

Schreib-Aktionen (Freigabe empfohlen)

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.

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

Hive und Shopify verbinden

Schließe die Einrichtung oben im selben Workspace ab.
2

Aktionen am Agenten aktivieren

Aktiviere in KI-Agenten Lese-Aktionen für Lookup und Schreib-Aktionen für Storno, Hold und Adressänderung. Wähle, welche Hive-Konten der Agent nutzen darf.
3

Freigaben setzen

Lass Hive-Bestellung stornieren, Hold / Release und Lieferadresse aktualisieren auf Immer Freigabe erforderlich, bis du den Produktionsbetrieb vertraust.
4

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.

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.