Key Takeaways
- Webhook in Android SMS gateway context: our control plane POSTs JSON to your HTTPS URL when delivery or inbound events happen — you do not hold a socket open to the modem.
- Verify signatures; ack fast; process async.
- Priced by devices and SMS send volume. You use your own phone and operator SMS credit. Webhooks do not replace operator airtime.
- Free 300 SMS lifetime still meters outbound you trigger from handlers.
- Offline phones mean missed inbound until the app is back.
- Developer Center owns live event fields.
What is a webhook for an Android SMS gateway? Your backend exposes HTTPS; we POST events (delivered, failed, received) so you do not poll forever. Guide: Webhooks. Two-way SMS. HTTP semantics.
Priced by devices and SMS send volume. You use your own phone and operator SMS credit.
A green webhook URL does not wake a sleeping phone — inbound SMS still needs the app registered on a funded SIM.
What a webhook is here
Register a URL; receive signed JSON when message state changes or inbound arrives. Confirm headers/payloads in Developer Center.
Events vs polling
| Approach | Pros | Cons |
|---|---|---|
| Webhook | Push, low idle cost | Needs public HTTPS + verify |
| GET by id | Simple support path | Chatty if abused |
| Block until DLR | Feels sync | Ties workers to radio lag |
Verify before you trust
Check X-SmsGateway-Signature (or current documented header). Reject forgeries.
Phone still has to be online
Delivery and inbound depend on the Android path — multi-device.
Retries and idempotency
Return 2xx quickly; enqueue work. Dedupe event ids so retries are safe — same idea as Ruby receive webhook.
Related reading
Webhooks API usage. 10DLC context.
Checklist
- HTTPS endpoint registered.
- Signature verified.
- Fast ack + async work.
- Idempotent handlers.
- Device last-seen monitored.
- Airtime funded.
Next steps
Fire a canary send and watch the callback, then size devices + volume.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS webhook integrationInbound and status events
- SMS API documentationLive endpoint reference
- device and SMS volume pricingPlans and allowances
- Android SMS gateway product guideDefinition, product, and how to buy




