Postmark Integration

Postmark Integration collega la posta nativa di PrestaShop a SMTP Postmark e registra Bounce e SpamComplaint per il negozio selezionato. La guida copre token del server, configurazione manuale dei DNS, invio nativo e rapporto degli eventi.

Avvio rapido

1. Carica lo ZIP nel gestore moduli e installa Postmark Integration.
2. Apri la configurazione per un singolo negozio. I contesti di gruppo e tutti i negozi non sono accettati.
3. Prepara un server Postmark esistente con SMTP abilitato e un flusso outbound transazionale attivo. Configura l’autenticazione del mittente in Postmark per l’indirizzo di invio del negozio.
4. Pubblica i record DNS forniti da Postmark presso il tuo gestore, anche se usi Cloudflare. Il modulo non pubblica record DNS.
5. Salva il token del server, verifica la connessione e attiva SMTP. Configura separatamente il webhook dei mancati recapiti; non è un requisito per l’attivazione.
6. Avvia l’email di prova e controlla separatamente il risultato e la casella del dipendente che avvia il test.
7. Prova anche una normale notifica del negozio con il modello e il mittente previsti.

Funzionalità

• Avvio semplice. Un token del server Postmark collega un server di invio esistente.
• Controlli DNS. Le richieste DNS esaminano la politica DMARC del dominio mittente e il CNAME Return-Path.
• DNS manuali. Copia i record del dominio da Postmark al tuo gestore DNS.
• Email del negozio. PrestaShop continua a preparare i messaggi di ordini e account; Postmark li invia.
• Problemi visibili. Mancati recapiti e segnalazioni di spam nel back office.
• Test e controllo. Una prova di invio nativo e il ripristino delle impostazioni gestite accompagnano il passaggio.

Opzioni di configurazione

Token account e dominio

La connessione usa il token API di un server Postmark esistente. Il dominio per i controlli DNS deriva dal valore effettivo di PS_SHOP_EMAIL del negozio selezionato. Per shop.example.com che invia da ordini@example.com viene usato example.com. Un indirizzo mittente valido è quindi necessario per la configurazione.

Copia tu stesso il token del server nel modulo. L’autenticazione degli eventi viene generata durante la configurazione del webhook. Sostituire o rimuovere il token salvato ripristina prima le impostazioni native ancora gestite dal modulo e azzera gli stati di verifica e del webhook; verifica e attiva di nuovo la connessione. Cambiare il dominio dell’indirizzo del negozio non disattiva automaticamente SMTP.

DNS e controllo dell’invio

La pubblicazione DNS è manuale presso ogni fornitore, incluso Cloudflare. Recupera i record del dominio mittente in Postmark e pubblicali presso il tuo gestore DNS. Il modulo non ha una connessione Cloudflare e non modifica i DNS.

La verifica controlla la disponibilità SMTP e il flusso outbound transazionale attivo. I controlli DNS leggono DMARC e Return-Path, senza interrogare lo stato di verifica del dominio in Postmark. Una politica DMARC quarantine o reject senza Return-Path corrispondente richiede la tua conferma della verifica del dominio in Postmark prima dell’attivazione. Il webhook si configura separatamente. La disattivazione ripristina i valori gestiti dall’integrazione. Il rapporto riguarda il negozio selezionato e i suoi totali conservati.

Esempi di personalizzazione

DNS presso un altro fornitore

Lo schema mostra i tipi di record. I valori effettivi provengono dalla configurazione del tuo dominio in Postmark:

TXT   <selettore>._domainkey.example.com   <valore DKIM fornito da Postmark>
CNAME pm-bounces.example.com              pm.mtasv.net

Selettore e valore DKIM sono segnaposto. Il gestore DNS può richiedere il nome completo o solo la parte prima della zona. Il CNAME Return-Path deve essere DNS only, senza proxy. Il modulo non genera una politica SPF o DMARC; l’esempio non sostituisce i record esistenti.

Conservare i modelli

Le conferme d’ordine e le comunicazioni di account restano preparate da PrestaShop. Non occorre ricrearle come modelli Postmark. Un’estensione con trasporto indipendente non eredita automaticamente le impostazioni native del negozio.

