Installare Pushover su PrestaShop: guida completa (modulo BdPushover)

Sommario

1. Perché connettere Pushover a PrestaShop?
2. Prerequisiti: account Pushover + compatibilità PrestaShop/PHP
3. Creare il proprio Token dell'API Applicazione e recuperare la User Key
4. Installare il modulo BdPushover su PrestaShop
5. Configurare BdPushover (eventi, stati, destinatari)
6. Templates: esempi pronti all'uso + variabili disponibili
7. Opzioni avanzate Pushover (suono, priorità, Emergenza)
8. Test di notifica e debug: diagnosticare rapidamente
9. RGPD / confidenzialità: cosa viene inviato a Pushover
10. Risoluzione problemi: le cause più frequenti
11. FAQ "Pushover PrestaShop"

Perché connettere Pushover a PrestaShop?

Molti negozi PrestaShop si basano ancora sulle email per monitorare gli ordini. In pratica, si incontrano spesso: spam, ritardi di ricezione, caselle condivise disorganizzate o semplicemente la necessità di allertare più persone (logistica, supporto clienti, direzione) in tempo reale. L'approccio Pushover PrestaShop consiste nell'inviare una notifica push direttamente sul telefono non appena si verifica un evento critico.

Il modulo BdPushover è stato progettato per un'integrazione pulita nel ciclo di vita degli ordini PrestaShop: nuovo ordine e cambio di stato, con messaggi configurabili e multilingue. Risultato: ricevi le informazioni giuste, al momento giusto, senza essere connesso in permanenza al Back-Office.

Vedi la scheda ufficiale del modulo Pushover PrestaShop

Prerequisiti: account Pushover + compatibilità PrestaShop/PHP

1) Cosa serve dal lato Pushover

• Un account Pushover
• Un Token dell'API Applicazione (creato tramite un'"applicazione" Pushover)
• Una o più User Key(s) (destinatari)
• (Opzionale) Il nome di un Device se si desidera mirare a un dispositivo specifico

2) Compatibilità PrestaShop

BdPushover dichiara una compatibilità a partire da PrestaShop 1.7.0 (ed è utilizzato sulle versioni moderne, comprese 8 e 9). In concreto: se il tuo negozio funziona su PrestaShop 1.7+, sei nel raggio d'azione.

3) Compatibilità PHP (esaustivo, per famiglia PrestaShop)

Il modulo segue la compatibilità PHP ufficiale della tua versione di PrestaShop. Se il tuo PrestaShop è compatibile con una versione di PHP, il modulo può essere eseguito nello stesso intervallo. Per evitare qualsiasi imprecisione, fare riferimento alle tabelle ufficiali di PrestaShop:

• PrestaShop 9: Requisiti di sistema (DevDocs)
• PrestaShop 8: Help Center – Configurazione server

Riferimenti pratici (da verificare in base alla tua sottoversione PrestaShop):

• PrestaShop 1.7.x: secondo la sottoversione, si incontra tipicamente PHP 5.6 → 7.4.
• PrestaShop 8.x: tipicamente PHP 7.2.5 → 8.1 (8.1 consigliato).
• PrestaShop 9.x: PHP 8.1 minimo, supporto esteso fino a 8.4 secondo la documentazione.

4) Prerequisiti del server (importante per "Pushover PrestaShop")

Pushover funziona tramite API HTTPS. Il server deve quindi essere in grado di eseguire richieste in uscita in HTTPS. Altrimenti, nessuna notifica può essere inviata.

• Estensione PHP cURL: necessaria (BdPushover ha bisogno di chiamare l'API di Pushover)
• Uscita HTTPS consentita (porta 443) verso i domini Pushover
• Ambiente conforme ai prerequisiti PrestaShop usuali (OpenSSL, JSON, PDO, ecc.)

5) Lingue disponibili

Il modulo è disponibile nelle seguenti lingue: FR, EN, DE, IT, ES. I template sono multilingue e possono essere adattati per lingua nella configurazione.

Creare il proprio Token dell'API Applicazione e recuperare la User Key

Per utilizzare Pushover con PrestaShop, hai bisogno di due informazioni: il Token dell'API Applicazione e la/le User Key.

Fase A — Creare un'applicazione Pushover

1. Accedi al tuo account Pushover.
2. Crea una nuova "applicazione" (nome a scelta, ad esempio "PrestaShop").
3. Copia il Token dell'API Applicazione: è il token da incollare in BdPushover.

