Devices
Devices lists the Android phones paired with your organization. Each phone is a gateway, and each SIM in it is a channel your messages can go out on. Use this screen to pair phones, watch their health, and choose which SIM sends by default.
Pair a phone
Section titled “Pair a phone”Pairing takes about a minute. You need the SMSFabric app on the phone; the phone side is in Pair a phone.
-
On Devices, click Pair a phone.
Click Pair a phone. -
A one-time QR code appears. In the app, tap Scan QR code and point the camera at it. The code lasts 10 minutes; New code makes another.
Scan the QR code with the app. -
No camera? Type the code shown under Or type this code in the app instead. Capital letters and dashes are optional.
Or type the code. -
When the phone checks in, the dialog says it’s paired and how many SIMs it found. Click Done.
The phone is paired. -
The new phone appears in the list, online and ready to send.
The phone is online.
Your plan sets how many phones you can pair. When it’s reached, Pair a phone is dimmed and says why; see Plan and usage.
Read the device list
Section titled “Read the device list”The line above the title sums up the fleet: phones online, phones in all, and SIMs. Each card shows one phone:
- The header: battery as a dial, the state, the name, and the Android and app versions. The state is Sending when it carried a message in the last few minutes, Online · idle when it’s connected but quiet, Disabled when you turned sending off, or Offline with how long ago it was last seen.
- The SIM slots: for each SIM, its slot, carrier, number and daily limit (for example “Cap 400 a day”), and whether it’s the Default.
- The readings: Signal from 0 to 4 bars with the network type (5G, LTE, 3G), Power (Charging, On battery or Low), and Seen, when the phone last checked in.
Choose the default SIM
Section titled “Choose the default SIM”The default SIM sends every message that doesn’t name a phone: the composer’s Automatic choice, and API calls without deviceId, simId or poolId. Your organization has one default.
-
On the SIM you want, click Make default.
Click Make default. -
A confirmation names the SIM and phone that now send by default.
The SIM now sends by default.
If the default SIM’s phone is offline, Automatic falls back to another online phone. The first SIM of the first phone you pair becomes the default automatically, so a new organization can send right away.
Disable or unpair a phone
Section titled “Disable or unpair a phone”Click ⋮ on a phone’s card.
- Disable sending stops the phone taking new messages; its queue moves to your other phones. The phone stays paired, and Enable sending turns it back on. Use it when a SIM runs out of credit or a phone needs maintenance.
- Unpair… removes the phone for good. Type
unpairto confirm. Its device token stops working at once. Messages waiting for it move to another phone in its pool; any that can’t move are marked failed so you can resend them. To use it again, pair it from scratch.
To rename a phone, use the API: PATCH /v1/devices/:id with { "name": "Front desk" }. SIM labels and daily limits are set with PATCH /v1/devices/:id/sims/:simId. See the devices reference.
The Pools panel at the bottom of the page groups phones that cover for each other: messages sent to a pool move to another of its phones when one stops answering. Create pools, add and remove phones, and rename or delete a pool there. See Pools.
When a phone is offline
Section titled “When a phone is offline”A phone is offline when it hasn’t checked in for a while. Its messages aren’t lost: messages meant for it wait in the queue until it’s back, and messages sent with Automatic go out on another online phone. The offline card lists what to check, in order.
- Plug the phone in. The card shows the battery level it reported before it dropped.
- Open SMSFabric on the phone and check that the gateway switch is on.
- Let the app run without battery limits: on the phone, open Settings → Apps → SMSFabric → Battery and remove the limit.
Still offline? Check the phone has mobile data or Wi-Fi, and see Pair a phone for the phone side. To keep messages flowing while one phone is down, put several phones in a pool.
Who can manage devices
Section titled “Who can manage devices”Every role except Billing can see this screen (devices:read). Pairing, choosing the default SIM, disabling, unpairing and managing pools need devices:manage, which the Owner, Admin and Developer roles have. See Team.