Stafio SMS brána pro Android

Aplikace, která z firemního telefonu udělá SMS bránu Stafia. Zprávy zařazené ve Stafiu si sama vyzvedne, odešle je z vaší SIM karty, nahlásí zpět doručení a příchozí odpovědi zapíše přímo k osobě do komunikačního deníku. Návod níže vás provede instalací a nastavením.

Stáhnout aplikaci (verze 1.1.4)

K čemu brána slouží

Brána nahrazuje dřívější řešení přes BulkGate Mobile Connect a MySMS. Používá se pro hromadné rozesílky uchazečům i pracovníkům a pro běžnou obousměrnou komunikaci – odpověď pracovníka se ve Stafiu objeví u jeho karty.

Návod je určený pro zákazníky Stafia. Adresu vaší instance a API klíč pro aplikaci dodá podpora Stafio; bez nich se brána nepřipojí. Nastavení brány na straně Stafia děláme my, aplikaci na telefon si nainstalujete sami podle tohoto postupu.

1. Co budete potřebovat

• Telefon s operačním systémem Android 8.0 nebo novějším. Na iPhonu není programové odeslání SMS aplikací třetí strany technicky možné, iOS tedy použít nelze.
• SIM kartu s tarifem vhodným pro odesílání SMS. Jedna SIM zvládne řádově desítky zpráv za hodinu – u větších rozesílek je rozdělte na více telefonů.
• Trvalé napájení a připojení k internetu (Wi-Fi nebo mobilní data). Brána pracuje průběžně na pozadí, telefon proto nechte zapnutý a v dosahu sítě.
• Adresu vaší instance Stafia a API klíč od podpory Stafio. Jeden klíč patří vždy jednomu telefonu – nezadávejte stejný klíč do dvou přístrojů, jinak si oba budou brát tytéž zprávy a odesílat je z různých čísel.
• Telefon vyhrazený pro tento účel. Všechny SMS, které na danou SIM přijdou, aplikace zapíše do Stafia. Osobní telefon proto jako bránu nepoužívejte.

2. Stažení aplikace

Aplikace není v Google Play. Odesílání a příjem SMS patří mezi vyhrazená oprávnění, která Google povoluje jen výchozí SMS aplikaci telefonu, a SMS brána mezi povolené případy užití nepatří. Instaluje se proto přímo ze souboru APK podepsaného naším podpisovým klíčem.

Odkaz otevřete přímo v telefonu, na který bránu instalujete. Soubor stafio-sms-brana-1.1.4.apk má velikost přibližně 7 MB.

Stáhnout Stafio SMS brána 1.1.4

3. Instalace

• V telefonu otevřete stažený soubor – obvykle přes oznámení o dokončeném stahování, nebo v Souborech → Stažené.
• Android se zeptá, zda smí aplikace z tohoto zdroje instalovat. Povolte Instalovat neznámé aplikace pro prohlížeč nebo správce souborů, ze kterého soubor otevíráte.
• Potvrďte Instalovat a po dokončení Otevřít.

Pokud telefon instalaci odmítne hlášením „App not installed“ nebo neshodou podpisu, je na něm starší verze z jiného zdroje (například z interního testování Google Play). Tu nejdřív odinstalujte a instalaci zopakujte.

4. Zadání adresy a API klíče

• V aplikaci otevřete Nastavení.
• Do pole adresy zadejte adresu vaší instance Stafia ve tvaru https://nazev.stafio.cz. Musí to být adresa vaší instance – přihlašovací rozcestník app.stafio.cz klíč nenajde a brána se nepřipojí.
• Vložte API klíč; začíná stf_. Doporučujeme poslat ho do telefonu tak, aby se dal zkopírovat – přepisování z papíru bývá zdrojem chyb.
• Nastavení uložte. Aplikace si sama zjistí, které brány k zadanému klíči patří; bránu v telefonu nevybíráte.

5. Udělení oprávnění

Aplikace si o oprávnění řekne sama při prvním spuštění. Povolte jí:

• odesílání SMS a příjem SMS,
• stav telefonu – potřebný pro výběr SIM u telefonů se dvěma SIM,
• oznámení – trvalé oznámení o běhu brány.

O výpis hovorů si aplikace řekne pouze tehdy, má-li vaše brána ve Stafiu zapnuté hlášení hovorů. Dokud je tato volba vypnutá, oprávnění vůbec nepožaduje.