Fase B — Recuperare la User Key (destinatario)

1. In Pushover, individua la tua User Key (chiave utente).
2. Se vuoi notificare più persone: recupera la User Key di ciascuna persona.
3. Potrai incollare più chiavi in BdPushover (una per riga).

Fase C — (Opzionale) Mirare a un dispositivo

Se utilizzi Pushover su più dispositivi (smartphone + tablet, ad esempio), puoi mirare a un dispositivo tramite il campo Device nella configurazione del modulo.

Installare il modulo BdPushover su PrestaShop

Metodo 1 — Installazione tramite il Back-Office (consigliata)

1. Scarica l'archivio del modulo dal tuo spazio cliente BeDOM (o dal luogo previsto al momento dell'acquisto).
2. In PrestaShop: Moduli → Gestione moduli.
3. Clicca su “Aggiungi un modulo” quindi seleziona l'archivio del modulo.
4. Una volta installato, apri la pagina di configurazione del modulo BdPushover.

Metodo 2 — Installazione manuale (FTP/SSH)

1. Decomprimi l'archivio e verifica che la cartella si chiami bdpushover.
2. Invia la cartella bdpushover in /modules/ sul tuo hosting.
3. Nel Back-Office, vai su Moduli e installa BdPushover.

Consiglio: dopo l'installazione, svuota la cache di PrestaShop se il tuo ambiente lo richiede (soprattutto su negozi pesantemente personalizzati).

Configurare BdPushover (eventi, stati, destinatari)

1) Fornire le credenziali Pushover

• Token dell'API Applicazione: incolla il token della tua applicazione Pushover.
• User keys: incolla una o più User Key (una per riga).
• Device (opzionale): indica un dispositivo specifico se desideri mirare a un device.

2) Scegliere gli eventi PrestaShop da notificare

BdPushover gestisce due eventi principali:

• Nuovo ordine: notifica al momento della convalida dell'ordine.
• Cambio di stato dell'ordine: notifica durante un aggiornamento di stato.

3) Selezionare gli stati che attivano una notifica

Per evitare il rumore, puoi selezionare solo gli stati importanti (es: "Pagamento accettato", "Spedito"). È un punto chiave per un utilizzo "agenzia / multi-clienti": adatti gli stati in base al processo del commerciante.

4) Attivare il link Back-Office verso l'ordine (opzione)

Se attivi l'opzione corrispondente, potrai utilizzare la variabile {admin_order_url} per includere un link diretto verso l'ordine nel Back-Office.

Templates: esempi pronti all'uso + variabili disponibili

Variabili disponibili in BdPushover

Puoi costruire i tuoi messaggi con le seguenti variabili:

• {shop}
• {order_id}
• {order_reference}
• {customer}
• {total}
• {currency}
• {status}
• {date}
• {admin_order_url} (se l'opzione "link admin" è attivata)

Esempio 1 — Template "Nuovo ordine" (semplice ed efficace)

Titolo:

Nuovo ordine {order_reference}

Messaggio:

Negozio: {shop}
Cliente: {customer}
Totale: {total} {currency}
Data: {date}

Esempio 2 — Template "Cambio di stato" (per logistica/SAV)

Titolo:

Ordine {order_reference} → {status}

Messaggio:

Cliente: {customer}
Totale: {total} {currency}
Data: {date}

Esempio 3 — Template con link Back-Office

(Attivare l'opzione link admin, poi utilizzare {admin_order_url})

Ordine: {order_reference}
Stato: {status}
Link BO: {admin_order_url}

Multilingue: buone pratiche

Se il tuo negozio è multilingue, definisci dei template per ogni lingua (FR/EN/DE/IT/ES) ed evita le abbreviazioni ambigue. L'obiettivo è che la notifica sia immediatamente comprensibile, anche quando più persone sono destinatari.

Opzioni avanzate Pushover (suono, priorità, Emergenza)

Scegliere un suono

Pushover consente di scegliere un suono per la notifica. Questo può essere utile per distinguere un ordine da un cambio di stato o per rendere la notifica più "visibile" in logistica.

Priorità

BdPushover espone la nozione di priorità Pushover. Usa una priorità standard nella maggior parte dei casi. Conserva le priorità elevate per situazioni realmente critiche (es: pagamento accettato su vendite flash, incidenti).

Modalità "Emergenza" (retry / expire)

La modalità Emergenza attiva notifiche insistenti (secondo le regole Pushover). BdPushover consente di impostare: retry (intervallo di ripetizione) e expire (durata massima). Usalo con parsimonia, solo se la tua organizzazione lo giustifica.

Test di notifica e debug: diagnosticare rapidamente

1) Inviare una notifica di test

BdPushover integra un pulsante/formulario di test. Prima di testare gli eventi reali (ordini/stati), inizia sempre con un test: questo valida il token, la User Key e la connettività del server verso l'API di Pushover.

2) Attivare i log (modalità debug)

