Perché l’email resta bloccata in Accepted o Scheduled?

Questo articolo ti aiuta quando un’email resta in Accepted o Scheduled più a lungo del previsto. Entrambi gli stati significano che Emailit ha l’email e non ha ancora completato un tentativo di consegna.

Sintomi

• Un’email risulta Accepted («Accepted for delivery») per molti minuti.
• Un’email programmata risulta ancora Scheduled dopo l’orario in cui ti aspettavi che partisse.
• La scheda Deliveries nella pagina dell’email è vuota, oppure mostra una voce di errore interno.

Causa

Le email Accepted sono in coda e di solito vengono inviate entro pochi secondi. Restano più a lungo quando:

• Un tentativo di consegna ha incontrato un errore interno. La scheda Deliveries mostra An internal error occurred while sending this email. This message will be retried automatically. L’email mantiene il suo stato e viene ritentata con ritardi crescenti.
• Emailit sta smaltendo un arretrato o gestendo un incidente. Controlla status.emailit.com.

Tieni presente che un rifiuto temporaneo da parte del server del destinatario compare come Attempted, non come Accepted. Vedi Cosa significa lo stato Attempted?.

Le email Scheduled attendono l’orario indicato in scheduled_at, poi partono entro pochi secondi. Passano direttamente da Scheduled a Delivered, o a un altro stato definitivo, senza passare da Accepted. Un’email programmata che sembra in ritardo di solito:

• È programmata per un orario diverso da quello che intendevi. Un orario senza differenza di fuso, o un’espressione come «tomorrow at 9am», può essere interpretato in un fuso orario diverso dal tuo.
• È rallentata dagli stessi errori interni descritti sopra.

Soluzione

1. Controlla gli orari dell’email. Aprila in Email API›Emails. Il riepilogo mostra quando è stata creata e, per le email programmate, per quando è programmata. Per fare il confronto, passa dall’ora UTC all’ora locale in Timezone, nel menu utente.

2. Leggi la scheda Deliveries. Se mostra un errore interno, Emailit ritenta da solo. Non devi reinviare l’email: reinviarla crea un duplicato.

3. Usa fusi orari espliciti. Invia scheduled_at in formato ISO 8601 con la differenza di fuso, come 2026-10-02T09:00:00+02:00, oppure come timestamp Unix. La risposta dell’API restituisce il valore scheduled_at interpretato, quindi registralo e confrontalo. Vedi Programmazione.

4. Riprogramma o annulla se serve. Chiama Aggiorna un’email programmata con un nuovo scheduled_at, oppure seleziona Cancel delivery nella pagina dell’email. Entrambe le operazioni funzionano solo fino a 3 minuti prima dell’orario programmato, e il nuovo orario deve essere almeno 3 minuti nel futuro.

5. Verifica se c’è un incidente. Se molte email sono bloccate nello stesso momento, controlla status.emailit.com prima di reinviare qualsiasi cosa.

Per seguire le email in tempo reale, iscrivi un webhook a email.delivered, email.attempted e email.bounced. Per il significato di ogni stato, vedi Stati delle email.

Serve ancora aiuto?

Se un’email resta Accepted per più di un’ora senza che sia stato segnalato un incidente, contatta il supporto o chiedi su Discord indicando l’ID dell’email (em_…).