Omylem odmítnuté oprávnění doplníte v Nastavení Androidu → Aplikace → Stafio SMS brána → Oprávnění.

6. Vyjmutí z optimalizace baterie

Tohle je nejčastější příčina stavu „aplikace je nainstalovaná, ale nic se neděje“. Bez výjimky z úspory baterie systém aplikaci po čase uspí a brána přestane odesílat.

• Na hlavní obrazovce aplikace použijte tlačítko pro vyjmutí z optimalizace baterie a v systémovém dotazu ho povolte.
• U telefonů Xiaomi, Samsung a Huawei navíc povolte aplikaci automatické spouštění (autostart) ve správci aplikací. Bez toho ji nadstavba výrobce po restartu telefonu nespustí.

7. Telefony se dvěma SIM

Má-li váš účet více bran, přiřaďte v aplikaci každé bráně její SIM kartu. Dokud přiřazení chybí a bran je víc, aplikace raději nahlásí chybu, než aby zprávu odeslala z cizího čísla. U jediné brány není potřeba nic přiřazovat.

8. Spuštění a kontrola provozu

Bránu zapnete tlačítkem SPUSTIT. Že běží, poznáte podle trvalého oznámení se stavem brány. Tlačítko Zastavit vypne odesílání jen na tomto telefonu; trvalé vypnutí brány se nastavuje ve Stafiu – dejte nám vědět.

• Na hlavní obrazovce je log událostí za posledních 7 dní: číslo zprávy, čas a výsledek. Texty zpráv ani API klíč se do logu nikdy nezapisují.
• Brána se průběžně ohlašuje do Stafia. Když se přestane hlásit – vybitý telefon, bez signálu, zabitá aplikace – Stafio ji po 15 minutách označí jako mlčící a my se to dozvíme.
• Po nastavení doporučujeme zkušební SMS na vlastní číslo. Ve Stafiu u zprávy uvidíte odeslání i doručenku.

9. Aktualizace

Aktualizace jsou zatím ruční: nové APK stáhnete z této stránky a nainstalujete přes stávající verzi. Protože je podepsané stejným klíčem, telefon ji přijme jako aktualizaci a nastavení i historie zůstanou. Na jednom telefonu nekombinujte instalaci ze souboru s instalací z Google Play – mají různý podpis a navzájem se nepřeinstalují.

10. Nejčastější potíže

Co vidíte	Co s tím
„Účet nemá připojenou žádnou bránu“	Aplikace se přihlásila správně, ale telefon ještě nemáme ve Stafiu přepnutý na novou bránu. Napište nám do tiketu, že aplikace na telefonu běží; přepnutí uděláme mimo špičku.
Aplikace běží, ale nic neodesílá	Nejčastěji chybí výjimka z optimalizace baterie nebo autostart (kapitola 6). Pokud je všechno povolené, dejte nám vědět: může být vypnuté odesílání na bráně, nebo telefon není zařazený mezi frontami vašich uživatelů.
Instalace se nezdaří, neshoda podpisu	Na telefonu je verze z jiného zdroje. Odinstalujte ji a instalaci zopakujte.
Nechodí příchozí SMS	Zkontrolujte oprávnění pro příjem SMS. Na telefonu také nesmí zůstat jiná bránová aplikace (například BulkGate Mobile Connect), jinak by se zprávy do Stafia dostávaly dvakrát.
Nechodí doručenky	Doručenku vydává operátor a aplikace ji jen předává. Když ji operátor u daného tarifu neposílá, zůstane u zprávy jen odeslání.

11. Ochrana údajů

• API klíč je v telefonu uložený šifrovaně a do logu se nikdy nevypisuje.
• Texty zpráv aplikace do vlastního logu neukládá – patří do komunikačního deníku ve Stafiu.
• Historii z telefonu aplikace nikam neposílá. Při zapnutém hlášení hovorů si při prvním běhu jen zapamatuje, kde výpis hovorů je, a hlásí až hovory od té chvíle. Hlasová schránka a blokovaná čísla se nehlásí.
• Přístup telefonu odeberete kdykoli – stačí nám dát vědět, klíč zneplatníme.

Potřebujete pomoc s nastavením?

Napište nám na podpora@stafio.cz nebo do svého tiketu. Uveďte prosím telefonní číslo brány a co je na hlavní obrazovce aplikace napsané ve stavu a v logu.