Novinka Spustili jsme novou aplikaci NG Emailing. Proč vznikla a co je v ní jinakNová aplikace: proč vznikla

Transakční e-maily přes API

Potvrzení a upozornění posíláte ze stejné domény jako kampaně. Každou zprávu dohledáte.

  • Až 50 příjemců v jednom požadavku
  • Podepsané webhooky o stavu zpráv
  • Součást placených tarifů

Začnete zdarma a bez platební karty.

Co je transakční e-mail

Transakční e-maily jsou zprávy, které váš systém posílá jednotlivým příjemcům, například potvrzení objednávky nebo obnovu hesla. V NG Emailingu je odešlete přes API podle publikované šablony. Když požadavek po výpadku zopakujete se stejným klíčem, druhý e-mail neodejde.

Odeslání přes API podle šablony

Váš systém pošle požadavek s ID šablony, adresou příjemce a hodnotami vstupních polí. Aplikace zprávu sestaví, zařadí do fronty a odešle z vaší domény. Záložka „Začínáme“ vás provede prvním e-mailem ve 4 krocích s příkladem v cURL, PHP a Node.

  • Jedna zpráva, nebo dávka až 50 příjemců
  • Až 64 vstupních polí: text, číslo, datum, odkaz a další
  • Testovací klíč požadavek jen nasimuluje a nic neodešle
Začínáme s API ve čtyřech krocích s ukázkou požadavku na my.ngemailing.cz

Log zpráv a diagnostika doručení

Záložka „Zprávy“ ukazuje každou zprávu se stavem. Filtrujete podle období, stavu, šablony, reference nebo adresy. Detail zprávy ukáže průběh od přijetí po doručení a u problému jeho konkrétní důvod.

  • Stav „Odesláno“ se nevydává za „Doručeno“
  • Čekající zprávu zrušíte v aplikaci i přes API
  • Frontu projektu pozastavíte a obnovíte
  • Data jednoho příjemce na jeho žádost vypíšete a smažete
Seznam transakčních zpráv s časem, příjemcem, stavem doručení a šablonou

Transakční e-maily podrobněji

Šablony s neměnnou publikovanou verzí

Transakční šablonu připravíte v editoru z bloků nebo z vlastního HTML a publikujete. Publikovaná verze se nemění. Úpravu uděláte jako kopii s novým ID, takže napojený systém dostává stejný obsah, dokud ho nepřepnete.

  • Seznam položek pro opakované řádky v šablonách z vlastního HTML
  • Sdílení šablony mezi projekty, třeba z testovacího do ostrého
  • Volitelné měření otevření a prokliků u každé šablony
  • Ruční test: zkušební zprávu pošlete přímo z aplikace

Webhooky a bezpečné opakování

Webhook pošle na adresu ve vašem systému podepsanou zprávu o stavu e-mailu. Když požadavek po výpadku zopakujete se stejným klíčem Idempotency-Key, druhý e-mail neodejde. Při nejasném výsledku předání aplikace zprávu sama znovu neposílá.

  • Události o stavu zpráv, při zapnutém měření i otevření a kliknutí
  • Historie doručení webhooku a zkušební událost
  • Opakování webhooku nikdy neodešle další e-mail

Co umí transakční e-maily v NG Emailingu

Odeslání přes APIZpráva nebo dávka až 50 příjemců podle ID šablony.
Transakční šablonyŠablona s neměnnou publikovanou verzí a popsanými vstupními poli.
Seznam položekOpakované řádky ve zprávě, například položky objednávky. V šablonách z vlastního HTML.
Log zprávStav každé zprávy, pokusy o doručení a důvod nedoručení.
Ruční testOdeslání zkušební zprávy přímo z aplikace.
Řízení frontyPozastavení a obnovení fronty, zrušení čekající zprávy.
WebhookyPodepsané události o stavu zpráv na adresu ve vašem systému.
Volitelné měřeníOtevření a prokliky zapnete u šablony, citlivé odkazy se nepřepisují.
Bezpečné opakováníOpakovaný požadavek se stejným klíčem nepošle druhý e-mail.
Výmaz dat příjemceSmazání transakčních dat jednoho příjemce, v aplikaci i přes API.

Co zatím neumí

  • Přílohy k transakčním zprávám přidat nejde.
  • Odesílá se jen přes API. Odesílání přes SMTP aplikace nenabízí.
  • Transakční e-maily jsou v placených tarifech a počítají se do stejného limitu e-mailů jako kampaně.

Časté dotazy

Nenašli jste odpověď? Napište na podpora@ngemailing.cz nebo se podívejte do všech dotazů.

Čím se liší transakční e-mail od kampaně?

Kampaň je hromadná rozesílka pro lidi, kteří souhlasili s odběrem. Transakční e-mail posílá váš systém jednomu příjemci jako reakci na jeho akci, například potvrzení objednávky nebo obnovu hesla.

Potřebuju k transakčním e-mailům programátora?

Ano, napojení na API udělá vývojář. Šablony a texty zpráv pak upravujete v aplikaci sami. Dokumentace API je veřejná a obsahuje příklady.

Jsou transakční e-maily v tarifu Free?

Ne. Transakční e-maily se odesílají přes API a to je součástí placených tarifů. Placené tarify začínají od 100 Kč měsíčně bez DPH.

Počítají se transakční e-maily do limitu tarifu?

Ano. Transakční e-maily a kampaně mají společný limit e-mailů. Na stránce tarifu vidíte rozpad čerpání na kampaně a transakční e-maily.

Co když můj systém pošle stejný požadavek dvakrát?

Ke každému požadavku posíláte vlastní klíč Idempotency-Key. Když se požadavek se stejným klíčem zopakuje, druhý e-mail neodejde.

Jak zjistím, jestli transakční e-mail dorazil?

Stav každé zprávy vidíte v logu zpráv a váš systém ho dostane webhookem. U nedoručené zprávy je uvedený důvod.

První kampaň můžete odeslat ještě dnes

Začnete zdarma a bez platební karty. Stačí ověřit doménu, nahrát kontakty a vybrat šablonu.

Free: 100 kontaktů a 200 e-mailů měsíčně.

Používáme nezbytné cookies. Se souhlasem také měříme návštěvnost a reklamu (Google Analytics, Google Ads). Podrobnosti