Integrace Poštárny

Poštárna se napojí na e-shop a další systémy bez programování tam, kde to jde, a přes otevřené API tam, kde potřebujete vlastní řešení. Všechna napojení najdete v aplikaci v Nastavení › Datové zdroje.

Shoptet#

E-shop na Shoptetu napojíte bez programování:

• Import zákazníků a odběratelů: export zákazníků nebo odběratelů newsletteru ze Shoptetu nahrajete v Kontakty a seznamy › Importy. U exportu zákazníků rozhoduje o každém řádku sloupec souhlasu s newsletterem: kdo souhlas nemá, je zákazník bez marketingového souhlasu a e-maily nedostává.
• Feed objednávek: adresu exportu objednávek (orders.csv) zadáte jako feed objednávek. Poštárna ho stahuje každou hodinu a u exportu orders.csv ze Shoptetu načítá objednávky posledních 3 dnů každých 10 minut. Objednávky pohání automatizace po nákupu, segmenty podle nákupů a tržby ve statistikách. První stažení historie automatizace nespouští.
• Feed zákazníků: export zákaznických účtů jako feed načte zákazníky e-shopu do Poštárny a s objednávkami doplní data zákazníků: v Nastavení › E-shopy tlačítkem Doplnit údaje vyplníte prázdná pole kontaktů (jméno, telefon, firmu, adresu, jazyk, svátek a oslovení), nejdřív uvidíte náhled. Zákazník tím nevzniká jako odběratel a nezískává souhlas.
• Webtracking košíku: jeden řádek v patičce e-shopu posílá košíky známých zákazníků pro opuštěný košík.
• Pop-up formuláře: pop-up umí skrýt přihlášené zákazníky a zákazníky na stránce po objednávce.

Produktové feedy#

Produktový feed ve formátu Google Merchant, Heureka.cz nebo Zboží.cz (XML) zadáte adresou. Produkty z feedu pak vkládáte do e-mailů v Magic Editoru (obrázek, název, cena a odkaz se doplní samy) a páruje se s nimi položky objednávek. U feedu můžete zapnout automatické stahování jednou denně; limit je 20 MB a 50 000 položek.

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

Článkový feed ve formátu RSS 2.0 nebo Atom, například blog e-shopu, nabídne v editoru výběr článků do newsletteru.

Import CSV#

Kontakty z jiného systému nahrajete jako CSV (oddělovač středník, čárka nebo tabulátor, kódování UTF-8 nebo Windows-1250). Poštárna navrhne přiřazení sloupců podle záhlaví v češtině, slovenštině i angličtině, neplatné adresy přeskočí a odhlášené adresy nikdy znovu nepřihlásí. Import umí kontakty přidat nebo aktualizovat, jen aktualizovat, odhlásit z vybraných seznamů, z vybraných seznamů odebrat, nebo adresy přidat na blacklist. Postup přes API: Import kontaktů.

Přechod ze SmartEmailingu#

Kontakty, seznamy, odhlášení, blacklist, souhlasy, šablony a názvy automatizací jako koncepty přenesete sami pomocí API klíče, ve SmartEmailingu se nic nezmění. Volitelně běží hodinová synchronizace, dokud posíláte z obou systémů. Návod: Přechod ze SmartEmailingu.

API kompatibilní se SmartEmailingem#

Integrace napsaná pro REST API v3 SmartEmailingu funguje s Poštárnou po změně adresy, uživatelského jména a klíče: stejné cesty, obálky, chyby a stránkování pro čtení kontaktů, seznamů a vlastních polí, účtové webhooky a vybrané CSV statistiky. Kontakty a seznamy přes API v3 zatím nezapisujete, k tomu slouží API v1. Podrobnosti: kompatibilita se SmartEmailingem.

API v1#

Úplné REST API, stejné, jaké používá webová aplikace: kontakty a souhlasy, seznamy a segmenty, šablony, kampaně, automatizace, objednávky, feedy a slevové kupóny. Přihlášení API klíčem z Nastavení › Datové zdroje › API klíče, popis v OpenAPI 3.1. Objednávky z jiného e-shopu nebo pokladny zapíšete přes API, viz Objednávky, feedy a kupóny. Začněte API dokumentací.

Webhooky#

Účtové webhooky nastavíte v Nastavení › Datové zdroje › Webhooky (i s tlačítkem Otestovat) nebo přes API a pošlou na vaši adresu událost, když vznikne nebo se změní kontakt, kontakt se odhlásí, e-mail odejde, změní se stav doručení, nebo příjemce e-mail otevře či klikne. Strojová otevření a kliky webhook neposílá. V automatizaci je navíc uzel Webhook. Podrobnosti: webhooky.

MCP pro AI asistenty#

Server MCP (Model Context Protocol) propojí Poštárnu s AI asistenty, jako jsou ChatGPT, Claude nebo Cursor. Asistent se přihlásí přes OAuth nebo API klíčem a umí pracovat s kontakty, seznamy, segmenty, šablonami, kampaněmi, automatizacemi, formuláři, importy a statistikami. Odeslání skutečným lidem a mazání vždy vyžaduje náhled a potvrzení. Podrobnosti: MCP pro AI asistenty.