Integrace

Napojte e-shop nebo web za pár minut

Hotová napojení pro nejčastější platformy. Všechna posílají e-maily z vaší ověřené domény a mají stejné doručenky, historii a webhooky jako REST API.

ke stažení

WooCommerce / WordPress

Plugin zdarma: REST API nebo SMTP, přílohy, doručenky v administraci.

připravujeme

Shoptet

Doplněk pro e-maily podle stavu objednávky z vlastní domény.

návody

SMTP relay

PrestaShop, WordPress bez pluginu a cokoli, co umí odesílat poštu.

dokumentace

API a SDK

REST API, OpenAPI, ukázky v PHP, Node.js, Pythonu.

WooCommerce a WordPress: plugin TopEmail

Plugin „TopEmail – transakční e-maily“ přesměruje veškerou odchozí poštu WordPressu, tedy i všechny e-maily WooCommerce, na TopEmail. Funguje i na webu bez WooCommerce (kontaktní formuláře, reset hesla, notifikace).

Ke stažení

Stáhnout plugin 1.0.0 (zip) →

Verze:        1.0.0
Vyžaduje:     WordPress 6.0+, PHP 7.4+
WooCommerce:  8.0 – 9.x (volitelné), HPOS
Licence:      GPLv2 or later
Zdroj:        topemail.cz/integrace (readme.txt v zipu)

Co plugin umí

→Všechny e-maily WordPressu a WooCommerce (wp_mail) včetně PDF faktur z fakturačních pluginů.
→Režim REST API s přílohami, Reply-To/Cc/Bcc, značkou objednávky (tags.order) a Idempotency-Key, nebo SMTP relay bez změny kódu.
→Záložní odeslání přes WordPress při výpadku (5xx, síť), chyby v logu WooCommerce.
→Posledních 10 e-mailů se stavem doručení v nastavení, testovací e-mail, ověření klíče.
→PHP 7.4+, WordPress 6.x, WooCommerce 8–9, HPOS. Bez externích knihoven. GPLv2.

Instalace krok za krokem

Stáhněte topemail-woocommerce-1.0.0.zip a nahrajte ho ve WordPressu přes Pluginy → Instalace pluginů → Nahrát plugin. Aktivujte.
V dashboardu TopEmail ověřte doménu e-shopu (DKIM, SPF, DMARC) a v sekci API klíče a SMTP vytvořte API klíč.
Otevřete WooCommerce → Nastavení → E-maily → TopEmail (bez WooCommerce Nastavení → TopEmail), vložte klíč clientId:secret a klikněte na „Ověřit API klíč“.
Vyplňte adresu a jméno odesílatele na ověřené doméně, zvolte režim API (doporučeno) nebo SMTP a uložte.
Pošlete si testovací e-mail. Stav doručení posledních e-mailů vidíte přímo v nastavení, úplnou historii v dashboardu.

[snímek obrazovky: nastavení pluginu, WooCommerce → E-maily → TopEmail]

[snímek obrazovky: přehled posledních e-mailů se stavem doručení]

[snímek obrazovky: značka objednávky v historii TopEmail]

Nechcete plugin? Postup s obecným SMTP pluginem je v návodu WooCommerce přes SMTP relay; verze bez pluginu přes phpmailer_init v článku WordPress a SMTP relay.

Shoptet: doplněk TopEmail připravujeme

Doplněk připravujeme ve spolupráci se Shoptetem (registrace partnera a schválení doplňku). Jakmile bude v nabídce doplňků, dáme vědět na této stránce a e-mailem zákazníkům TopEmail.

Shoptet odesílá systémové e-maily e-shopu sám a doplněk do nich nemůže zasahovat. Doplněk TopEmail proto posílá vlastní e-maily navíc, z vaší ověřené domény, s doručenkami a historií v TopEmail:

→Instalace jedním kliknutím v administraci Shoptetu (Doplňky), propojení s účtem TopEmail v dashboardu.
→E-maily při vytvoření objednávky a při změně stavu (odeslána, připravena k vyzvednutí, stornována…) podle vašich šablon: předmět a HTML se zástupnými symboly {{orderNumber}}, {{customerName}}, {{total}}, {{trackingUrl}}.
→Odesílatel na vaší ověřené doméně, volitelné Reply-To, značka objednávky pro párování doručenek.
→Žádný zásah do šablon Shoptetu; co jde nastavit přímo v administraci Shoptetu (odesílatel, DNS, DMARC), popisuje náš návod.

Do té doby: Shoptet a transakční e-maily z vlastní domény, co lze nastavit v administraci a jak posílat vlastní e-maily přes TopEmail API už dnes. Chcete být mezi prvními testujícími? Napište na info@topemail.cz.

WordPress a PrestaShop přes SMTP relay

Bez kódu a bez pluginu TopEmail: v nastavení odchozího serveru zadejte smtp.topemail.cz, port 587 (STARTTLS) nebo 465 (TLS), uživatel = clientId, heslo = secret z API klíče. Odesílatel musí být na ověřené doméně.

PrestaShop 8

Pokročilé parametry → E-mail: hodnoty pro smtp.topemail.cz, odesílatel, testovací e-mail, co zkontrolovat, když nechodí.

WordPress (WP Mail SMTP, FluentSMTP, bez pluginu)

Formuláře, reset hesla a notifikace přes relay; varianta přes konstanty ve wp-config.php a phpmailer_init.

WooCommerce přes SMTP plugin

Když nechcete náš plugin: WP Mail SMTP nebo FluentSMTP krok za krokem, kontrola From adresy.

E-maily z e-shopu padají do spamu

Proč PHP mail() nestačí a co relay s DKIM, SPF a DMARC změní.

API a SDK

Vlastní aplikace, fakturační systém nebo automatizace: jeden POST /api/email/send s JSON, autentizace API klíčem, stav doručení přes GET /api/email/{id} nebo webhook email.status.

→Dokumentace API a SMTP: požadavek, odpověď, webhooky, stavy e-mailů.
→OpenAPI specifikace pro generování klienta v libovolném jazyce.
→Ukázky: PHP, Node.js, Python / Django, Laravel, n8n a Make.

Chybí vám platforma?

Upgates, Shopify, OpenCart, Magento, vlastní systém: napište, co používáte, a připravíme návod nebo napojení.

Napsat →