Shoptet a transakční e-maily z vlastní domény: co jde nastavit v administraci a kdy přidat TopEmail API

Shoptet je pronajatá platforma: e-maily o objednávkách, expedici a registraci odesílá sám ze své infrastruktury a vy do procesu odesílání přímo nesaháte. To je většinou výhoda, protože Shoptet má vlastní SPF, DKIM a lidi, kteří reputaci hlídají. Přesto existují tři situace, kdy e-mail ze Shoptetu řešit musíte: když e-maily chodí s poznámkou „via" nebo do spamu, protože nemáte správně DNS; když má vaše doména přísnou DMARC politiku; a když chcete posílat vlastní e-maily mimo šablony Shoptetu. Tenhle článek odděluje, co jde nastavit v administraci Shoptetu, a co řešit přes TopEmail API.

Co odesílá Shoptet a co ovlivníte

Shoptet posílá všechny systémové e-maily e-shopu: potvrzení objednávky, změny stavu, registraci, zapomenuté heslo, upozornění provozovateli. Jejich obsah upravujete v administraci v šablonách e-mailů, adresu odesílatele v kontaktních údajích e-shopu. Technickou cestu odeslání (server, IP adresy, podpis) určuje Shoptet.

Vlastní odchozí SMTP server v Shoptetu obecně nastavit nejde tak, jako v PrestaShopu nebo WooCommerce. Zda to umožňuje váš tarif nebo nějaký doplněk, se v čase mění, takže to nebudeme tvrdit ani vyvracet: zeptejte se podpory Shoptetu, co je pro váš tarif dostupné. Pokud odpověď bude ano, hodnoty jsou standardní: smtp.topemail.cz, port 587, TLS, uživatel CLIENT_ID, heslo SECRET, odesílatel na ověřené doméně.

Pokud ne, nic se neděje. Systémové e-maily nechte Shoptetu, nastavte správně DNS, a vlastní e-maily posílejte přes API.

DNS pro vlastní doménu: nejčastější zdroj problémů

Když posíláte z objednavky@vas-eshop.cz přes servery Shoptetu, musí vaše doména příjemcům říct, že Shoptet smí posílat jejím jménem. To znamená:

1. SPF: do TXT záznamu domény přidat include: servery Shoptetu. Přesnou hodnotu najdete v nápovědě nebo administraci Shoptetu; neopisujte ji z cizích návodů, může být zastaralá. Na doméně smí být jen jeden SPF záznam, takže pokud už jeden máte (Google Workspace, Microsoft 365), nový include: přidejte do něj.
2. DKIM: Shoptet poskytuje záznam (typicky CNAME nebo TXT se selektorem) pro podepisování vaší doménou. Bez něj se e-mail podepíše doménou Shoptetu a Gmail zobrazí „via".
3. DMARC: záznam _dmarc.vas-eshop.cz s p=none a adresou pro reporty. Pokud máte p=quarantine nebo p=reject a Shoptet není zarovnaný (bod 1 a 2), vaše potvrzení objednávek končí ve spamu nebo jsou odmítnuta.

Pokud budete zároveň posílat přes TopEmail, přidejte do stejného SPF záznamu include:spf.topemail.cz a vložte TXT záznam topemail._domainkey. Dvě služby vedle sebe si nevadí: každá má vlastní DKIM selektor a v SPF jsou dvěma include:. Jak všechno zkontrolovat, popisuje návod k SPF, DKIM a DMARC.

Kontrola: pošlete si testovací objednávku na Gmail, otevřete e-mail, tři tečky → Zobrazit originál. SPF, DKIM i DMARC musí být PASS a DKIM podpis musí mít d=vas-eshop.cz.

Kdy přidat TopEmail: vlastní e-maily mimo Shoptet

Shoptet pošle to, co má v šablonách. Jakmile chcete něco navíc, potřebujete vlastní odesílání:

