Errore Postmark 406 "Inactive recipient": come risolvere

Cosa significa

Postmark ha rifiutato l'invio perché almeno un destinatario è segnato come inattivo nel message stream che stai usando. La risposta dell'API di solito è così:

{
  "ErrorCode": 406,
  "Message": "You tried to send to recipient(s) that have been marked as inactive. Found inactive addresses: alice@example.com. Inactive recipients are ones that have generated a hard bounce, a spam complaint, or a manual suppression."
}

Lo stato HTTP è 422. Con l'endpoint batch la richiesta in sé riesce e ogni messaggio nella risposta ha il suo ErrorCode, quindi controlla ogni risultato, non solo lo stato HTTP. Alcune librerie sollevano un'eccezione dedicata (per esempio InactiveRecipientsError nel client Node.js).

Gli indirizzi inattivi sono elencati nella scheda Suppressions di ogni message stream. Una soppressione nel tuo stream transazionale non vale per il tuo stream broadcast, e viceversa.

Perché succede

Postmark segna un indirizzo come inattivo per uno di questi quattro motivi:

• Hard bounce: il server destinatario ha risposto che l'indirizzo non esiste o non può ricevere posta.
• Reclamo per spam: la persona ha cliccato "Segnala come spam" e il suo provider ha inoltrato il reclamo.
• Disiscrizione (soprattutto negli stream broadcast): la persona ha usato il link di disiscrizione.
• Aggiunta manuale: qualcuno del tuo team o il tuo codice ha aggiunto l'indirizzo alla suppression list.

È la stessa idea del 605 "previously bounced address" di Mailgun: il provider protegge la tua reputazione non inviando a indirizzi che hanno già fallito.

Come verificare

1. In Postmark apri il server, poi il message stream usato dal tuo codice (per esempio "Default Transactional Stream").
2. Apri la scheda Suppressions e cerca l'indirizzo. Vengono mostrati il motivo (Hard Bounce, Spam Complaint, Manually Added, Unsubscribe) e la data.
3. Per un hard bounce, apri il bounce corrispondente nella scheda Activity e leggi la risposta SMTP originale. "User unknown" significa che l'indirizzo è inesistente. Una casella piena, un account disattivato o un blocco per policy o spam significano che l'indirizzo potrebbe essere valido. Consulta bounce "552 5.2.2": casella piena per un caso frequente.
4. Se il bounce parla di spam o di un blocco, invia un test dallo stesso server Postmark all'indirizzo nella home page di Delivmail e leggi le sezioni autenticazione e blacklist del report.

Come risolvere

Hard bounce di un indirizzo che funziona di nuovo

Solo se hai un buon motivo per credere che la casella ora funzioni (te l'ha detto la persona, l'errore di battitura è stato corretto, la casella piena è stata svuotata): nella scheda Suppressions cerca l'indirizzo e clicca Reactivate. Torna attivo subito. Puoi anche usare la Suppressions API ("Delete a suppression") dal tuo codice. Alcuni tipi di bounce non possono essere riattivati; in quel caso Postmark rifiuta la richiesta.

Postmark non rispedisce i messaggi falliti mentre l'indirizzo era inattivo. Inviali di nuovo.

Hard bounce di un indirizzo inesistente

Non riattivarlo. Correggi o rimuovi l'indirizzo nel tuo database e chiedi all'utente un nuovo indirizzo.

Reclamo per spam

Non puoi riattivare da solo un reclamo. Se la persona ti contatta e vuole di nuovo ricevere le tue email, Postmark ti chiede di contattare il suo supporto indicando l'indirizzo. Se i reclami sono frequenti, leggi troppe persone segnalano le tue email come spam.

Disiscrizione o soppressione manuale

Riattiva solo se la persona ha davvero chiesto di ricevere di nuovo i messaggi. Prima di rimuovere una soppressione manuale, verifica perché il tuo codice o un collega l'ha aggiunta.

Gestisci il 406 nel tuo codice

• Intercetta l'errore 406, registra l'indirizzo e segnalo come non recapitabile nel tuo database invece di riprovare. Riprovare non funziona mai.
• Per le email di reimpostazione della password e simili, mostra all'utente un messaggio come "Non riusciamo a inviare a questo indirizzo, controllalo o usane un altro".
• Usa i webhook di Postmark per bounce e reclami per spam così da mantenere sincronizzata la tua lista.
• Quando un destinatario di un messaggio con più destinatari è inattivo, l'intero messaggio può essere rifiutato. Invia le email transazionali un destinatario alla volta.

Verifica che sia risolto

Dopo la riattivazione, invia un messaggio all'indirizzo e controlla il suo stato nella scheda Activity: "Delivered" significa che la casella accetta di nuovo la posta. Se dà ancora bounce, Postmark lo blocca di nuovo e il testo del nuovo bounce ti dice perché. Se il motivo originale era un blocco contro i tuoi invii, esegui un nuovo test Delivmail e correggi ogni controllo fallito prima di inviare di nuovo.