{"id":5575,"date":"2019-04-03T11:00:48","date_gmt":"2019-04-03T09:00:48","guid":{"rendered":"https:\/\/igloonet.cz\/blog\/?p=5575"},"modified":"2020-07-23T13:44:03","modified_gmt":"2020-07-23T11:44:03","slug":"prepojte-sa-s-mailkit-kniznicou","status":"publish","type":"post","link":"https:\/\/igloonet.cz\/blog\/prepojte-sa-s-mailkit-kniznicou\/","title":{"rendered":"Prepojte sa s Mailkit kni\u017enicou"},"content":{"rendered":"
<\/div>\n

M\u00e1te probl\u00e9my s doru\u010dite\u013enos\u0165ou mailov z e\u2011shopu? U\u0161etrite si pr\u00e1cu s napojovan\u00edm Mailkit API do vlastnej aplik\u00e1cie a pou\u017eite na\u0161u PHP<\/a>\/Nette<\/a> kni\u017enicu. Uvo\u013enili sme ju zdarma na stiahnutie na GitHube<\/a>.<\/p>\n

Probl\u00e9my s k\u00f3dovan\u00edm e\u2011mailov<\/b><\/h2>\n

Z poh\u013eadu be\u017en\u00e9ho u\u017e\u00edvate\u013ea je e\u2011mail jednoduch\u00e1 vec. Denne n\u00e1m ich do schr\u00e1nky pr\u00eddu desiatky a nap\u00edsanie\/odoslanie nie je  \u017eiadna veda. Z technick\u00e9ho h\u013eadiska to ale tak jednoduch\u00e9 nie je. Grafik mus\u00ed navrhn\u00fa\u0165 ich vzh\u013ead, HTML k\u00f3d sa p\u00ed\u0161e v tabu\u013ek\u00e1ch, obsahuje inline styly, a ak chceme nie\u010do prida\u0165 alebo upravi\u0165, je to dos\u0165 \u010dasto ve\u013ek\u00fd boj. A nie ka\u017ed\u00fd v\u00fdvoj\u00e1r m\u00e1 u seba nain\u0161talovan\u00fd mailserver, z ktor\u00e9ho si nech\u00e1 pri v\u00fdvoji aplik\u00e1cie zasiela\u0165 testovacie spr\u00e1vy.<\/span><\/p>\n

Uk\u00e1\u017eme si to na pr\u00edklade, kedy chceme z\u00e1kazn\u00edkovi odosla\u0165  inform\u00e1cie o sp\u00f4sobe platby. Ak si vybral prevod na \u00fa\u010det, mus\u00edme mu posla\u0165 \u010d\u00edslo \u00fa\u010dtu, na ktor\u00fd objedn\u00e1vku zaplat\u00ed. U platby kartou ho ale v\u00f4bec nepotrebuje a u osobn\u00e9ho odberu sk\u00f4r ocen\u00ed mapku s lok\u00e1ciou predajne. Program\u00e1tor tak mus\u00ed pr\u00e1cne rozdeli\u0165 \u0161abl\u00f3ny, doplni\u0165 premenn\u00e9 a prida\u0165 podmienky, ktor\u00e9 cel\u00fd k\u00f3d zna\u010dne znepreh\u013ead\u0148uj\u00fa a znepr\u00edjem\u0148uj\u00fa t\u00fdm pr\u00e1cu. To ani nehovor\u00edm o pr\u00edpadoch, kedy sa z\u00e1kazn\u00edk, ktor\u00e9mu tieto \u0161abl\u00f3ny implementujeme, rozhodne urobi\u0165 nejak\u00e9 grafick\u00e9 zmeny.<\/span><\/p>\n

Ako sa z toho nezbl\u00e1zni\u0165? Jedn\u00fdm z rie\u0161en\u00ed je pou\u017e\u00edva\u0165  webov\u00fa aplik\u00e1ciu, ktor\u00e1 umo\u017e\u0148uje jednoduch\u00fa tvorbu \u0161abl\u00f3n. Program\u00e1tor u\u017e len nastav\u00ed, kedy se m\u00e1 spr\u00e1va posiela\u0165  a ak\u00fdmi d\u00e1tami sa m\u00e1 naplni\u0165. Ur\u010dite sa k\u00f3dovan\u00edm nezbav\u00edme, ale minim\u00e1lne si pr\u00e1cu spr\u00edjemn\u00edme ak \u201ezas\u201c niekto pr\u00edde a bude chcie\u0165 upravi\u0165 nejak\u00fd \u201edetail\u201c. V igloonete k tomu vyu\u017e\u00edvame Mailkit<\/a>.<\/span><\/p>\n

<\/p>\n

Pre\u010do Mailkit?<\/b><\/h2>\n

Mailkit je \u010desk\u00fd n\u00e1stroj pre e\u2011mailing a SMS marketing, cez ktor\u00fd posielame klientom kampane. Osved\u010dil sa n\u00e1m hlavne kvalitnou doru\u010dite\u013enos\u0165ou a ve\u013emi pr\u00edjemnou pr\u00e1cou s drag and drop \u0161abl\u00f3nami, ktor\u00e9 je mo\u017en\u00e9 \u013eahko upravi\u0165, presne pod\u013ea potrieb klienta. <\/span><\/p>\n

\u010eal\u0161ou v\u00fdhodou je pokro\u010dil\u00e1 segment\u00e1cia datab\u00e1ze kontaktov, na z\u00e1klade napr\u00edklad n\u00e1kupn\u00e9ho chovania. M\u00f4\u017eete zacieli\u0165 kampane na najvernej\u0161\u00edch z\u00e1kazn\u00edkov alebo naopak na t\u00fdch, u ktor\u00fdch je najv\u00e4\u010d\u0161ie riziko prechodu ku konkurencii. O \u00favode do RFM anal\u00fdzy si pre\u010d\u00edtajte viac v \u010dl\u00e1nku \u201eRFM: Anal\u00fdza z\u00e1kazn\u00edk\u016f v kostce<\/a>\u201c. <\/span><\/p>\n

Prepojenie aplik\u00e1cie s Mailkit kni\u017enicou<\/b><\/h2>\n

Na z\u00e1klade spolupr\u00e1ce s Mailkitom sme vytvorili PHP a Nette kni\u017enicu, ktor\u00e1 e\u0161te viac u\u013eah\u010d\u00ed pr\u00e1cu s posielan\u00edm e\u2011mailov\u00fdch kampan\u00ed. Pre prepojenie s vlastnou aplik\u00e1ciou nepotrebujete ni\u010d zlo\u017eito in\u0161talova\u0165, sta\u010d\u00ed jeden pr\u00edkaz, ktor\u00fd priprav\u00ed pr\u00e1cu s API.<\/span><\/p>\n

$ composer require igloonet\/mailkit-api<\/span>\n<\/pre>\n
Jednoduch\u00e9, \u017ee? E\u0161te v\u00e1s ale nejak\u00e1 pr\u00e1ca \u010dak\u00e1. Z\u00edskan\u00e9 pr\u00edstupov\u00e9 \u00fadaje si pripravte pod\u013ea dokument\u00e1cie do <\/span>Client<\/code>.<\/span><\/p>\n
$clientId<\/span> = <\/span>'id'<\/span>;<\/span>\n$clientMd5<\/span> = <\/span>'md5'<\/span>;<\/span>\n$mailkitApi<\/span> = <\/span>new<\/span> \\Igloonet\\MailkitApi\\RPC\\Client(<\/span>$clientId<\/span>, <\/span>$clientMd5<\/span>);<\/span>\n<\/pre>\n
$ composer require igloonet\/nette-mailkit-api<\/span>\n\nextensions:<\/span>\n    <\/span>mailkitApi: Igloonet\\NetteMailkitApi\\DI\\MailkitApiExtension<\/span>\n<\/pre>\n
Nastavenie pr\u00edstupov\u00fdch \u00fadajov:<\/span><\/p>\n
mailkitApi:<\/span>\n    <\/span>clientId: ''<\/span>\n    <\/span>clientMd5: ''<\/span>\n<\/pre>\n
A nastavenie z\u00e1vislosti, napr\u00edklad takto:<\/span><\/p>\n
class<\/span> Mailer<\/span>\n{<\/span>\n    <\/span>\/** @var \\Igloonet\\MailkitApi\\MailkitApi *\/<\/span>\n    <\/span>private<\/span> $mailkitApi<\/span>;<\/span>\n\n    <\/span>public<\/span> function<\/span> __construct<\/span>(\\Igloonet\\MailkitApi\\MailkitApi <\/span>$mailkitApi<\/span>)<\/span>\n    <\/span>{<\/span>\n        <\/span>$this<\/span>->mailkitApi = <\/span>$mailkitApi<\/span>;<\/span>\n    <\/span>}<\/span>\n    <\/span>\/\/ ...<\/span>\n\n<\/pre>\n
Blaho\u017eel\u00e1me, v\u00e1\u0161 web je prepojen\u00fd s Mailkitom a m\u00f4\u017eete za\u010da\u0165 vyu\u017e\u00edva\u0165 cel\u00fa radu preddefinovan\u00fdch met\u00f3d pre pr\u00e1cu s u\u017e\u00edvate\u013emi. Po\u010fme si uk\u00e1za\u0165 p\u00e1r praktick\u00fdch pr\u00edkladov, ako je pridanie u\u017e\u00edvate\u013ea do datab\u00e1ze newsletterov, odoslanie transak\u010dn\u00e9ho e\u2011mailu alebo webhooky.<\/span><\/p>\n
Ako na datab\u00e1zu newsletterov?<\/b><\/h2>\n
Povedzme, \u017ee potrebujem prida\u0165 u\u017e\u00edvate\u013ea do datab\u00e1ze  za \u00fa\u010delom zasielania newsletterov.<\/span><\/p>\n
Pri klasickej implement\u00e1cii sa z\u00e1kazn\u00edk na webe prihl\u00e1si k odberu noviniek a syst\u00e9m odo\u0161le formul\u00e1r, \u010do ho prid\u00e1 do datab\u00e1ze. N\u00e1sledne mu pr\u00edde e\u2011mail s potvrdzuj\u00facim odkazom, na ktor\u00fd mus\u00ed klikn\u00fa\u0165. Do syst\u00e9mu teda mus\u00edme implementova\u0165 funk\u010dn\u00e9 generovanie t\u00fdchto odkazov, mo\u017enos\u0165 ich \u00faprav a priradenie k spr\u00e1vnemu z\u00e1kazn\u00edkovi.  <\/span>Uk\u00e1\u017eeme si, ako to \u013eahko urobi\u0165 pomocou na\u0161ej kni\u017enice.<\/span><\/p>\n
   <\/span>\/\/.....<\/span>\n    <\/span>$userManager<\/span> = <\/span>$this<\/span>->mailkitApi->getUserManager();<\/span>\n    <\/span>\/\/.....<\/span>\n<\/ pre>\n<\/pre>\n
Zavol\u00e1me met\u00f3du pridania u\u017e\u00edvate\u013ea<\/span><\/p>\n
   <\/span>\/\/.....<\/span>\n    <\/span>$user<\/span> = <\/span>new<\/span> User(<\/span>'example@example.cz'<\/span>)<\/span>\n    <\/span>$mailingListId<\/span> '12345'<\/span>; <\/span>\/\/ id n\u00e1\u0161ho mailinglistu pre newsletter<\/span>\n\n    <\/span>\/\/ pr\u00e1ve ono true na konci n\u00e1m zabezpe\u010d\u00ed zaslanie overovacieho e\u2011mailu.<\/span>\n    <\/span>$userManager<\/span>->addUser(<\/span>$user<\/span>, <\/span>$mailingListId<\/span>, <\/span>true<\/span>);<\/span>\n    <\/span>\n    <\/span>\/\/.....<\/span>\n<\/pre>\n
A to je v\u0161etko. Z\u00e1kazn\u00edka sme pridali do zoznamu, zaslal sa mu automaticky overovac\u00ed e\u2011mail a u\u017e mu m\u00f4\u017eeme veselo posiela\u0165 novinky a akcie z e\u2011shopu. Program\u00e1tor len prid\u00e1 uveden\u00fd k\u00f3d do met\u00f3dy, ktor\u00e1 sa vol\u00e1 po odoslan\u00ed formul\u00e1ra. Ako bude v\u00fdsledn\u00fd potvrdzovac\u00ed e\u2011mail vyzera\u0165 je \u00faplne na v\u00e1s.<\/span><\/p>\n
Transak\u010dn\u00e9 e\u2011maily<\/b><\/h2>\n
\u010eal\u0161ou neoddelite\u013enou s\u00fa\u010das\u0165ou, kde ide dobre vyu\u017ei\u0165 spom\u00ednan\u00fa kni\u017enicu, s\u00fa transak\u010dn\u00e9 e\u2011maily. Vyu\u017eijeme <\/span>messagesManager<\/code><\/span>.<\/span><\/p>\n
$messagesManager<\/span> = <\/span>$this<\/span>->mailkitApi->getMessagesManager();<\/span>\n\n$message<\/span> = <\/span>new<\/span> \\Igloonet\\MailkitApi\\DataObjects\\Message(<\/span>$user<\/span>);<\/span>\n$message<\/span>->setBody(<\/span>'test messages'<\/span>);<\/span>\n$campaignId<\/span> = <\/span>11111<\/span>; <\/span>\/\/id kampane vytvorenej v rozhran\u00ed mailkit <\/span>\n$result<\/span> = <\/span>$messagesManager<\/span>->sendMail(<\/span>$message<\/span>, <\/span>$mailingList<\/span>->getId(), <\/span>$campaignId<\/span>);<\/span><\/pre>\n
Tieto met\u00f3dy m\u00f4\u017eeme \u0161tandardne vyu\u017e\u00edva\u0165 na zasielanie ak\u00fdchko\u013evek e\u2011mailov, ktor\u00e9 aktu\u00e1lne potrebujeme. Napr\u00edklad na nap\u00edsanie aplik\u00e1cie, ktor\u00e1 n\u00e1m bude zasiela\u0165 v pl\u00e1novan\u00fd \u010das nejak\u00fa kampa\u0148.<\/span><\/p>\n
Ale vr\u00e1\u0165me se k transak\u010dn\u00fdm e\u2011mailom. Na za\u010diatok si ich mus\u00edme zvalidova\u0165 priamo v Mailkite. Bli\u017e\u0161ie inform\u00e1cie o tomto postupe n\u00e1jdete na <\/span>schvalovanie transak\u010dn\u00fdch kampan\u00ed<\/span><\/a>. Pred nastaven\u00edm si uvedomme, \u010do \u0161tandardne obsahuje v\u00e4\u010d\u0161ina e\u2011mailov o prijat\u00ed objedn\u00e1vky:<\/span><\/p>\n
Ak pou\u017e\u00edvate <\/span>Nette Framework<\/span><\/a> , sta\u010d\u00ed zaregistrova\u0165 len ako nov\u00fa extension.<\/span><\/p>\n