Opakované odeslání a přeposlání e-mailů

Opakované odeslání pošle e-mail se stejným obsahem znovu poté, co se nedoručil, selhal, byl zablokován nebo zadržen. Přeposlání pošle kopii už odeslaného e-mailu někomu jinému, například kolegovi z podpory nebo zákazníkovi, který originál ztratil. Obojí vytvoří nový e-mail s vlastním ID a původní e-mail nechá beze změny.

Než začnete

• V API fungují oba endpointy s klíči s oprávněním Full Access i Sending Only.
• Obojí se účtuje jako nové odeslání, takže potřebujete dost kreditů.
• Obojí potřebuje původní obsah zprávy. Emailit ho smaže, když skončí doba uchovávání dat pro obsah zpráv:

Odešlete e-mail znovu

E-mail lze odeslat znovu, pokud platí všechny tyto podmínky:

Opakované odeslání vytvoří nový e-mail s novým ID em_ a novým Message-ID. Použije surovou zprávu, příjemce, metadata a nastavení měření z originálu a projde běžným procesem doručení. Stojí 1 kredit, nebo 2 kredity, pokud byl originál e-mailem z kampaně. Workspace v režimu sandbox může znovu odesílat jen e-maily adresované členům workspace.

Před opakovaným odesláním odstraňte příčinu, jinak nový e-mail skončí ve stejném stavu:

• Zablokovaný: nejdřív odeberte adresu z blokovaných adres.
• Zadržený kvůli kreditům: dokupte kredity.
• Zadržený kvůli pozastavené doméně: vyřešte problém s kondicí odesílání.
• Zadržený kvůli skóre spamu: opakované odeslání pošle stejný obsah a pravděpodobně bude znovu zadrženo. Upravte obsah a místo toho odešlete nový e-mail. Viz Kontroly spamu.
• Nedoručený: zkontrolujte důvod nedoručení na stránce detailu e-mailu. Na schránku, která neexistuje, se e-mail znovu nedoručí. Pokud Emailit po nedoručení přidal adresu mezi vaše blokované adresy, nejdřív ji odeberte.

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"
}

Přepošlete e-mail

Přeposlání odešle odchozí e-mail, který jste už odeslali, novému příjemci. Příchozí e-maily přeposílat nelze.

Ve výchozím stavu je přeposlání prostým opětovným odesláním: příjemce dostane původní předmět, tělo a přílohy, jako by byl e-mail odeslán jemu. Nastavením include_headers místo toho odešlete klasické přeposlání s blokem „Forwarded message“ (původní From, Date, Subject a To) a volitelným komentářem nad ním. Předmět pak začíná na Fwd:.

Přeposlání je nové odeslání, takže se řídí stejnými pravidly jako POST /emails: platí kredity za příjemce, limity rychlosti odesílání, kontroly domény odesílatele i hlavička Idempotency-Key. Měření se řídí nastavením odesílací domény. Vlastní hlavičky a metadata originálu se nekopírují a přílohy se přenesou, jen pokud je jejich typ souboru povolený.

Každý workspace může odeslat 3 požadavky na přeposlání za hodinu, přičemž se přeposlání z webového rozhraní a z API sčítají. Při překročení limitu vrátí API 429 s 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?',
]);

Odpověď je stejná jako odpověď na odeslání, navíc obsahuje original_id a zprávu „Email has been queued for forwarding“. Přeposlání selže s 422 Cannot forward email, pokud je originál příchozí e-mail, nebo pokud byl jeho obsah smazán.

Související

• Opakované odeslání e-mailu
• Přeposlání e-mailu
• Stavy e-mailů
• Detail e-mailu