SMS notifikace pro WooCommerce: oficiální plugin TopSMS

Dosud jste SMS z WooCommerce posílali přes náš REST API snippet ve functions.php. Od dneška to jde bez kódu: vydali jsme oficiální plugin TopSMS pro WooCommerce. Nainstalujete ZIP, vložíte API klíč, zapnete stavy objednávky a hotovo.

Proč SMS o stavu objednávky

E-mail o odeslání zásilky skončí v záložce Promotions nebo ve spamu a zákazník ho otevře, až když si vzpomene. SMS vidí na zamčené obrazovce hned. Pro e-shop to znamená méně dotazů „kde je moje objednávka" a méně nevyzvednutých balíků, protože zákazník ví, kdy zásilka vyrazila. Podrobněji jsme to rozebrali v článku SMS notifikace pro WooCommerce, Shopify a Shoptet.

Co plugin dělá

• SMS zákazníkovi při změně stavu objednávky. Každý stav (čeká na platbu, zpracovává se, dokončena, zrušena, vrácena, platba selhala, i vlastní stavy) si zapnete zvlášť a upravíte jeho text. Každý stav se oznámí jednou za objednávku, takže zákazník nedostane dvě stejné SMS, když objednávku v administraci přepnete tam a zpět.
• SMS majiteli o nové objednávce hned po dokončení pokladny: číslo, částka, jméno, způsob platby.
• Šablony s makry: {order_number}, {first_name}, {last_name}, {total}, {status}, {payment_method}, {shipping_method}, {order_date}, {shop_name}, {site_url}.
• Vlastní odesílatel (Sender ID) schválený pro váš účet.
• Normalizace čísel: „608 123 456", „0905 123 456" i „00420…" se převedou na mezinárodní formát podle fakturační země zákazníka.
• Odesílání na pozadí přes Action Scheduler, pokladna na SMS bránu nečeká.
• Poznámka v objednávce a log posledních zpráv ve WooCommerce → SMS log, včetně chybové hlášky brány, když se něco nepovede.
• Testovací tlačítko v nastavení: ověří připojení, ukáže kredit a pošle SMS na vaše číslo.
• Podpora HPOS (nové úložiště objednávek), klasické i blokové pokladny. Česky i anglicky.

Instalace krok za krokem

1. Stáhněte ZIP pluginu (27 kB).
2. Ve WordPressu: Pluginy → Instalace pluginů → Nahrát plugin, vyberte ZIP, aktivujte. WooCommerce musí být aktivní.
3. V dashboardu TopSMS, sekce API vytvořte API klíč s oprávněními send a read.
4. WooCommerce → Nastavení → TopSMS: vložte klíč ve tvaru clientId:secret a klikněte na Ověřit připojení.
5. Zapněte stavy, které mají SMS spustit. Výchozí jsou „zpracovává se" (přijetí objednávky) a „dokončena" (předání dopravci).
6. Zapněte SMS o nové objednávce na své číslo, pokud ji chcete, a pošlete si testovací SMS.

Celé nastavení zabere pár minut. Když si nebudete vědět rady, napište na info@topsms.cz, s nastavením pomůžeme zdarma.

Šablony: krátké a bez diakritiky, nebo s diakritikou a kratší

Výchozí text pro stav „zpracovává se":

{shop_name}: děkujeme, přijali jsme vaši objednávku {order_number} ({total}) a připravujeme ji k odeslání.

Text s diakritikou má 70 znaků na jednu SMS, bez diakritiky 160 znaků. Delší zpráva se rozdělí na části a každá se účtuje zvlášť, proto jsou výchozí šablony krátké. Pokud chcete ušetřit, pište bez háčků a čárek. Kolik SMS text spotřebuje, spočítá kalkulačka délky SMS.

Vlastní odesílatel

Místo výchozího odesílatele může zákazník vidět název vašeho e-shopu (3 až 11 znaků bez diakritiky). Žádost o Sender ID podáte v dashboardu. Operátoři schvalují nové odesílatele hromadně, obvykle několikrát měsíčně, počítejte s 1 až 2 týdny. Do té doby nechte pole v pluginu prázdné.

Co to stojí

Plugin je zdarma, bez měsíčního poplatku a s licencí GPL. Platíte jen odeslané SMS z kreditu účtu TopSMS podle ceníku. Testovací SMS se účtuje jako každá jiná.

Pro vývojáře

Plugin volá endpointy /api/sms/send a /api/credit našeho REST API a přenáší jen telefon příjemce, text zprávy, Sender ID a adresu e-shopu. Odesílání jde přes as_enqueue_async_action; bez Action Scheduleru se pošle synchronně. K dispozici jsou filtry topsms_wc_recipient_phone, topsms_wc_message_text a topsms_wc_should_send a akce topsms_wc_sms_sent. Chyby brány najdete i ve WooCommerce → Stav → Logy pod zdrojem topsms.

Kdo plugin nechce, má dál k dispozici snippet přes REST API.

Co bude dál

Plugin míří do katalogu WordPress.org, aby šel instalovat a aktualizovat přímo z administrace. Než tam projde schválením, stahujte ho z naší stránky, kde zveřejníme i další verze. Připomínky a nápady posílejte na info@topsms.cz, plugin vyvíjíme podle toho, co e-shopy reálně potřebují.