In caso di problema (nessuna notifica, notifiche parziali, ecc.), attiva l'opzione debug. Il modulo scrive quindi informazioni utili nei log di PrestaShop (tramite il logger).

3) Testare quindi in condizioni reali

1. Esegui un ordine di test (o duplica un ordine in ambiente di pre-produzione se ne hai uno).
2. Cambia lo stato dell'ordine verso uno stato selezionato nella configurazione.
3. Convalida che la notifica arrivi e che il contenuto corrisponda al template.

RGPD / confidenzialità: cosa viene inviato a Pushover

BdPushover invia un payload di notifica all'API di Pushover. Il contenuto esatto dipende dai tuoi template e dalle variabili che scegli. Ad esempio: riferimento ordine, totale, stato, nome cliente... o al contrario, un messaggio minimalista.

Buon riflesso: limita il contenuto se più persone sono destinatari, ed evita di inviare informazioni sensibili se non necessario. In contesto agenzia, pensa a documentare questo punto nel tuo dossier progetto.

Risoluzione problemi: le cause più frequenti (Pushover PrestaShop)

1) Il test non funziona

• Verifica il Token dell'API Applicazione e la/le User Key.
• Verifica che l'estensione PHP cURL sia attiva.
• Verifica l'uscita HTTPS (firewall / regole di hosting) verso l'API Pushover.
• Attiva il debug e consulta i log di PrestaShop.

2) Il test funziona, ma non gli ordini/stati

• Verifica che l'evento "nuovo ordine" sia attivato.
• Per gli stati: verifica che gli stati che stai testando siano selezionati.
• Testa con uno stato semplice (es: "Pagamento accettato") per isolare il problema.
• Attiva il debug e verifica il trigger durante i cambi di stato.

3) Notifiche incomplete o contenuto inatteso

• Verifica i template (titolo/messaggio) e le variabili.
• Verifica la lingua utilizzata: il modulo può basarsi sulla lingua dell'ordine quando è disponibile.
• Se utilizzi {admin_order_url}, verifica che l'opzione link admin sia attivata.

4) In ambiente agenzia / multi-moduli

Su negozi molto personalizzati, i moduli possono sovraccaricare comportamenti o modificare il workflow ordine/stati. In tal caso, il debug è il tuo miglior alleato. Se necessario, isola disattivando temporaneamente i moduli legati al checkout.

FAQ "Installare Pushover su PrestaShop"

Il modulo è multilingue?

Sì. Il modulo è fornito in FR/EN/DE/IT/ES e i template possono essere adattati per lingua.

Si possono notificare più persone?

Sì. Puoi incollare più User Keys (una per riga). Comodo per un team e-commerce.

Si possono ricevere solo alcuni stati?

Sì. Puoi selezionare gli stati che attivano una notifica, così da limitare il rumore.

Funziona su PrestaShop 8 / 9?

Il modulo dichiara una compatibilità a partire da PrestaShop 1.7.0. La compatibilità PHP dipende dalla versione di PrestaShop installata (vedi la sezione prerequisiti e i link alla documentazione ufficiale).

Modulo Pushover PrestaShop: andare oltre

Se desideri distribuire rapidamente una soluzione di notifica push PrestaShop basata su Pushover, BdPushover è progettato per: configurare gli eventi, scegliere gli stati, personalizzare i template, notificare più destinatori, testare e diagnosticare facilmente.

Vedi la scheda ufficiale del modulo Pushover PrestaShop

Disclaimer (marchio / logo)

Pushover non è un marchio di BeDOM – Soluzioni Web. L'utilizzo del nome "Pushover" e del logo Pushover nel nome del modulo, nei visual e nella descrizione del modulo è stato approvato da Pushover.