Panoramica
L'integrazione con Picqer collega il tuo sistema di gestione del magazzino a Bugalou. Una volta collegato, puoi avviare automazioni sugli eventi di ordini e resi, e l'agente IA può consultare su richiesta le informazioni sugli ordini e le giacenze. Vai a Canali → Picqer e clicca su “Collega”.
Cosa ti serve
- Un account Picqer attivo con accesso da amministratore
- Il tuo sottodominio Picqer (la parte prima di
.picqer.com, per esempiomycompany) - Una chiave API di Picqer (generata in Picqer in Impostazioni → Chiavi API)
Passaggio 1: crea una chiave API in Picqer
- In Picqer, vai a Impostazioni → Chiavi API
- Clicca su “Aggiungi chiave API”
- Dalle un nome (per esempio
Bugalou) e salva - Copia la chiave API generata: la vedrai una sola volta
Passaggio 2: collega in Bugalou
- Vai a Canali → Picqer
- Inserisci il tuo sottodominio (per esempio
mycompany) - Incolla la tua chiave API
- Clicca su “Collega”: Bugalou verificherà il collegamento
Passaggio 3: configura i webhook in Picqer
Per ricevere in tempo reale gli eventi di ordini e resi, aggiungi i webhook in Picqer (Impostazioni → Webhook). L'URL del webhook è mostrato nella pagina dell'integrazione Picqer in Bugalou. Aggiungi un webhook separato per ogni evento che vuoi usare:
| Evento | Quando scatta |
|---|---|
orders.completed | L'ordine è stato completamente elaborato e completato |
orders.status_changed | Lo stato dell'ordine cambia (per esempio in “spedito”) |
orders.closed | L'ordine è chiuso |
returns.status_changed | Lo stato del reso cambia |
returns.products_received | I prodotti resi sono arrivati in magazzino |
Passaggio 4: sincronizza i tuoi prodotti
Dopo il collegamento, clicca su “Sincronizza prodotti” per importare il tuo catalogo prodotti. Così l'agente IA può rispondere alle domande sulla disponibilità e consultare i dettagli dei prodotti. Con cataloghi grandi la sincronizzazione può richiedere un minuto: al termine la pagina mostra lo stato della sincronizzazione e il numero di prodotti.
Cosa puoi fare
- Trigger di automazione — avvia automazioni WhatsApp, email o SMS sugli eventi di ordini e resi di Picqer. Vedi il riferimento dei trigger di Picqer per tutti i sottoeventi e le variabili
- Ricerca ordini con l'agente IA — quando un cliente cita un numero d'ordine, l'agente IA lo cerca automaticamente in Picqer e include nella risposta stato, prodotti e informazioni di tracciamento
- Domande sulla disponibilità all'agente IA — l'agente IA può rispondere alle domande sulla disponibilità dei prodotti usando il catalogo Picqer sincronizzato
- Variabili disponibili —
{{customer_name}},{{order_number}},{{order_status}},{{tracking_url}},{{tracking_code}},{{return_number}}
Casi d'uso
- Ordine completato → richiesta di recensione — quando un ordine è completato, aspetta 2 giorni e invia automaticamente una richiesta di recensione via WhatsApp
- Ordine spedito → track & trace — quando lo stato di un ordine passa a “spedito”, invia al cliente il link di tracciamento
- Reso ricevuto → conferma — quando arrivano i prodotti resi, invia automaticamente una conferma di reso
- Domande sulla disponibilità tramite IA — i clienti possono chiedere “La giacca blu è disponibile?” e l'agente IA risponde usando il catalogo prodotti sincronizzato
Scollegare
Per scollegare Picqer, clicca su “Scollega” in fondo alla pagina dell'integrazione Picqer. Le credenziali vengono rimosse e tutti i webhook in arrivo si fermano. I prodotti sincronizzati in precedenza e le automazioni esistenti non vengono eliminati.