Přehled změn: E-mailové API

Tlačítko Retry u zadrženého e-mailu teď funguje a Opakované odeslání e-mailu přijímá e-maily ve stavu held. Nejdřív odstraňte důvod, proč byl e-mail zadržen, například vysoké skóre spamu nebo chybějící kredity, a pak ho odešlete znovu.

Opakované odeslání vytvoří nový e-mail s novým ID a stojí kredity jako každé jiné odeslání. E-maily starší než 30 dní nebo e-maily, jejichž obsah už odstranilo uchovávání dat, znovu odeslat nelze. Viz Opakované odeslání a přeposlání.

Emailit porovná adresy v Reply-To a From bez ohledu na zobrazovaná jména a velikost písmen. Když jsou stejné, odstraní Reply-To ještě před podepsáním zprávy. Odpovědi dál dorazí na adresu From.

Když se adresy liší, Reply-To zůstane beze změny. Viz Hlavičky e-mailu.

• API i SMTP párují doménu v From bez ohledu na velikost písmen, takže ada@Acme.com odesílá z ověřené domény acme.com.
• Změna subdomény pro měření nebo příchozí subdomény domény ve webovém rozhraní nebo přes tracking_key a inbound_key v endpointu Úprava domény teď novou hodnotu uloží. Publikujte DNS záznam pro nový název a ověřte ho.

• API klíče vytvořené dřív, než klíče dostaly předponu secret_, se na /v2 opět přijímají.
• Načtení e-mailu vrací celý objekt e-mailu včetně object, from a to.
• Odpovědi pro domény vracejí track_loads a track_clicks jako 0, nebo 1, jak je zdokumentováno.

Požadavek na odeslání se zapnutým tracking dřív selhal s 422, když odesílací doména neměla ověřený CNAME záznam pro měření. Emailit teď e-mail přijme a odešle ho bez přepisu odkazů a bez pixelu pro měření otevření.

Pokud chcete měřit otevření a prokliky, publikujte pro svou doménu CNAME záznam pro měření a ověřte ho. Viz Vlastní doména pro měření.

Dočasná selhání se dřív zaznamenávala u doručení, ale e-mail si ponechal předchozí stav. Teď samotný e-mail přejde do stavu attempted, dokud ho Emailit zkouší doručit znovu, takže seznam e-mailů i API ukazují, které e-maily mají zpoždění.

Pozdější stavy, například delivered, a konečné stavy se nepřepisují. Viz Stavy e-mailů.

• Compose na stránce Emails nebo v Quick Actions na úvodní stránce webového rozhraní odešle jednorázový e-mail z ověřené domény, například pro otestování nastavení. V části Advanced můžete odeslání přiřadit k API klíči. Compose umožňuje 3 e-maily za minutu a 10 za hodinu na workspace. Viz Compose.
• Cancel delivery stáhne e-mail ve stavu accepted, scheduled nebo attempted z fronty. Zrušení není zaručené: e-mail, který se už předává serveru příjemce, se může přesto doručit. Viz Zrušení e-mailu.

Na stránce detailu e-mailu vyberte Forward, nebo zavolejte Přeposlání e-mailu s adresou to. Ve výchozím stavu příjemce dostane prostou kopii. Pokud chcete přidat kontext, zapněte přeposlané hlavičky a přidejte komentář.

Přeposlání je nový e-mail: stojí kredity a započítává se do limitů odesílání. Ve workspace můžete přeposlat 3 e-maily za hodinu. Viz Opakované odeslání a přeposlání.

Pravidlo sandboxu teď platí pro API, SMTP, Compose, opakovaná odeslání, automatizace i kampaně. Odeslání komukoli jinému vrátí v API 403 s kódem unverified_workspace_recipient a v SMTP 550 a odeslání kampaní se zablokuje. Workspace s produkčním přístupem se to netýká.

Pokud chcete omezení zrušit, ověřte doménu a požádejte o produkční přístup.

Klíče jen pro odesílání dřív mohly vypisovat a načítat e-maily a volat některé další endpointy pro čtení. Teď jsou omezené na Odeslání e-mailu a akce s existujícím e-mailem: přeplánování, zrušení, opakované odeslání a přeposlání. Ostatní endpointy klíče pro odesílání odmítnou.

Pokud vaše integrace čte také e-maily, domény nebo jiné zdroje, použijte pro tato volání klíč s plným přístupem. Viz API klíče.

• Výpis e-mailů: GET /v2/emails
• Načtení surového MIME: GET /v2/emails/:id/raw
• Načtení těla e-mailu: GET /v2/emails/:id/body
• Načtení metadat: GET /v2/emails/:id/meta
• Výpis příloh: GET /v2/emails/:id/attachments

Tyto endpointy potřebují klíč s plným přístupem. Obsah je dostupný, dokud ho neodstraní doba uchovávání dat vašeho tarifu.

Existující e-maily a doručení jsme převedli na nové názvy. Události a požadavky webhooků vytvořené před změnou si ponechávají hodnoty, se kterými byly odeslány. Aktuální seznam najdete na stránce Stavy e-mailů.

Šablony vytvoříte v HTML editoru, v editoru formátovaného textu nebo v drag & drop editoru Dragit. Šablony se stejným aliasem jsou verze jedné šablony a při odeslání podle aliasu se použije jen publikovaná verze.

Šablony spravujte přes API pro šablony a šablonu odešlete předáním polí template a variables endpointu Odeslání e-mailu. Viz Šablony.

Retry vytvoří kopii původního e-mailu, přidělí jí nové ID a odešle ji běžnou cestou. Účtuje se jako každý nový e-mail. Pokud chcete e-mail odeslat znovu z kódu, zavolejte Opakované odeslání e-mailu.

• Odeslání e-mailu: každý příjemce dostane vlastní ID e-mailu. Odeslání naplánujete datem ve formátu ISO 8601, unixovým časovým razítkem nebo přirozeným jazykem, například „tomorrow at 9am“, a duplicitám předejdete hlavičkou Idempotency-Key.
• Načtení e-mailu: stav, hlavičky, obsah, nastavení měření a metadata.
• Úprava naplánovaného e-mailu: čas odeslání můžete změnit nejpozději 3 minuty předtím, než nastane.
• Zrušení e-mailu: zastavte naplánovaný e-mail nebo e-mail ve frontě.

Každá odpověď na odeslání obsahuje hlavičky ratelimit-*. Viz Limity rychlosti.

Požadavky nad limit se odmítnou, místo aby se zařadily do fronty, takže klienta nastavte tak, aby odesílal nejvýše 2 e-maily za sekundu, nebo aby odmítnutá odeslání zopakoval. Změna se do workspace zaváděla postupně.

Viz Limity rychlosti.