Preservare le modifiche successive

La disattivazione ripristina soltanto i valori ancora corrispondenti a quelli dell’integrazione. Una tua modifica successiva resta valida. La prossima attivazione salva come punto di partenza la configurazione presente in quel momento.

Installazione

Requisiti

• Intervallo generale: PS 1.6 – 9.x. Minimo esatto dichiarato: PrestaShop 1.6.1.0.
• PHP da 7.1, compatibile anche con la versione PrestaShop installata.
• Estensioni PHP cURL e JSON. Le chiamate API hanno un timeout di connessione di 5 secondi e un timeout totale di 20 secondi.
• Account Postmark, server esistente con SMTP e flusso outbound transazionale attivo, e token di quel server. Il servizio ha piani propri a pagamento; il modulo è gratuito.
• Indirizzo mittente valido, accesso ai DNS e indirizzo pubblico HTTPS per ricevere gli eventi.
• Pubblica manualmente i record di autenticazione del mittente presso il gestore DNS, incluso Cloudflare.

La lettura richiede accesso al negozio e permesso di visualizzazione; le modifiche richiedono anche il permesso di modifica. Nascondi i segreti nelle schermate. Con più negozi, configura e verifica quello interessato senza presumere che la connessione sia attiva per tutti.

Come funziona

Salvare il token del server, verificare server e flusso outbound, attivare SMTP nativo, configurare il webhook e inviare il test sono azioni separate. Il modulo riutilizza l’invio del negozio e il proprio ricevitore autenticato degli eventi.

Come aiuta Postmark Integration quando mancano le email degli ordini?

Postmark Integration collega i messaggi già preparati dal negozio al servizio di invio transazionale di Postmark. Configura tu stesso l’autenticazione del mittente in Postmark, poi collega il negozio con il token del server esistente. Conservi i contenuti creati da PrestaShop e nel back office trovi le segnalazioni quando Postmark comunica un mancato recapito o un destinatario segnala il messaggio come spam.

Come vengono configurati i record del dominio su Cloudflare?

Pubblica manualmente in Cloudflare i record del dominio mittente forniti da Postmark, lasciando il CNAME Return-Path in DNS only. Il modulo non modifica i DNS Cloudflare e non interroga Postmark per verificare il dominio. I suoi controlli DNS usano il dominio dell’indirizzo di invio del negozio, che può differire dall’indirizzo del sito.

E se il mio dominio è gestito da un altro fornitore?

Inserisci i record della configurazione del tuo dominio in Postmark nell’editor DNS del tuo gestore. La pubblicazione è manuale presso ogni fornitore. Il modulo non fornisce valori DKIM e non pubblica i record.

Le email attuali mantengono contenuti e impaginazione?

PrestaShop continua a preparare il messaggio, la sua impaginazione e gli allegati. Il modulo cambia le impostazioni di invio verso Postmark senza creare nuovi modelli. Anche le notifiche di altri moduli seguono questo percorso quando usano la posta nativa di PrestaShop.

Dove trovo i mancati recapiti e le segnalazioni di spam?

Il rapporto nel back office mostra le segnalazioni ricevute da Postmark con destinatario, orario e riferimento del messaggio. Quando un cliente cerca una conferma d’ordine mai ricevuta, il tuo team ha una traccia da consultare. Una risposta positiva all’invio non chiarisce da sola che cosa sia successo dopo.

Che cosa conferma l’email di prova?

Il test usa la posta nativa di PrestaShop e il modello di prova del modulo. È indirizzato al dipendente che avvia il test e percorre quindi il canale di invio del negozio. La risposta durante l’invio e il messaggio ricevuto nella casella sono verifiche distinte.

Impostazioni native e tracciamento

L’attivazione scrive PS_MAIL_METHOD=2, PS_MAIL_SERVER=smtp.postmarkapp.com e porta 587. Il token server salvato serve da nome utente e password. PrestaShop da 1.6 a 8 usa tls; PrestaShop 9 usa il valore nativo off per consentire STARTTLS automatico. Non è un’indicazione di invio volutamente senza cifratura.

