I postback sono notifiche automatiche inviate da GelatoConnect ai sistemi esterni ogni volta che lo stato di un ordine cambia. Sono fondamentali per tenere aggiornati in tempo reale i Print Service Provider (PSP) e i clienti sui loro ordini, senza bisogno di aggiornamenti manuali.
I postback ti permettono di:
Avvisa automaticamente i clienti quando lo stato del loro ordine cambia (ad esempio: ricevuto, spedito, consegnato).
Avvisa il tuo team quando ci sono ordini che richiedono attenzione, come quelli non andati a buon fine.
Aggiorna i tuoi sistemi di gestione dell'inventario quando gli ordini sono completati.
Segui l’avanzamento degli ordini in ogni fase del tuo flusso di realizzazione.
Queste notifiche possono essere inviate tramite Webhook (URL) o email, a seconda delle tue esigenze di integrazione.
Cosa serve per configurare i postback
Prima di creare i postback, assicurati di avere:
Le persone che riceveranno le notifiche sono impostate nella sezione clienti di GelatoConnect.
Gli endpoint URL sono pronti a ricevere i dati del Webhook (se scegli il metodo di consegna tramite URL).
Una conoscenza di base di template e trigger.
Familiarità con il flusso degli stati degli ordini in GelatoConnect.
Guida semplice per configurare i postback, passo dopo passo
1. Crea un modello di postback
I template definiscono la struttura e il contenuto delle tue notifiche di postback. Puoi crearli in due modi:
Opzione A: dalla sezione dei template
Vai su Workflow > Order Intake > Template
Clicca su Aggiungi modello
Seleziona il tipo di modello:
Trigger: Webhook - Per inviare dati JSON o XML a sistemi esterni
Trigger: Email - Per inviare notifiche via email
Scegli il formato più adatto (JSON o XML)
Opzione B: dal profilo cliente
Vai al profilo del tuo cliente
Vai alla scheda Triggers e clicca su Aggiungi Trigger
Potrai creare il template direttamente durante la configurazione del trigger
Per una guida dettagliata su come creare template, dai un'occhiata a Creare template per l'inserimento degli ordini.
2. Configura un trigger
I trigger decidono quando vengono inviati i postback e dove vengono consegnati:
Dai un nome descrittivo al tuo trigger (ad esempio: "Notifica ordine spedito")
Seleziona l’evento che farà partire il trigger:
Ordine ricevuto
Ordine fallito
Ordine annullato
Ordine restituito
Ordine completato
Ordine consegnato
Ordine spedito
Ordine in transito
Scegli come ricevere la consegna:
URL (Webhook): Invia dati a un endpoint specifico
Email: Invia notifiche tramite email
Per la consegna tramite URL, configura così:
L'URL di destinazione a cui verranno inviate le notifiche
Imposta il metodo su POST (consigliato)
Puoi scegliere tra JSON o XML come formato dei dati
Attiva "Riprova in caso di errore" per una maggiore affidabilità
Per la consegna via email, imposta l'indirizzo email del destinatario.
3. Aggiungi un modello
Il tuo template trasforma i dati interni di GelatoConnect in un formato utile sia per te che per i sistemi dei tuoi clienti.
Se hai già creato un template, puoi selezionarlo durante la configurazione del trigger; altrimenti, dovrai crearne uno nuovo.
Dai al tuo template un nome chiaro (ad esempio: "OrderShippedNotification")
Usa i payload di esempio forniti per il tipo di evento che hai scelto
Abbina i campi dei dati in ingresso al formato di output che preferisci usando il Template Mapper
Esempio di template per l’evento "Ordine spedito":
{ "event": "Ordine spedito", "orderId": "##{{ orderId }}", "orderReferenceId": "##{{ orderReferenceId }}", "timestamp": "##{{ created }}", "status": "##{{ fulfillmentStatus }}", "trackingInfo": { {% for item in items %} {% for fulfillment in item.fulfillments %} "trackingCode": "##{{ fulfillment.trackingCode }}", "trackingUrl": "##{{ fulfillment.trackingUrl }}", "carrier": "##{{ fulfillment.carrierName }}" {% endfor %} {% endfor %} }}Usa il pulsante "Render" per vedere in anteprima come apparirà il tuo risultato
Metti alla prova il template per vedere se crea il risultato che ti aspetti
Per altri esempi di template, dai un'occhiata a Esempi di Template Mapper.
4. Fai una prova e attiva
Prima di andare online con il tuo postback, fai qualche test per assicurarti che tutto funzioni come previsto. Dopo, puoi cambiare lo stato del tuo trigger e del tuo template in attivo.
Dopo aver completato questi passaggi, il sistema invierà un postback all’URL o all’indirizzo email indicato con le informazioni rilevanti sull’ordine ogni volta che si verifica l’evento d’ordine specificato.
Tecniche avanzate di postback
Come usare le Lookups nei tuoi template
Le lookups sono utili per trasformare valori interni in formati più comprensibili per i clienti:
{% set carrier = lookups({"shipmentMethodUid": fulfillment.carrierUid}, strict=False, default="") %}"corriere": "##{{ carrier }}"Questo trasforma i codici interni di GelatoConnect in valori più comprensibili per i tuoi clienti. Scopri di più in Come configurare le Lookups.
Campi dati specifici per l'evento
Eventi diversi offrono dati diversi. Ecco i campi principali disponibili per gli eventi più comuni:
Ordine spedito/consegnato: codici di tracciamento, informazioni sul corriere, date di consegna
Ordine non riuscito/annullato: motivi dell'errore, data e ora
Ordine ricevuto: dettagli dell'ordine, informazioni sull'articolo
Per capire davvero questi campi, dai un'occhiata a Introduzione ai Template Mapper in GelatoConnect.
Risolvere i problemi dei postback
Se i tuoi postback non funzionano come dovrebbero:
Controlla che l’URL di destinazione sia corretto e accessibile
Controlla se ci sono errori nella sintassi del template
Assicurati che il trigger sia configurato correttamente per l’evento giusto
Controlla se ci sono tipi di dati non corrispondenti o campi mancanti
Prova il modello con dati di esempio prima di attivarlo
Per quanto riguarda i postback tramite email nello specifico:
Verifica che i dettagli del tuo server SMTP siano corretti (se configurato)
Controlla che l'indirizzo email del mittente sia scritto correttamente
Assicurati che il tuo server SMTP consenta la connessione da GelatoConnect
Controlla che i dati di accesso (username/password) siano corretti
Per consigli più approfonditi su come risolvere i problemi, vai alla sezione "Risoluzione dei problemi" in Creare template per l'acquisizione degli ordini.
Configurare il tuo server email per le notifiche di ritorno
Come fornitore di servizi di stampa, puoi configurare GelatoConnect per inviare postback email utilizzando il tuo server di posta elettronica. In questo modo, chi riceve le email vedrà il tuo dominio come mittente invece di GelatoConnect, così mantieni la coerenza del tuo brand.
Per configurare le impostazioni del tuo server email:
Vai alla sezione Workflow nella barra laterale a sinistra
Trova la sezione Configurazione e seleziona Impostazioni di lavoro
Trova la sezione Impostazioni server email in uscita
Inserisci questi dettagli:
Indirizzo email del mittente: l'indirizzo email che comparirà nel campo "Da"
Nome mittente: il nome che verrà visualizzato accanto all'indirizzo email
Server SMTP: l'indirizzo del tuo server email (ad esempio, smtp.tuaazienda.com)
Porta SMTP: la porta che il tuo server email utilizza (di solito 587 o 465)
Nome utente SMTP: il nome utente che usi per accedere al tuo server SMTP
Password SMTP: la password del tuo server SMTP
Usa TLS: attiva questa opzione se il tuo server SMTP richiede la crittografia TLS (consigliato)
Salva la tua configurazione
Una volta configurato, tutti i postback email verranno inviati tramite il tuo server email, così il tuo brand sarà sempre riconoscibile e le email arriveranno più facilmente ai tuoi clienti.
Cosa fare adesso
Dopo aver configurato i tuoi postback:
Tieni d'occhio le consegne andate a buon fine nella pagina Richieste all'interno di Order intake.
Chiedi ai tuoi clienti se ricevono le notifiche senza problemi
Implementando un sistema postback solido, offrirai ai tuoi clienti aggiornamenti sugli ordini in tempo reale e ridurrai la necessità di comunicazioni manuali.