Transakční e-maily představují způsob řešení pro one-to-one komunikaci s jednotlivými zákazníky. Na rozdíl od např. jednorázových kampaní se nejedná o standardní hromadnou komunikaci, která je ve většině schránek řazena do záložky „Hromadné“, „Nabídky“ atp., ale většinou přímo do Inboxu zákazníka.
Podle pravidel Seznam.cz a Gmail.com nesmějí takové e-maily obsahovat obchodní nabídky (jiné produkty, než měl např. zákazník v košíku nebo si koupil). V praxi sice toto pravidlo kontroluje nepříliš přesný robot, i přesto ale doporučujeme střídmější přístup.
Prakticky o jednorázové rozesílání jednotlivých e-mailů spouštěné provedením HTTP požadavku na danou URL adresu. Aplikace umožňuje připravit kampaň pro tento typ zpráv. Lze v ní nastavit adresu, jméno odesílatele a předmět zpráv. Obsah zprávy lze vytvořit v editoru, podobně jako u SimpleMailingu nebo Kampaní. Lze přidat I dynamický obsah, který je proměnný pro každý e-mail zvlášť.
Transakční e-maily lze spravovat v sekci Přímá komunikace. Pokud tato sekce není dostupná, je třeba vyžádat její aktivaci.
HTTP požadavek, který spouští rozesílku, může mít např. následující tvar:
https://app.emailmachine.cz/welcome_mails/1/send_mail
To je základní URL, kterou lze spustit konkrétní transakční e-mail. K této adrese je potřeba přidat ještě další upřesňující data. Parametry email_address a auth_token jsou povinné. Ostatní lze volit dle potřeby. Tato data lze přenášet buďto přímo v URL nebo jako dodatečná data k požadavku POST:
?email_address=recipient@address.mail&auth_token=abc123&data1=123&data2=456
Přesnou a funkční adresu lze zjistit v detailu kampaně Transakčních e-mailů. URL uvedené v tomto dokumentu jsou pouze názorné. Parametr email_address představuje adresu, na kterou chceme e-mail poslat. E-mail se odešle okamžitě po zadání požadavku. auth_token je bezpečnostní token, který vygeneruje aplikace.
Podle potřeby lze použít metody GET nebo POST.
HTTP požadavky lze omezit na základě IP protection. Tzn. požadavky půjde volat jenom z určité IP adresy. Povolené adresy lze editovat v detailu Transakčního e-mailu.
Výsledek akce lze zjistit sledováním HTTP návratových kódů (200 = OK, 40X = chyba) a textu, který se vypisuje jako odezva pro testování v internetovém prohlížeči (ok, protected, bad request).
E-mailové adresy, na které se rozesílá, lze ukládat do předem vytvořeného seznamu kontaktů. Stačí vybrat konkrétní seznam při vytváření nebo editaci transakčního e-mailu.
Dynamického obsahu lze dosáhnout pomocí tzv. Placeholderů. Pokud se v textu e-mailu objeví řetězec ve dvojitých složených závorkách, aplikace bude hledat odpovídající hodnotu v datech, které byly předané v HTTP požadavku (viz výše).
Pokud je v datech např. parametr se jménem
salutation=Ondřeji
a e-mail obsahuje placeholder,
{{salutation}} potom se při generování e-mailu tento placeholder nahradí za hodnotu Ondřeji.
Tímto způsobem lze do e-mailů vkládat I HTML kód (viz příklad 3).
Všechny placeholdery v e-mailu musí mít odpovídající data v HTTP požadavku!
1) Jednoduchý GET požadavek bez dodatečných dat:
https://app.emailmachine.cz/welcome_mails/12/send_mail?email_address=frantisek@seznam.cz&auth_token=jut684erv68
2) Požadavek POST:
https://app.emailmachine.cz/welcome_mails/5/send_mail
s datovou částí (e-mail obsahuje placeholdery - viz níže):
?email_address=matej@gmail.com&auth_token=re6jjj4z5te3&name=Josef&surname=Novotný
3) Použití programu curl k provedení POST požadavku z terminálu. Do e-mailu se vloží obrázek s odkazem na stránky seznam.cz pomocí placeholderu image:
curl -XPOST "https://app.emailmachine.cz/welcome_mails/1/send_mail" -H "Content-Type: application/json" --data '{ "auth_token":"s06XVoQAq4uwJICIhf3gfg", "email_address":"one@email.com", "image":"<a href="http://www.seznam.cz"><img src="https://www.seznam.cz/media/img/logo_v2.png" style="width: 100px;">" }'