====== SMS Gateway for Android ======

//Vytvořeno: **27.9.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/capcom6/android-sms-gateway|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íť.

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

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

<code>
Android telefon
        │ HTTP webhook
        ▼
Vlastní server nebo automatizace
</code>

===== 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ý [[https://github.com/android-sms-gateway/server|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.

[[https://support.google.com/googleplay/android-developer/answer/16558241?hl=en|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á [[https://github.com/capcom6/android-sms-gateway/blob/master/LICENSE|licenci Apache License 2.0]].

===== Zdroje =====

  * [[https://github.com/capcom6/android-sms-gateway|SMS Gateway for Android – aplikace, API a webhooky]]
  * [[https://github.com/android-sms-gateway/server|SMSGate Server – self-hosted backend]]
  * [[https://support.google.com/googleplay/android-developer/answer/16558241?hl=en|Google Play – pravidla pro SMS oprávnění]]
  * [[https://github.com/capcom6/android-sms-gateway/blob/master/LICENSE|SMS Gateway for Android – licence Apache License 2.0]]