Varyshop SMS
Odesílání SMS kampaní přímo z vašich Android telefonů — bez externího poskytovatele, bez poplatků za každé SMS.
Místo placení za každou odeslanou SMS přes cloudovou službu použijete vlastní Android telefon(y) jako SMS bránu. Telefon se spojí s vaším systémem, automaticky přijímá zprávy z front a odesílá je jako běžné SMS. Můžete použít více telefonů najednou — systém sám rozdělí zátěž.
Nový tab Kampaně umožňuje vytvářet a odesílat SMS kampaně přímo z telefonu. Vyberte šablonu, segment zákazníků, upravte text a odešlete — včetně statistik (kliknutí, objednávky, příjem). Více informací ↓
Jak to funguje
Celý systém má tři části, které spolupracují:
V praxi to vypadá takto:
- V administraci vytvoříte SMS kampaň a kliknete Odeslat
- Varyshop připraví SMS zprávy a zařadí je do fronty
- Aplikace na vašem Android telefonu se každý pár sekund ptá: „Máte pro mě něco k odeslání?“
- Když najde novou zprávu, odešle ji jako normální SMS z vašeho telefonního čísla
- Po odeslání hlásí zpět do Varyshopu: „Odesláno“ nebo „Nepodařilo se“
Co potřebujete
- Varyshop instance s Odoo 18 s modulem Varyshop SMS (nainstaluje váš správce)
- Přístup do sekce Email Marketing
- Android telefon (verze 12 nebo novější)
- SIM karta s aktivním tarifem pro SMS
- Připojení k internetu (Wi-Fi nebo mobilní data)
- Aplikace Varyshop SMS (nainstaluje váš správce)
Nastavení ve Varyshop administraci
Po instalaci modulu (tu provede váš technik) najdete novou sekci v menu:
Email Marketing → Varyshop SMS → Gateway Phones
Zde budete spravovat všechny telefony připojené k vašemu systému.
Přidání telefonu
Každý fyzický telefon, který chcete použít pro odesílání, musíte zaregistrovat ve Varyshop administraci.
- Přejděte do Email Marketing → Varyshop SMS → Gateway Phones
- Kliknete Nový
-
Vyplňte základní údaje:
Pole Co vyplnit Příklad Název Pojmenujte si telefon, ať ho později poznáte Samsung – O2 Telefonní číslo Číslo SIM karty v mezinárodním formátu +420777123456 Druhé číslo Pokud má telefon dvě SIM, zadejte i druhé (nepovinné) +420608987654 Denní limit Kolik SMS maximálně může telefon odeslat za den 500 SMS za minutu Maximální rychlost odesílání 100 - Kliknete Generovat API klíč — objeví se QR kód, který použijete k párování
- Záznam uložte
Instalace aplikace na telefon
Na Android telefon je potřeba nainstalovat aplikaci Varyshop SMS.
Stažení APK
Aplikace není na Google Play. Stáhněte APK soubor přímo z GitHub Releases:
- Na telefonu otevřete odkaz na Releases a stáhněte nejnovější .apk soubor
- Otevřete stažený soubor — pokud se objeví upozornění, povolte Instalace z neznámých zdrojů
- Dokončete instalaci
SEND_SMS a READ_SMS, která vyžadují
speciální review na Play Store. Instalace APK přímo z GitHub Releases
je zamýšlený způsob distribuce.
./scripts/install-release.sh
z modulu extra/sms. Viz
Vývojářská dokumentace
pro build & install skripty.
Po spuštění aplikace budete požádáni o následující oprávnění:
| Oprávnění | Proč ho potřebujeme |
|---|---|
| Odesílání SMS | Aby aplikace mohla odesílat SMS zprávy z vašeho čísla |
| Přijímání SMS | Aby aplikace zachytila odpovědi s textem STOP (odhlášení) |
| Kamera | Pro naskenování QR kódu při párování |
| Informace o telefonu | Pro zjištění čísel vašich SIM karet |
| Notifikace | Pro zobrazení stavu odesílání a služby na pozadí (Android 13+ se ptá v dialogu) |
WRITE_SECURE_SETTINGS. To nelze udělit
z telefonu — je nutné připojit telefon k počítači přes USB a
spustit:
adb shell pm grant com.varyshop.smsgatewayapp android.permission.WRITE_SECURE_SETTINGSyarn grant-permission
Kromě těchto oprávnění aplikace zobrazí také dialog pro výjimku z optimalizace baterie. Tato výjimka je nezbytná, aby Android neuspával aplikaci na pozadí a SMS se spolehlivě odesílaly i při zamknuté obrazovce. Více viz sekce Pozadí a spolehlivost.
Spárování telefonu s Varyshop administrací
Po instalaci aplikace ji musíte propojit s vaším Varyshop systémem. To se dělá jednorázově pomocí QR kódu.
- V Varyshop administraci otevřete záznam vašeho telefonu (tam kde jste klikli Generovat API klíč) — uvidíte QR kód
- Na telefonu otevřete aplikaci Varyshop SMS
- Přejděte na záložku Nastavení (ikona ozubeného kola dole)
- Kliknete na Naskenovat QR kód
- Namiřte kameru telefonu na QR kód zobrazený na obrazovce v Varyshop administraci
- Aplikace potvrdí úspěšné spárování — hotovo!
- Má telefon připojení k internetu? (Wi-Fi nebo mobilní data)
- Běží aplikace na telefonu? (není zavřena, není v úsporném režimu)
- Je adresa serveru správná? (v nastavení aplikace vidíte URL)
Vaše první SMS kampaň
Když máte alespoň jeden telefon Online, můžete odeslat první kampaň.
- Přejděte do Email Marketing → SMS Marketing
- Kliknete Nový
-
Vyplňte kampaň:
Pole Co vyplnit Název Interní název kampaně (zákazník ho neuvidí) Příjemci Komu se SMS pošle — vyberete skupinu kontaktů nebo nastavíte filtr Text zprávy Samotný text SMS (max. 160 znaků pro jednu SMS, delší se rozdělí) - Zkontrolujte náhled zprávy
- Kliknete Odeslat (pro okamžité odeslání) nebo Naplánovat (pro odeslání v určitý čas)
Příklad textu SMS
{{ object.name }} vložíte do textu jméno každého
příjemce. Další pole najdete přes tlačítko dynamického obsahu v
editoru zprávy.
Kampaň z mobilní appky
Novinka v1.3.0: Kampaně můžete vytvářet přímo z mobilní aplikace bez přístupu do Odoo backendu. Stačí otevřít tab Kampaně v appce.
Předpoklady
- V administraci musí být vytvořena alespoň jedna SMS šablona přiřazena k vašemu telefonu (SMS Gateway → Marketing Templates)
- Šablona musí mít přiřazené segmenty (skupiny příjemců)
Wizard v appce (3 kroky)
- Výběr šablony — zobrazí se šablony přiřazené k vašemu telefonu. Vyberte jednu klepnutím.
- Segment a počet — vyberte segment (např. „Neobjednali 3 měsíce“) a nastavte počet příjemců. U každého segmentu vidíte kolik zákazníků odpovídá filtru.
- Náhled a potvrzení — uvidíte náhled SMS s ukázkovým jménem. Text můžete před odesláním upravit. Zvolíte Odeslat ihned nebo Do fronty.
Odeslání a sledování
Po vytvoření kampaně se zobrazí karta stavu s realtime počítadly (odesláno / čeká / chyby). Pokud jste zvolili „Do fronty“, můžete SMS později odeslat tlačítkem Odeslat ihned.
U telefonu s dvěma SIM kartami appka nabídne výběr: odeslat přes jednu SIM, nebo rozdělit mezi obě.
Marketingové statistiky
Po odeslání kampaně appka zobrazuje:
- Kliknuto — kolik příjemců kliklo na odkaz
- Objednávky — počet objednávek z kampaně (UTM tracking)
- Příjem — celkový příjem z objednávek v Kč
- Odhlášeno — počet STOP odpovědí
- CTR, Konverze, Odhlášení % — procentuální metriky
Jak se odesílají SMS
Po kliknutí na Odeslat se děje následující:
Průběh můžete sledovat v reálném čase:
- V kampani — počítadla v záhlaví ukazují kolik SMS je odesláno, kolik čeká, kolik selhalo
- Na telefonu — aplikace ukazuje kolik SMS odesílá a kolik jich ještě čeká ve frontě
- U telefonu v administraci Varyshop — na kartě telefonu vidíte Odesláno dnes a Čekající
Pozastavení kampaně
Pokud potřebujete kampaň dočasně zastavit (třeba jste si všimli chyby v textu), můžete ji pozastavit bez zrušení:
- Otevřete kampaň, která se právě odesílá
- Zapněte přepínač Paused (Pozastaveno)
- SMS, které jsou ještě ve frontě, se nebudou odesílat
- SMS, které už byly odeslány, zůstanou odeslané — ty nelze vzít zpět
Pro obnovení odesílání jednoduše přepínač Paused vypněte.
Více telefonů a rozdělení zátěže
Můžete připojit libovolný počet telefonů. Systém automaticky rozděluje SMS rovnoměrně — každá nová SMS se přiřadí telefonu, který má momentálně nejméně práce (nejméně čekajících SMS ve frontě).
Příklad se třemi telefony
| Telefon | Čeká ve frontě | Dostane další SMS? |
|---|---|---|
| Samsung – O2 | 15 SMS | Ne |
| Xiaomi – T-Mobile | 8 SMS | Ne |
| Pixel – Vodafone | 3 SMS | Ano — má nejméně |
Směrování SMS na konkrétní telefony
Pokročilá funkce: můžete nastavit, aby určitý telefon odesílal SMS pouze pro určitou skupinu zákazníků. Například chcete, aby SMS pro VIP zákazníky šly z jiného čísla než SMS pro ostatní.
Jak to nastavit
- Otevřete záznam telefonu v Varyshop SMS → Gateway Phones
- Najdete pole Partner Domain Filter
- Zadejte podmínku, kteří zákazníci mají být směrováni na tento telefon
Příklady
| Chci aby telefon odesílal pro... | Co zadat do filtru |
|---|---|
| Všechny zákazníky (bez omezení) | Nechat prázdné |
| Pouze VIP zákazníky (kategorie s ID 10) | [("category_id", "in", [10])] |
| Pouze zákazníky z Česka | [("country_id.code", "=", "CZ")] |
| Pouze firemní zákazníky | [("is_company", "=", True)] |
Denní limity a rychlost odesílání
Každý telefon má dva limity, které můžete nastavit:
| Limit | Co dělá | Výchozí hodnota |
|---|---|---|
| Denní limit | Maximální počet SMS, které telefon odešle za jeden den. O půlnoci se počítadlo automaticky resetuje. | 500 SMS/den |
| SMS za minutu | Jak rychle za sebou telefon odesílá SMS. Vyšší číslo = rychlejší, ale hrozí riziko blokování operátorem. | 100 SMS/min |
Co se stane když telefon dosáhne limitu?
- Nové SMS se automaticky přesměrují na další dostupný telefon
- Pokud žádný další telefon není k dispozici, SMS zůstane ve frontě do dalšího dne
- V Varyshop uvidíte na kartě telefonu, kolik SMS ještě může dnes odeslat
Telefony s dvěma SIM kartami
Pokud má váš telefon dvě SIM karty, můžete je obě zaregistrovat u jednoho záznamu telefonu v Varyshop:
- Telefonní číslo — číslo první SIM karty
- Druhé číslo — číslo druhé SIM karty
Aplikace automaticky rozpozná obě SIM karty a zobrazí je v nastavení. SMS se odesílají přes správnou SIM kartu podle toho, kterému číslu byly v Varyshop přiřazeny.
Odkazy v SMS a sledování kliknutí
Pokud vložíte do textu SMS odkaz (URL adresu), systém ho automaticky zkrátí a přidá sledování.
Co se děje s odkazem
| Fáze | Jak odkaz vypadá |
|---|---|
| Jak ho napíšete | https://www.vas-eshop.cz/akce-jaro-2026 |
| Jak dojde příjemci | https://vas-admin.cz/r/Ab3x (krátký trackovací odkaz) |
Co se stane když příjemce klikne
- Příjemce klikne na krátký odkaz v SMS
- Váš server zaznamená kliknutí — kdo klikl, kdy, odkud
- Příjemce je okamžitě přesměrován na původní stránku (vas-eshop.cz/akce-jaro-2026)
Díky tomu vidíte v Varyshop kolik lidí kliklo na odkaz a kdo přesně to byl. Nemusíte nic nastavovat — děje se to automaticky.
Kde najdu statistiky odkazů
Přejděte do Email Marketing → Link Tracker — uvidíte všechny krátké odkazy, počet kliknutí a další detaily.
Odhlášení příjemců a STOP zprávy
Podle zákona (GDPR) musí mít každý příjemce možnost se z marketingových SMS odhlásit. Náš systém to řeší automaticky.
Jak to funguje
- Na konci každé SMS zprávy je automaticky text: STOP pro odhlášení
- Pokud příjemce odpoví SMS zprávou obsahující slovo STOP...
- ...aplikace na telefonu tuto odpověď zachytí
- Automaticky přidá číslo příjemce na černou listinu
- Všechny budoucí kampaně toto číslo automaticky přeskočí
Kde najdu černou listinu
SMS Marketing → Konfigurace → Phone Blacklist
Zde můžete:
- Vidět všechna odhlášená čísla
- Přidat číslo ručně (pokud vás zákazník požádá telefonicky či emailem)
- Odebrat číslo z listiny (pokud zákazník svůj souhlas obnoví — např. písemně)
Příchozí SMS
Od verze 1.2.0 aplikace obsahuje nový tab Příchozí, kde můžete sledovat všechny přijaté SMS zprávy na vašem gateway telefonu.
Co tab Příchozí ukazuje
- Odesílatel — číslo odesílatele a jméno partnera (pokud existuje v systému)
- Text zprávy — obsah přijaté SMS
- Stav blacklistu — zda je číslo na černé listině
- Datum a čas — kdy byla zpráva přijata
Filtrování
V horní části obrazovky můžete přepnout mezi zobrazením Všechny zprávy a Pouze STOP. Seznam podporuje stránkování pro snazší procházení velkého objemu zpráv.
Chatter integrace
Všechny přijaté SMS se automaticky zobrazují v chatteru partnera v Odoo. Každá příchozí zpráva se zobrazí jako formátovaná poznámka s textem v blockquote a případně se štítkem STOP, pokud zpráva obsahovala klíč pro odhlášení.
Znovu prohledání inboxu
Pokud chybí některé příchozí zprávy, přejděte v aplikaci do Nastavení → Služba a kliknete Znovu prohledat přijaté SMS. Aplikace přečte SMS inbox za posledních 30 dní a všechny nalezené zprávy odešle na server. Duplicity se automaticky ignorují.
Statistiky kampaně
Po odeslání kampaně najdete statistiky přímo v záhlaví kampaně:
| Ukazatel | Co znamená |
|---|---|
| Odesláno (Sent) | Počet úspěšně odeslaných SMS |
| Kliknuto (Clicked) | Kolik příjemců kliklo na odkaz ve zprávě |
| Chyby (Failed) | Počet SMS, které se nepodařilo odeslat |
| Bounced | Neplatná telefonní čísla |
| Objednávky (Orders) | Počet objednávek vytvořených z kampaně (UTM tracking) |
| Příjem (Revenue) | Celkový příjem z objednávek přiřazených kampani |
| Odhlášeno (Opt-out) | Počet příjemců, kteří odpověděli STOP |
Kliknutím na kterýkoliv ukazatel zobrazíte detailní seznam — vidíte přesně, kterým kontaktům byla SMS odeslána, kdo klikl atd.
Statistiky telefonu
Na kartě každého telefonu v Varyshop SMS → Gateway Phones vidíte:
- Odesláno dnes — kolik SMS telefon dnes odeslal (z denního limitu)
- Celkem odesláno — celkový počet SMS za celou dobu
- Čekající — kolik SMS čeká ve frontě na odeslání
- Chyby — kolik SMS se nepodařilo odeslat
FCM Push notifikace
Standardně si aplikace na telefonu každý pár sekund vyzvedá nové SMS z fronty (tzv. polling). To funguje dobře, ale mezi vytvořením SMS v administraci a začátkem odesílání může být prodleva až 10 sekund.
FCM (Firebase Cloud Messaging) tuto prodlevu eliminuje. Když je FCM povoleno, administrace pošle telefonu okamžitý „push“ impuls — aplikace začne odesílat prakticky ihned.
Jak FCM zapnout
- Přejděte do Nastavení → SMS Gateway
- Zapněte přepínač FCM Push Enabled
- Nahrajte soubor Firebase Service Account JSON — získáte ho ve Firebase Console (Project Settings → Service accounts → Generate new private key)
- Uložte nastavení
Pozadí a spolehlivost
Aplikace Varyshop SMS odesílá zprávy i když je obrazovka zamknutá nebo když používáte jiný program. Aby to fungovalo spolehlivě, musí být správně nastavena optimalizace baterie.
Optimalizace baterie
Android se snaží šetřit baterii a může aplikacím na pozadí omezit činnost. Pro Varyshop SMS je třeba toto omezení vypnout:
- Otevřete Nastavení telefonu → Baterie → Využití baterie aplikacemi
- Najdete aplikaci SMS Gateway
- Zvolte Neomezené (Unrestricted)
Xiaomi / MIUI — extra kroky
Telefony Xiaomi s nadstavbou MIUI mají agresivnější správu baterie. Kromě výjimky z optimalizace baterie je třeba navíc:
- Povolit Autostart: Nastavení → Aplikace → Oprávnění → Autostart — zapnout pro SMS Gateway
- V nastavení baterie pro aplikaci zvolit Bez omezení
Jak ověřit že vše funguje
Předtím než spustíte první velkou kampaň, doporučujeme vše otestovat:
-
Zkontrolujte stav telefonu
V Varyshop SMS → Gateway Phones by měl být alespoň jeden telefon Online -
Pošlete testovací SMS
Vytvořte kampaň s jediným příjemcem (např. sami sobě) a odeslat ji -
Zkontrolujte doručení
Zkontrolujte, že vám SMS přišla na telefon příjemce -
Ověřit sledování
Kliknete na odkaz v SMS a zkontrolujte v Varyshop (Link Tracker), že se kliknutí zaznamenalo -
Otestujte odhlášení
Odpovězte na SMS zprávou „STOP“ a ověřit, že se vaše číslo objeví na černé listině v Varyshop
Časté dotazy a řešení problémů
Telefon je v Varyshop stále Offline, i když aplikace běží
- Zkontrolujte, že má telefon připojení k internetu (otevřete prohlížeč a zkuste načíst stránku)
- V aplikaci v záložce Nastavení ověříte, že je zobrazena URL adresa vašeho serveru
- Zkuste aplikaci zavřít a znovu otevřít
- Pokud nic nepomůže, znovu naskenujte QR kód
SMS se neodesílají, zůstávají ve frontě
- Je telefon Online?
- Je v aplikaci zapnuto odesílání? (Dashboard → přepínač Start)
- Nedosáhl telefon denního limitu? (zkontrolujte Odesláno dnes vs. Denní limit)
- Má aplikace oprávnění k odesílání SMS? (Nastavení Android → Aplikace → Varyshop SMS → Oprávnění)
Některá SMS se označila jako chyba
- Číslo příjemce může být neplatné (špatný formát, neexistující číslo)
- Telefon mohl ztratit signál v průběhu odesílání
- Android mohl zablokovat odesílání kvůli limitu (viz níže)
- Chybové SMS můžete zkusit odeslat znovu tlačítkem Force Create SMS Queue v kampani
Android blokuje odesílání po 30 SMS
- Snížit SMS za minutu na 1 (jedno SMS za minutu) — pomalejší, ale nenarazíte na limit
- Požádat správce o změnu nastavení telefonu (technické řešení)
- Použít více telefonů — limit platí na každý telefon zvlášť
SMS se neodesílají při zamknuté obrazovce
- Nejčastější příčina: optimalizace baterie uspí aplikaci na pozadí. Zkontrolujte Nastavení → Baterie → Využití baterie aplikacemi → SMS Gateway a nastavte na Neomezené
- Na Xiaomi/MIUI: povolte také Autostart (viz sekce Pozadí a spolehlivost)
- Ověřit, že aplikace má povolené notifikace (potřeba pro službu na pozadí)
STOP zprávy se neobjeví v blacklistu
- Ověřit, že aplikace má oprávnění Přijímání SMS (RECEIVE_SMS) — bez něj aplikace odpovědi neuvidí
- Zkontrolujte připojení k internetu — aplikace musí zaslat informaci o STOP zprávě zpět na server
- Příjemce musí odpovědět na stejné číslo, ze kterého SMS přišel
- Zpráva musí obsahovat slovo STOP (velká/malá písmena nehrají roli)
- Znovu prohledat přijaté SMS: V aplikaci přejděte do Nastavení → Služba a kliknete tlačítko Znovu prohledat přijaté SMS. Aplikace znovu přečte SMS inbox za posledních 30 dní a odešle nalezené zprávy na server (s deduplikací — duplicity se ignorují).
STOP zpráva nefunguje — číslo se nepřidá na černou listinu
- Ověřit, že aplikace má oprávnění Přijímání SMS
- Příjemce musí odpovědět na stejné číslo, ze kterého SMS přišel
- Zpráva musí obsahovat slovo STOP (velká/malá písmena nehrají roli)
Odkazy v SMS nefungují nebo vedou na chybu
- Odkaz vyžaduje, aby byl váš Varyshop server veřejně dostupný z internetu
- Pokud používáte HTTPS (doporučeno), certifikát musí být platný
- Kontaktujte správce, ať zkontroluje nastavení web.base.url v Varyshop
Jak odpojím telefon od systému?
Můžu měnit text SMS potom co jsem kampaň odeslal?
Kolik SMS můžu odeslat denně?
Varyshop SMS v18.0.2.2.0 • VaryShop • 2026