Integrácie Poštárne

Poštárna sa napojí na e-shop a ďalšie systémy bez programovania tam, kde to ide, a cez otvorené API tam, kde potrebujete vlastné riešenie. Všetky napojenia nájdete v aplikácii v Nastaveniach › Dátové zdroje.

Shoptet#

E-shop na Shoptete napojíte bez programovania:

• Import zákazníkov a odberateľov: export zákazníkov alebo odberateľov newslettera zo Shoptetu nahráte v Kontakty a zoznamy › Importy. Pri exporte zákazníkov rozhoduje o každom riadku stĺpec súhlasu s newsletterom: kto súhlas nemá, je zákazník bez marketingového súhlasu a e-maily nedostáva.
• Feed objednávok: adresu exportu objednávok (orders.csv) zadáte ako feed objednávok. Poštárna ho sťahuje každú hodinu a pri exporte orders.csv zo Shoptetu načítava objednávky posledných 3 dní každých 10 minút. Objednávky poháňajú automatizácie po nákupe, segmenty podľa nákupov a tržby v štatistikách. Prvé stiahnutie histórie automatizácie nespúšťa.
• Feed zákazníkov: export zákazníckych účtov ako feed načíta zákazníkov e-shopu do Poštárne a s objednávkami doplní dáta zákazníkov: v Nastaveniach › E-shopy tlačidlom Doplniť údaje vyplníte prázdne polia kontaktov (meno, telefón, firmu, adresu, jazyk, meniny a oslovenie), najprv uvidíte náhľad. Zákazník tým nevzniká ako odberateľ a nezískava súhlas.
• Webtracking košíka: jeden riadok v pätičke e-shopu posiela košíky známych zákazníkov pre opustený košík.
• Pop-up formuláre: pop-up vie skryť prihlásených zákazníkov a zákazníkov na stránke po objednávke.

Produktové feedy#

Produktový feed vo formáte Google Merchant, Heureka.cz alebo Zboží.cz (XML) zadáte adresou. Produkty z feedu potom vkladáte do e-mailov v Magic Editore (obrázok, názov, cena a odkaz sa doplnia samy) a párujú sa s nimi položky objednávok. Pri feede môžete zapnúť automatické sťahovanie raz denne; limit je 20 MB a 50 000 položiek.

Články z blogu (RSS a Atom)#

Článkový feed vo formáte RSS 2.0 alebo Atom, napríklad blog e-shopu, ponúkne v editore výber článkov do newslettera.

Import CSV#

Kontakty z iného systému nahráte ako CSV (oddeľovač bodkočiarka, čiarka alebo tabulátor, kódovanie UTF-8 alebo Windows-1250). Poštárna navrhne priradenie stĺpcov podľa hlavičky v slovenčine, češtine aj angličtine, neplatné adresy preskočí a odhlásené adresy nikdy znova neprihlási. Import vie kontakty pridať alebo aktualizovať, len aktualizovať, odhlásiť z vybraných zoznamov, z vybraných zoznamov odobrať alebo adresy pridať na blacklist. Postup cez API: Import kontaktov.

Prechod zo SmartEmailingu#

Kontakty, zoznamy, odhlásenia, blacklist, súhlasy, šablóny a názvy automatizácií ako koncepty prenesiete sami pomocou API kľúča, v SmartEmailingu sa nič nezmení. Voliteľne beží hodinová synchronizácia, kým posielate z oboch systémov. Návod: Prechod zo SmartEmailingu.

API kompatibilné so SmartEmailingom#

Integrácia napísaná pre REST API v3 SmartEmailingu funguje s Poštárňou po zmene adresy, používateľského mena a kľúča: rovnaké cesty, obálky, chyby a stránkovanie na čítanie kontaktov, zoznamov a vlastných polí, účtové webhooky a vybrané CSV štatistiky. Kontakty a zoznamy cez API v3 zatiaľ nezapisujete, na to slúži API v1. Podrobnosti: kompatibilita so SmartEmailingom.

API v1#

Úplné REST API, rovnaké, aké používa webová aplikácia: kontakty a súhlasy, zoznamy a segmenty, šablóny, kampane, automatizácie, objednávky, feedy a zľavové kupóny. Prihlásenie API kľúčom z Nastavení › Dátové zdroje › API kľúče, popis v OpenAPI 3.1. Objednávky z iného e-shopu alebo pokladne zapíšete cez API, pozri Objednávky, feedy a kupóny. Začnite API dokumentáciou.

Webhooky#

Účtové webhooky nastavíte v Nastaveniach › Dátové zdroje › Webhooky (aj s tlačidlom Otestovať) alebo cez API a pošlú na vašu adresu udalosť, keď vznikne alebo sa zmení kontakt, kontakt sa odhlási, e-mail odíde, zmení sa stav doručenia alebo príjemca e-mail otvorí či klikne. Strojové otvorenia a kliky webhook neposiela. V automatizácii je navyše uzol Webhook. Podrobnosti: webhooky.

MCP pre AI asistentov#

Server MCP (Model Context Protocol) prepojí Poštárnu s AI asistentmi, ako sú ChatGPT, Claude alebo Cursor. Asistent sa prihlási cez OAuth alebo API kľúčom a vie pracovať s kontaktmi, zoznamami, segmentmi, šablónami, kampaňami, automatizáciami, formulármi, importmi a štatistikami. Odoslanie skutočným ľuďom a mazanie vždy vyžaduje náhľad a potvrdenie. Podrobnosti: MCP pre AI asistentov.