SMS Gateway for Android

Vytvořeno: 27.9.2026 | Aktualizováno: 27.09.2026 13:41

SMS Gateway for Android je open-source aplikace, která z Android telefonu se SIM kartou vytvoří SMS bránu dostupnou přes HTTP API. Umožňuje programově odesílat SMS, přijímat příchozí zprávy a předávat změny stavu do vlastního systému přes webhooky.

K čemu slouží

Aplikace nahrazuje automatizaci aplikace Zprávy přes UI. Systém neotevírá obrazovku telefonu, nehledá kontakt a nekliká na tlačítko Odeslat. Místo toho pošle požadavek na API brány; telefon SMS odešle přes svou SIM kartu a mobilní síť.

Aplikace nebo automatizace
        │ HTTP API
        ▼
Android telefon se SMS Gateway for Android
        │ SIM karta
        ▼
Mobilní síť

Příchozí SMS a změny doručení mohou jít opačným směrem:

Android telefon
        │ HTTP webhook
        ▼
Vlastní server nebo automatizace

Režimy provozu

Projekt podporuje dva základní způsoby nasazení:

Lokální API v telefonu – aplikace spouští HTTP server přímo v Android zařízení. Dokumentace uvádí například endpoint http://<lokalni-ip-telefonu>:8080/message a API dokumentaci na cestě /docs.
Vlastní privátní server – telefon komunikuje s vlastním backendem. Pro tento režim existuje samostatný SMSGate Server, který poskytuje REST API, správu zařízení, autentizaci, sledování doručení a webhooky.

Lokální režim je vhodný pro jeden telefon ve stejné síti jako aplikace. Vlastní server dává smysl při více telefonech, při potřebě centrálního rozhraní nebo pokud má být integrace oddělená od konkrétního zařízení.

API a webhooky

Dokumentace projektu uvádí API pro odesílání a příjem SMS. Stav SMS lze sledovat i přes webhooky, které telefon odesílá metodou HTTP POST.

Mezi dokumentované události patří:

sms:received pro příchozí SMS,
sms:sent pro úspěšně odeslanou SMS,
sms:delivered pro potvrzení doručení,
události pro selhání nebo zrušení odeslání,
Data SMS, MMS, start aplikace a heartbeat.

Webhookový model je vhodný pro reakci na příchozí SMS. Server nemusí opakovaně číst obrazovku telefonu ani dotazovat agentní automatizaci na aktuální stav.

Co aplikace není

SMS Gateway for Android je SMS brána, ne GSM-to-SIP phone gateway. Dokumentace nepopisuje API pro vytáčení, přijímání, ukončování ani přemostění telefonních hovorů do SIP/RTP.

Pokud je potřeba programově řídit hovory, je vhodné použít samostatnou telefonní vrstvu, například Asterisk se SIP providerem nebo GSM-to-SIP gateway. Tuto úlohu nelze nahradit odesíláním SMS přes Android aplikaci.

Projekt také v dostupné dokumentaci neuvádí MQTT rozhraní. Pro integraci je výchozím rozhraním HTTP API a HTTP webhooky.

Distribuce a oprávnění

Projekt dokumentuje instalaci připraveného APK z GitHub Releases. Z toho nelze vyvozovat důvod, proč aplikace není nebo je v konkrétním okamžiku dostupná v Google Play.

Google Play omezuje oprávnění pro čtení, příjem a odesílání SMS. Aplikace distribuovaná přes Google Play musí taková oprávnění použít pro schválenou hlavní funkci a splnit další pravidla, typicky včetně režimu výchozí SMS aplikace. Pro vlastní instalaci na vyhrazeném zařízení je nutné předem ověřit oprávnění, verzi Androidu a konkrétní chování telefonu.

Kdy ji použít

Odesílání notifikací z vlastního systému přes fyzickou SIM kartu.
Příjem SMS odpovědí do interní aplikace nebo workflow.
Doručovací a stavové webhooky pro monitoring odeslaných zpráv.
Integrace s domácím serverem bez závislosti na komerční SMS API službě.
Vyhrazený Android telefon jako lokální SMS endpoint.

Licence

Projekt používá licenci Apache License 2.0.

Obsah