Laravel
Die Laravel-Shop-Integration zeigt Kunden- und Bestelldaten aus einem individuellen Laravel-Backend direkt im armincx Inbox-Widget an. Agenten können Bestellungen einsehen und Aktionen ausführen, ohne die Inbox zu verlassen.
Wann wird das verwendet?
Diese Integration ist für Shops geeignet, die nicht auf Shopify oder einer anderen nativen Plattform laufen, sondern auf einem eigenen Laravel-Backend. Armincx verbindet sich über eine REST API mit dem Shop-System (Bearer-Token-Authentifizierung).
Voraussetzungen
Euer Backend-Team hat die erforderlichen API-Endpunkte implementiert (GET /customers, GET /orders, optional: POST /orders/{id}/cancel und POST /orders/{id}/refund)
Ein API-Token wurde erstellt und an das armincx-Team übergeben
Die Integration wurde seitens armincx konfiguriert und ist im Inbox-Widget aktiviert
Was das Widget anzeigt
Sobald die Integration aktiv ist, erscheint im Inbox-Widget bei einem Kontakt:
Kundensuche
Suche per E-Mail-Adresse oder Telefonnummer
Bestelldaten pro Bestellung
Bestellnummer und Bestellstatus
Artikel (Produktname, Variante, Menge)
Versandstatus und Tracking-URL (sofern vorhanden)
Direktlink zur Bestellung im Admin-Panel (optional)
Verfügbare Aktionen
Wenn Write-Endpunkte implementiert wurden, können Agenten direkt aus dem Widget:
Bestellung stornieren – inkl. Rückerstattungs- und Restock-Option
Rückerstattung auslösen – ohne Stornierung der Bestellung
Hinweise
Die Integration erfordert eine individuelle Implementierung der API-Endpunkte durch euer Entwicklungsteam.
Lese-Zugriff (Kunden- und Bestelldaten) und Schreib-Aktionen (Storno, Rückerstattung) können unabhängig voneinander implementiert werden — ihr könnt mit Read-only starten und Schreib-Aktionen später ergänzen.
Jede Aktion enthält Agenten-Metadaten (Name und E-Mail), sodass Aktivitäten in eurem Backend nachvollzogen werden können.
Wenn keine Tracking-Status-Felder vorhanden sind, reicht eine Tracking-URL aus — armincx zeigt diese direkt an.
Das API-Rate-Limit liegt standardmäßig bei 120 Anfragen pro Minute.