Skip to content

Pair a phone

Pairing links one Android phone to your organization. You need the dashboard open on a computer and the app installed on the phone. It takes about a minute.

  • You need a role that can manage devices in the dashboard.
  • The phone has finished the app’s first-launch pages and permissions, and shows Pair this phone.
  • A pairing code works once and lasts 10 minutes. If it runs out, create a new one.
  1. In the dashboard, open Devices and click Pair a phone.

    Click Pair a phone.
  2. The dashboard shows a QR code with a 10-minute countdown. On the phone, tap Scan QR code.

    On the phone, tap Scan QR code.
  3. The app explains that the camera is used only to read the code and that no images are stored. Tap Continue, then allow camera access when Android asks.

    Tap Continue, then allow the camera.
  4. Point the camera at the QR code on your screen. The phone reads it on its own; you don’t need to tap anything.

  5. The phone pairs and lists its SIM cards. In the dashboard, the dialog says the phone is paired and how many SIMs it found. On the phone, the Gateway tab opens and connects.

    The phone connects to SMSFabric.
  6. Click Done. The phone appears in Devices as online. On the phone, the dial says Online and “Connected. Waiting for messages.”

    The gateway is online.
  7. Choose which SIM sends by default. On the phone’s card in Devices, click Make default next to the SIM you want. Messages that don’t name a SIM go out on that one.

    Click Make default next to a SIM.

If your organization had no default SIM yet, the first SIM the phone reports becomes the default, so you can send right away.

Use this when the phone’s camera doesn’t work, or when you pair over a remote session.

  1. In the dashboard’s Pair a phone dialog, find the code under Or type this code in the app. It’s 16 characters in groups of four, like K7Q2-M9XD-P4WN-8RTV.

  2. On the phone, tap Enter the code instead under Pair with a code.

  3. Check Server URL. It’s usually https://api.smsfabric.com. Type the code in Pairing code, then tap Pair device. Capital letters and dashes are optional: k7q2m9xdp4wn8rtv works too.

    Type the code and tap Pair device.
  4. The button shows Pairing while the phone talks to the server. Then the Gateway tab opens, as in step 5 above.

    Pairing in progress.

The app shows what went wrong above the form.

The code expired or was already used.
Message on the phone What to do
This pairing code has expired or was already used. Click New code in the dashboard and scan again. Codes last 10 minutes and work once.
This QR code isn’t an SMSFabric pairing code. Scan the code in the dashboard’s Pair a phone dialog, not another QR code.
Can’t reach the server. Check Server URL and the phone’s connection, then try again.
The server’s certificate doesn’t match the one this app trusts. Don’t continue on this network. Someone may be intercepting the connection. Tell your admin.

More fixes are in Troubleshooting.

To stop using a phone, unpair it in either place:

  • On the phone, tap Unpair this phone in Settings. This stops the gateway, revokes the phone’s token on the server and moves its waiting messages to another phone in its pool. See Settings.
  • Or, in the dashboard, open the phone’s menu in Devices and choose Unpair…. Use this when the phone is lost or can’t reach the server.

To use the phone again, pair it with a new code.