Ritenta e inoltra le email

Un nuovo tentativo invia di nuovo un’email con lo stesso contenuto dopo che è rimbalzata, non è riuscita, è stata soppressa o trattenuta. L’inoltro invia una copia di un’email già inviata a un’altra persona, ad esempio un collega dell’assistenza o un cliente che ha perso l’originale. Entrambi creano una nuova email con il proprio ID e lasciano invariata quella originale.

Prima di iniziare

• Nell’API, entrambi gli endpoint funzionano con le chiavi Full Access e Sending Only.
• Entrambi vengono addebitati come nuovi invii, quindi ti servono crediti sufficienti.
• Entrambi richiedono il contenuto originale del messaggio. Emailit lo elimina quando termina il periodo di conservazione dei dati per il contenuto dei messaggi:

Ritenta un’email

Un’email si può ritentare quando sono vere tutte queste condizioni:

Un nuovo tentativo crea una nuova email con un nuovo ID em_ e un nuovo Message-ID. Riusa il messaggio grezzo, il destinatario, i metadati e le impostazioni di tracciamento dell’originale, e passa per la normale pipeline di consegna. Costa 1 credito, oppure 2 crediti se l’originale era un’email di una campagna. Un workspace in modalità sandbox può ritentare solo le email indirizzate ai membri del workspace.

Risolvi la causa prima di ritentare, altrimenti la nuova email finisce con lo stesso stato:

• Soppressa: rimuovi prima l’indirizzo dalle soppressioni.
• Trattenuta per crediti insufficienti: ricarica i crediti.
• Trattenuta perché il dominio era in pausa: risolvi il problema di salute degli invii.
• Trattenuta per il punteggio spam: un nuovo tentativo invia lo stesso contenuto e probabilmente verrà trattenuto di nuovo. Modifica il contenuto e invia invece una nuova email. Vedi Controlli antispam.
• Rimbalzata: controlla il motivo del bounce nella pagina di dettaglio dell’email. Una casella che non esiste rimbalzerà di nuovo. Se Emailit ha aggiunto l’indirizzo alle soppressioni dopo il bounce, rimuovilo prima.

curl -X POST https://api.emailit.com/v2/emails/em_33VtK8mRq1xZp7LwN4cY2bHsDfa/retry \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

const retried = await emailit.emails.retry('em_33VtK8mRq1xZp7LwN4cY2bHsDfa');

retried = client.emails.retry("em_33VtK8mRq1xZp7LwN4cY2bHsDfa")

$retried = $emailit->emails()->retry('em_33VtK8mRq1xZp7LwN4cY2bHsDfa');

{
  "object": "email",
  "id": "em_33Vu2LqPz8aKd4WnX6cR1tYbHgs",
  "original_id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33Vu2LqQ7mFt3XcV9bNp5KsRwEz",
  "message_id": "<33Vu2LqQ7mFt3XcV9bNp5KsRwEz@acme.com>",
  "from": "Acme <orders@acme.com>",
  "to": "ada@example.com",
  "subject": "Receipt for order 1042",
  "status": "accepted",
  "created_at": "2026-10-01T11:15:03.552918Z",
  "message": "Email has been queued for retry"
}

Inoltra un’email

L’inoltro invia a un nuovo destinatario un’email in uscita che hai già inviato. Le email ricevute (in entrata) non si possono inoltrare.

Per impostazione predefinita, l’inoltro è un semplice reinvio: il destinatario riceve oggetto, corpo e allegati originali come se l’email fosse stata inviata a lui. Imposta include_headers per inviare invece un inoltro classico, con un blocco «Forwarded message» (From, Date, Subject e To originali) e un commento facoltativo sopra. In questo caso l’oggetto inizia con Fwd:.

Un inoltro è un nuovo invio, quindi segue le stesse regole di POST /emails: si applicano i crediti per destinatario, i limiti di frequenza di invio, i controlli sul dominio From e l’header Idempotency-Key. Il tracciamento segue le impostazioni del dominio di invio. Gli header personalizzati e i metadati dell’originale non vengono copiati, e gli allegati vengono riportati solo se il loro tipo di file è consentito.

Ogni workspace può fare 3 richieste di inoltro all’ora, contando insieme gli inoltri dal pannello e dall’API. Oltre il limite, l’API restituisce 429 con too_many_requests.

curl https://api.emailit.com/v2/emails/em_33VtK8mRq1xZp7LwN4cY2bHsDfa/forward \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "support@acme.com",
    "include_headers": true,
    "comment": "Customer says this receipt never arrived. Can you check?"
  }'

const forwarded = await emailit.emails.forward('em_33VtK8mRq1xZp7LwN4cY2bHsDfa', {
  to: 'support@acme.com',
  include_headers: true,
  comment: 'Customer says this receipt never arrived. Can you check?',
});

forwarded = client.emails.forward("em_33VtK8mRq1xZp7LwN4cY2bHsDfa", {
    "to": "support@acme.com",
    "include_headers": True,
    "comment": "Customer says this receipt never arrived. Can you check?",
})

$forwarded = $emailit->emails()->forward('em_33VtK8mRq1xZp7LwN4cY2bHsDfa', [
    'to' => 'support@acme.com',
    'include_headers' => true,
    'comment' => 'Customer says this receipt never arrived. Can you check?',
]);

La risposta è la stessa di una risposta di invio, più original_id e il messaggio «Email has been queued for forwarding». L’inoltro non riesce con 422 Cannot forward email se l’originale è un’email in entrata o il suo contenuto è stato eliminato.

Vedi anche

• Ritenta un’email
• Inoltra un’email
• Stati delle email
• Dettagli dell’email