Klára Šumberová
Propojení Shoptet Premium s Boldem umožňuje přenášet do Boldem data o objednávkách, opuštěných košících, návštěvách stránek, produktech a zákaznících e-shopu a dále s nimi pracovat v rámci marketingové komunikace.
Součástí propojení je také možnost řešit vlastní vzhled transakčních e-mailů, které informují zákazníka o změně stavu objednávky. Toto řešení je dostupné pouze pro zákazníky využívající Shoptet Premium.
Aktualizace dat ze Shoptetu do Boldem probíhá v reálném čase.
Předpoklady
Aby bylo možné vytvořit propojení Shoptet Premium s Boldem a odesílat transakční e-maily o změně stavu objednávky přes Boldem, je nutné splnit následující:
Postup propojení Boldem a Shoptet Premium
- Přihlaste se do administrace Shoptetu a přejděte do Propojení → Private API.
- Klikněte na Přidat a vytvořte nový API klíč a vhodně si jej pojmenujte, např. Propojení s Boldem.
- Doporučujeme pro Boldem vytvořit nový samostatný API klíč.
- API klíč si zkopírujte – budete ho potřebovat při vytváření propojení v Boldem.
- Přihlaste se do svého účtu Boldem.
- Jako první si musíte vytvořit seznam příjemců, do kterého si přejete kontakty z e-shopu importovat. V případě, že jej vytvořený nemáte, vyberte v levé nabídce aplikace Boldem Seznamy příjemců a vytvořte si nový.
- V Nastavení vyberte Propojení a klikněte na Nové propojení.
- Jako typ propojení zvolte Shoptet Premium.
- Vyberte Seznam příjemců, do kterého si přejete importovat příjemce z e-shopu a dále zvolte ID webové stránky.
Pro jednu URL může existovat pouze jedno propojení. Pokud již existuje, uložení neproběhne.
- Do pole API klíč vložte dříve zkopírovaný klíč ze Shoptetu (viz bod 3).
- Klikněte na tlačítko Otestovat propojení a následně Uložit a pokračovat.
Transakční e-maily
- Pro nastavení transakčních e-mailů klikněte na Nastavit propojení.
- Povolte možnost Posílat e-maily o objednávkách a následně vpravo nahoře klikněte na Uložit.
Po propojení se automaticky načtou stavy objednávek ze Shoptetu a zobrazí se v nabídce Vyberte kategorii objednávky. Pro každý stav objednávky zvolte transakční šablonu, která bude zákazníkovi odeslána.
Po výběru klikněte na Nastavit kombinaci kategorie/šablony.
Zobrazí se vám modální okno s aktuálně zvolenou kombinací. Zde si můžete určit, zda se e-mail odešle zákazníkovi / operátorovi.
U operátorů lze zadat více e-mailových adres, oddělujte je znakem „;“ nebo „|“.
Dále si můžete nastavit, zda chcete k e-mailu přikládat fakturu, dodací list, zda chcete načítat aktuální data o produktech apod.
Zasílaná rekapitulace objednávky může obsahovat i statický soubor, např. obchodní podmínky, které budou přiloženy k e-mailu jako příloha.
Pokud e-maily teprve připravujete, nechte zatržítko Posílat zákazníkovi zašedlé a e-maily si nechte zasílat pouze na svůj e-mail.
Jak propojení funguje?
Při notifikaci ze Shoptetu o tom, že stav objednávky byl změněn, zkontrolujeme, zda pro daný stav objednávky máme nastavenou kombinaci se šablonou. Pokud vhodnou kombinaci najdeme, připraví se k odeslání transakční e-mail.
Do proměnné v e-mailu jsou vložená data o objednávce – datový model ShoptetOrderModel.
Data si v šabloně můžete vypsat pomocí objektu „order“. Například pro výpis ID objednávky můžete použít {{ order.code }}.
Ukázka:
Dobrý den,{{if order.billingAddress.firstName != null}} {{vokativ order.billingAddress.firstName}},{{end}}
Vaši objednávku č. {{order.code}} jsme v pořádku přijali.
O dalším průběhu Vás budeme informovat.Ukázka výpisu celé fakturační adresy:
{{if order.billingAddress != null}}
{{if order.billingAddress.fullName != null}}{{order.billingAddress.fullName}}<br/>{{end}}
{{if order.billingAddress.company != null}}{{order.billingAddress.company}}<br/>{{end}}
{{if order.billingAddress.street != null || order.billingAddress.houseNumber != null}}{{if order.billingAddress.street != null}}{{order.billingAddress.street}}{{end}}{{ if order.billingAddress.houseNumber != null}}{{order.billingAddress.houseNumber}}{{end}}<br/>{{end}}
{{if order.billingAddress.city != null}}{{order.billingAddress.city}}<br/>{{end}}
{{if order.billingAddress.zip != null}}{{order.billingAddress.zip}}<br/>{{end}}
{{if order.billingAddress.countryCode != null}}
{{getCountryName(order.billingAddress.countryCode)}}
{{end}}
{{end}}Testování e-mailů
Nastavení můžete otestovat pomocí tlačítka Poslat testovací e-mail.
Postup:
- Klikněte na tlačítko Poslat testovací e-mail.
- Zadejte ID objednávky ze Shoptetu.
ID získáte v administraci Shoptetu, vybírejte pouze objednávky ve stavu, které máte nakonfigurovány v kombinaci se šablonou.
Pomocné funkce pro filtrování
Pro pomocné funkce doporučujeme vytvořit vlastní HTML šablonový blok (v sekci Nastavení/Šablonové bloky), který budete načítat ve všech transakčních šablonách pro Shoptet, např. pod názvem customFunctions. Do tohoto bloku můžete v jazyce Scriban definovat pomocné funkce, které vám mohou pomoci ve skládání transakčního e-mailu.
Například si můžete rozdělit položky objednávky na produkty, dopravu a poplatky za platbu:
{{ func filterForProducts(item)
ret item.itemType == 'product'
end }}
{{ func filterForShipping(item)
ret item.itemType == 'shipping'
end }}
{{ func filterForPayment(item)
ret item.itemType == 'billing'
end }}
{{products = array.filter order.items @filterForProducts}}
{{shippings = array.filter order.items @filterForShipping}}
{{payments = array.filter order.items @filterForPayment}}V samotné šabloně pak tento blok načtete přidáním následujícího kódu na začátek šablony:
{{ include 'customFunctions' }}Propsání informace o odeslání e-mailů zpět do Shoptetu
Pokud chcete zasílat zpět do Shoptetu informaci o tom, jaký e-mail byl zákazníkovi odeslán, je možné zapnout tuto funkci pomocí Uložit poznámku.
Po úspěšném zpracování je do historie objednávky v Shoptetu informace propsána.
Ukázka zapsání poznámky v Shoptetu:
Zastavení odesílání e-mailů
Pokud pro některé případy nechcete zákazníkům posílat e-maily o objednávce, stačí do poznámky objednávky napsat text „[BOLDEM_STOP]“. Boldem při načítání objednávky ze Shoptet API tuto poznámku vyhodnotí a e-mail nebude zákazníkovi odeslán.
