What VMGateClient is

The phone-side app that terminates VMGate calls on GSM.

What VMGateClient is

VMGateClient is the Android app installed on field phones. It joins your tenant’s VMGate network, keeps a secure link to VMGateServer, and places outbound mobile calls when the cloud assigns them.

The app does not originate wholesale SIP traffic on its own. A Customer switch sends SIP to VMGateServer; VMGateServer picks routing and tells VMGateClient which number to dial on GSM.

Each phone also needs the separate VMGate Audio app for call audio — both apps must be installed and kept on the same release (chapter 03).

Install is a normal APK from the portal — no device modification required.

How it fits in VMGate

End-to-end flow:

  1. A Customer switch sends SIP to your tenant’s VMGateServer ingress.
  2. VMGateServer matches dialpeer and routing rule, selects an online VMGateClient and SIM slot.
  3. VMGateClient dials the destination on GSM; voice flows through the USB audio board.
  4. Call history and billing appear in the VMGateServer portal.

VMGateClient holds the SIM and radio. VMGateServer holds SIP ingress, routing, policy, and billing. Portal operators configure networks, clients, and policy in the VMGateServer manual; installers follow this manual on the phone.

Setup journey (this manual)

From a blank phone to taking traffic:

  1. Chapter 02 — Requirements — phone, SIM, USB audio board (ESP32-S3-DevKitC-1-N16R8), storage, and what to prepare before install.
  2. Chapter 03 — Install — download the APK, install it, then complete first launch: Android permissions, VMGate Audio install, startup sequence, and connect the flashed board.
  3. Chapter 04 — First pairing — your administrator gives you a join code; you create a network profile, connect, accept the license, and turn on Termination enabled. The device appears in the portal.
  4. Chapter 05 onward — daily operation, audio, updates, and troubleshooting.

Your tenant administrator generates join codes in the portal (VMGateServer manual chapter 04) and shares the APK link from Client QR Codes before you start on the phone.

Network profiles on the phone

One physical phone may hold multiple network profiles over time (for example different tenant networks or a reinstall with a new join code). Only one profile is active at a time — it controls which network VMGateClient registers to.

Open menu → Profiles to add, switch, or rename profiles. Creating a profile with a join code is covered in chapter 04.