How it works
SMSFabric sits between your code and your phones. Your code talks to the API over HTTPS. Your phones keep a secure connection open to SMSFabric and send each message through one of their SIMs.
The path of an outbound message
Section titled “The path of an outbound message”-
You send a request. Your server calls
POST /v1/messageswith an API key, or someone presses Send in the portal. SMSFabric checks the key, the recipients and the blacklist, stores the message encrypted and answers201 Createdwith statusqueued. -
SMSFabric picks a phone and a SIM. The router chooses the device, SIM or pool you asked for, or your default SIM. It respects each SIM’s daily limit and the cooldown between messages. The status becomes
routed. -
The phone sends it. The phone receives the job over its live connection. If the connection was asleep, a push notification wakes it first. The phone hands the message to Android, which sends it through the carrier. The status moves to
sending, thensent. -
The carrier reports back. When the recipient’s handset receives the SMS, the carrier sends a delivery report to the phone, and the phone passes it on. The status becomes
delivered, orfailedwith an error code. -
You hear about it. Each change is written to the message’s timeline, shown live in the portal and posted to your webhooks as
message.sent,message.deliveredormessage.failed.
queuedroutedsendingsentdeliveredfailedblocked
A message to a blacklisted or opted-out number never leaves SMSFabric. It is stored with status blocked.
Inbound messages
Section titled “Inbound messages”When someone texts one of your SIMs, the Android app (the direct build) reads the SMS and sends it to SMSFabric. It appears in Messages with direction inbound and status received, and SMSFabric posts a message.received webhook. If the text is STOP, the number is added to your blacklist. See Inbound SMS.
When a phone goes offline
Section titled “When a phone goes offline”Phones report a heartbeat. If a phone stops reporting, the portal marks it offline and its waiting messages stay queued. When the phone is in a pool, SMSFabric moves those messages to another online phone in the same pool. When it is alone, they are sent as soon as it reconnects.
Test mode
Section titled “Test mode”API keys that start with sf_test_ never reach a carrier. A virtual device accepts their messages and reports them as delivered, so you can build and test your integration before you pair a real phone. See Sandbox.