The iPhone companion app
On an iPhone, SMSFabric is a companion app. It doesn’t send messages for your API. It shows your Android gateways and lets you send a message by hand.
Why an iPhone can’t be a gateway
Section titled “Why an iPhone can’t be a gateway”A gateway has to send SMS when the server asks, with nobody touching the phone. iOS doesn’t allow that. On an iPhone, apps can’t:
- send an SMS without your tap: an app can only open the Messages app with the text filled in, and you tap Send,
- read incoming SMS,
- run USSD codes, such as balance checks,
- run all day in the background the way an Android gateway does.
These are limits of iOS, not settings you can change. Use an Android phone as your gateway. The companion app shows these limits at the top of its Overview tab.
What it does
Section titled “What it does”- Shows your devices. Under Your devices, each Android phone in your organization appears with its status (Online, Offline or Disabled), battery, number of SIMs and when it was last seen. Pull down to refresh.
- Sends a message by hand. Under Send from this iPhone, you write a message and the app hands it to Messages. See below.
- Follows your language and theme. Settings has the same Language and Theme choices as on Android.
Push alerts, for example when a gateway goes offline, are planned for the companion app. They aren’t in the current build.
Show your devices
Section titled “Show your devices”The current build asks for an API key instead of your SMSFabric password. Sign-in with your account replaces this in a later build. Create a key for the iPhone in the portal under Developers › API keys and give it only the devices:read scope (API keys).
-
On the Overview tab, under Sign in, check Server URL. It’s usually
https://api.smsfabric.com. -
Paste the key in API key and tap Show my devices.
Paste the key and tap Show my devices.
The key is stored in the iPhone’s Keychain. To remove it, tap Remove key next to Your devices.
Send a message from the iPhone
Section titled “Send a message from the iPhone”This sends from the iPhone’s own SIM, through the Messages app. It doesn’t go through SMSFabric, so it doesn’t appear in your dashboard or reach your webhooks.
-
Under Send from this iPhone, type the number in To in international format, for example
+201001234567. -
Type your text in Message. Preview shows it as a text bubble while you type.
Write the message and tap Open in Messages. -
Tap Open in Messages. The Messages app opens with the number and text filled in.
-
Check the message and tap Send in Messages. Nothing goes out until you do.