Da PrestaShop 1.7.6, il modulo aggiunge le intestazioni assenti X-PM-KeepID: true, X-PM-TrackOpens: false e X-PM-TrackLinks: None. I valori espliciti esistenti restano validi. Le versioni precedenti dipendono dalle impostazioni del server. La verifica avvisa se il tracciamento del server è attivo, senza modificarne le impostazioni.

Eventi e dominio From

Gli eventi autenticati devono corrispondere a server salvato e flusso outbound. Bounce e SpamComplaint vengono normalizzati e deduplicati. Il rapporto mostra i 30 più recenti e i totali conservati, con orario UTC, destinatario, ID evento e Message-ID.

Da PrestaShop 1.7.6, l’hook finale del messaggio controlla lo stato di attivazione salvato e che metodo e server nativi usino Postmark prima di aggiungere le intestazioni. Non convalida il dominio From e non ricontrolla la disponibilità del server o le credenziali SMTP per ogni messaggio. Verifica tu stesso l’autorizzazione del mittente in Postmark.

Limiti da conoscere

Accettazione e consegna

Un risultato nativo positivo indica accettazione per l’invio. Non conferma ricezione o cartella finale. L’autenticazione del dominio non annulla i filtri del destinatario. Non vengono dichiarate percentuali di consegna o certificazioni Gmail e Outlook.

Il test chiama la funzione nativa Mail::Send in modo sincrono ed è indirizzato al dipendente che lo avvia. Non ci sono un processo CLI separato, un timeout di invio imposto dal modulo o un reinvio automatico. In caso di errore, controlla le impostazioni native e la diagnostica. L’invio ordinario usa sempre la posta nativa.

Ambito e dati

È coperto soltanto l’outbound transazionale predefinito tramite posta nativa. Non sono inclusi campagne newsletter, invii broadcast, scelta di flussi personalizzati, editor di modelli o reinvio dei messaggi respinti. I trasporti indipendenti di altre estensioni restano esclusi.

Gli eventi contengono dati personali, tra cui indirizzi dei destinatari e riferimenti dei messaggi. Il callback esclude il contenuto dell’email; il modulo salva campi normalizzati anziché MIME grezzo. Il webhook configurato non ha trigger Open o Click. Il tracciamento può comunque dipendere dalle impostazioni del server o dalle intestazioni esistenti. Questo non significa assenza di dati verso Postmark: il servizio riceve le email da inviare.

Le credenziali restano sul server e non sono restituite nella vista sicura. Non è promessa cifratura applicativa. Il modulo non cambia preferenze newsletter e non riattiva automaticamente destinatari bloccati in Postmark.

Dominio e ripristino

Configura DKIM e Return-Path in Postmark e pubblica tu stesso i relativi record DNS. Il modulo non crea o ripara l’intera politica SPF/DMARC, non pubblica record DNS e non controlla lo stato di verifica del dominio in Postmark.

Il ripristino conserva le tue modifiche e non elimina risorse remote Postmark. Il modulo lascia intatti contenuti nativi e allegati; ciò non garantisce una conservazione byte per byte durante l’elaborazione successiva del fornitore.

Risoluzione dei problemi

• Avviso DNS: controlla l’autenticazione del mittente in Postmark e pubblica i suoi record esatti presso il tuo gestore DNS. Il CNAME Return-Path resta senza proxy.
• Mittente rifiutato: verifica che il mittente effettivo del negozio o del modulo sia autorizzato in Postmark. L’indirizzo del sito da solo non determina il mittente.
• Test accettato, messaggio assente: controlla casella del dipendente, spam ed eventi disponibili. Un elenco vuoto non prova la ricezione.
• Nessun evento: verifica HTTPS pubblico e inoltro dell’intestazione di autenticazione. Una visita nel browser non equivale a un evento valido.
• Impostazioni modificate a mano: verifica stato della connessione e valori nativi. Il ripristino conserva le modifiche del commerciante.
• Errore di accesso: risolvi il problema segnalato di token del server, SMTP o flusso outbound. La disattivazione locale non richiede una risposta di Postmark.