Übersicht

Die Picqer-Integration verbindet dein Lager- und Bestellverwaltungssystem mit Bugalou. Nach dem Verbinden kannst du Automatisierungen auf Bestell- und Retourenevents auslösen, und der KI-Agent kann auf Anfrage Bestellinformationen und Lagerbestände nachschlagen.

Was du brauchst

• Ein aktives Picqer-Konto mit Administratorzugriff
• Deine Picqer-Subdomain (der Teil vor .picqer.com — z. B. meinefirma)
• Einen Picqer-API-Schlüssel (erstellt unter Picqer Einstellungen → API-Schlüssel)

Schritt 1: API-Schlüssel in Picqer erstellen

1. Gehe in Picqer zu Einstellungen → API-Schlüssel
2. Klicke auf „API-Schlüssel hinzufügen"
3. Gib einen Namen ein (z. B. Bugalou) und speichere
4. Kopiere den generierten API-Schlüssel — du siehst ihn nur einmal

Schritt 2: In Bugalou verbinden

1. Navigiere zu Channels → Picqer
2. Gib deine Subdomain ein (z. B. meinefirma)
3. Füge deinen API-Schlüssel ein
4. Klicke auf „Verbinden" — Bugalou prüft die Verbindung

Schritt 3: Webhooks in Picqer einrichten

Um Bestell- und Retourenevents in Echtzeit zu erhalten, füge Webhooks in Picqer hinzu (Einstellungen → Webhooks). Die Webhook-URL findest du auf der Picqer-Integrationsseite in Bugalou. Füge für jedes gewünschte Event einen eigenen Webhook hinzu:

Event	Wann es ausgelöst wird
orders.completed	Bestellung ist vollständig verarbeitet und abgeschlossen
orders.status_changed	Bestellstatus ändert sich (z. B. zu „versandt")
orders.closed	Bestellung wird geschlossen
returns.status_changed	Retourenstatus ändert sich
returns.products_received	Retourprodukte gehen im Lager ein

Schritt 4: Produkte synchronisieren

Klicke nach dem Verbinden auf „Produkte synchronisieren", um deinen Produktkatalog zu importieren. Dadurch kann der KI-Agent Lagerbestandsfragen beantworten und Produktdetails nachschlagen. Bei großen Katalogen kann die Synchronisierung etwas dauern — die Seite zeigt den Status und die Produktanzahl, sobald sie fertig ist.

Was du damit machen kannst

• Automatisierungstrigger — löse WhatsApp-, E-Mail- oder SMS-Automatisierungen bei Picqer-Bestell- und Retourenevents aus
• KI-Agent Bestellabfrage — wenn ein Kunde eine Bestellnummer nennt, sucht der KI-Agent diese automatisch in Picqer und nennt Status, Produkte und Trackinginformationen in der Antwort
• KI-Agent Lagerbestandsfragen — der KI-Agent kann Fragen zur Produktverfügbarkeit über den synchronisierten Picqer-Katalog beantworten
• Verfügbare Variablen — {{customer_name}}, {{order_number}}, {{order_status}}, {{tracking_url}}, {{tracking_code}}, {{return_number}}

Anwendungsfälle

• Bestellung abgeschlossen → Bewertungsanfrage — wenn eine Bestellung abgeschlossen ist, warte 2 Tage und sende automatisch eine Bewertungsanfrage per WhatsApp
• Bestellung versandt → Track & Trace — wenn sich der Bestellstatus zu „versandt" ändert, sende den Tracking-Link an den Kunden
• Retoure erhalten → Bestätigung — wenn Retourprodukte eingehen, sende automatisch eine Retourenbestätigung
• Lagerbestandsfragen per KI — Kunden können fragen „Ist die blaue Jacke auf Lager?" und der KI-Agent antwortet anhand des synchronisierten Produktkatalogs

Trennen

Um Picqer zu trennen, klicke unten auf der Picqer-Integrationsseite auf „Trennen". Dadurch werden die Zugangsdaten entfernt und alle eingehenden Webhooks gestoppt. Bereits synchronisierte Produkte und bestehende Automatisierungen bleiben erhalten.