Skip to content

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.

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.

The Overview tab on an iPhone.
  • 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.

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).

  1. On the Overview tab, under Sign in, check Server URL. It’s usually https://api.smsfabric.com.

  2. 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.

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.

  1. Under Send from this iPhone, type the number in To in international format, for example +201001234567.

  2. Type your text in Message. Preview shows it as a text bubble while you type.

    Write the message and tap Open in Messages.
  3. Tap Open in Messages. The Messages app opens with the number and text filled in.

  4. Check the message and tap Send in Messages. Nothing goes out until you do.