• faktura nebo dobropis z vlastního fakturačního procesu,
• připomínka nevyzvednuté zásilky nebo prosba o recenzi 14 dní po doručení (pozor na hranici mezi transakčním a obchodním sdělením),
• e-maily z věrnostního programu, dárkové poukazy, B2B ceníky,
• notifikace skladu, dodavatelům nebo dopravci.

Tyhle e-maily vznikají mimo Shoptet, ve vašem systému, a odtud je pošlete přes API.

Architektura: Shoptet → váš server → TopEmail

Shoptet umí při událostech (vytvoření objednávky, změna stavu) zavolat webhook na vaši adresu; dostupnost a seznam událostí závisí na Shoptet API a oprávněních vašeho doplňku. Váš server (malá aplikace, serverless funkce, nebo automatizace v n8n či Make) událost přijme, dohledá si detaily objednávky přes Shoptet API a pošle e-mail přes TopEmail.

Shoptet  --webhook order:update-->  váš server  --POST /api/email/send-->  TopEmail  --> zákazník
                                        ^                                      |
                                        +------- webhook email.status ---------+

Minimální odesílací část v Node.js:

const res = await fetch('https://topemail.cz/api/email/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer CLIENT_ID:SECRET',
    'Content-Type': 'application/json',
    'Idempotency-Key': `order-${order.code}-review-request`,
  },
  body: JSON.stringify({
    from: 'Můj e-shop <info@vas-eshop.cz>',
    to: [order.email],
    subject: `Jak jste spokojeni s objednávkou ${order.code}?`,
    html: `<p>Dobrý den, …</p>`,
    text: 'Dobrý den, …',
    replyTo: 'podpora@vas-eshop.cz',
    tags: { order: order.code, type: 'review-request' },
  }),
})
const data = await res.json()
if (!res.ok) throw new Error(`${data.code}: ${data.error}`)
// data.emails[0].id si uložte k objednávce

Tři věci, na kterých to stojí:

1. Idempotency-Key odvozený z objednávky a typu e-mailu. Shoptet může webhook poslat dvakrát, váš server může spadnout po odeslání a před uložením; se stabilním klíčem e-mail podruhé neodejde (platí 24 hodin).
2. Značky (tags) s kódem objednávky. Vrátí se ve webhooku email.status, takže stav doručení spárujete bez databázového hledání.
3. Reply-To na podporu, pokud From je info@ nebo něco, co nikdo nečte.

Odpověď API je { ok, emails: [{ id, to, status }], price }. Uložte si id; stav zjistíte přes GET /api/email/{id} nebo z webhooku, jehož podpis X-TopEmail-Signature ověříte podle návodu k webhookům.

Pokud nechcete programovat, totéž postavíte v n8n nebo Make z Webhook triggeru a HTTP Request nodu; postup je v samostatném článku.

Oddělte systémové a vlastní e-maily

Praktické doporučení: nechte systémové e-maily Shoptetu z objednavky@vas-eshop.cz a vlastní e-maily posílejte z jiné adresy na téže doméně, například info@ nebo pece@vas-eshop.cz. Zákazník vidí jednu doménu, vy máte v DMARC reportech a ve statistikách jasně odděleno, co posílá kdo. Pokud něco začne padat do spamu, hned víte, který kanál to je.

Shrnutí

Shoptet posílá systémové e-maily sám; vaší prací je mít správně SPF (jeden záznam, include: Shoptetu), DKIM záznam od Shoptetu a DMARC, které e-maily zarovnají s vaší doménou. Vlastní SMTP server si ověřte u podpory Shoptetu podle tarifu. Všechno, co jde nad rámec šablon Shoptetu, pošlete z vlastního systému přes TopEmail API s Idempotency-Key a značkami, ze stejné domény s přidaným include:spf.topemail.cz a topemail._domainkey. Cena je 0,06 Kč za e-mail, prvních 1 000 měsíčně zdarma; další dotazy k Shoptetu najdete v FAQ.