textbee Logotextbee.dev
Plans from $9.99/mo.View Plans

SMS gateway app: definition and how it works

Published and updated

An SMS gateway app is an Android application that turns a phone with a SIM into an SMS gateway: it receives send requests from an API over the internet and sends them as texts through the phone's SIM, and forwards texts the phone receives back to your software.

How it works

Android exposes the SMS functions of a phone to apps that hold the relevant permissions. A gateway app uses that: it stays connected to a server, and when your code calls the server's API the app is told to send a message, which the phone sends over its SIM like any text. Inbound texts to the SIM are read by the app and pushed to the server, where your code fetches them or receives them by webhook. The phone becomes the carrier connection and the server is the API in front of it.

The strengths follow from the SIM. Messages come from a real local number that recipients can reply to. There is no per-message fee from a provider, only the SIM plan, so a few thousand messages a month cost a flat amount. It works in countries where cloud providers have no route or need paperwork to send. Setup is minutes: install the app, register the device, get an API key.

The limits follow from the phone. Throughput is what one handset can send, roughly ten to fifteen messages a minute, so it is not a bulk tool. Carriers filter bulk patterns on consumer SIMs, and marketing needs consent under local rules whatever the sender. The phone has to stay on, charged, connected and free of aggressive battery savers, which is why a dedicated device is the usual advice.

Use it for OTP, alerts, reminders, notifications and two-way conversations at modest volume. Use a carrier route when you need a short code, a branded sender or thousands of messages an hour.

How this applies with textbee

textbee is an SMS gateway app with a hosted API, an open source codebase you can self-host, a dashboard for devices and messages, webhooks, and a free plan. The docs cover setting up a phone as a dedicated gateway and the Android permission steps it needs.

Related terms

  • SMS gateway: An SMS gateway is the piece of software or hardware that takes a message from an application and hands it to a mobile network so it arrives as a text on a phone.
  • SMS API: An SMS API is a programmatic interface, almost always HTTP, that lets software send text messages, read the ones that arrive, and check what happened to each one.
  • SIM box: A SIM box is a device holding many SIM cards that routes bulk calls or messages through consumer subscriptions to avoid wholesale charges, and carriers actively detect and block it.
  • SMS throughput: SMS throughput is the number of messages a sender can push into the network per unit of time, and it is set by the sender type: a handset, a long code, a short code or an SMPP bind each have their own ceiling.

Frequently asked questions

Does an SMS gateway app need a dedicated phone?

It does not have to be dedicated, but a phone that stays plugged in, connected, and exempt from battery optimisation is far more reliable than a daily-use phone. Any spare Android device works.

Read next