Juan

October 03, 2022 14:40
Updated

GpsGate Android SMS proxy

GpsGate Android SMS Proxy makes it possible to use an Android device with SMS capabilities to send and receive SMS from/to GpsGate using your local telephony provider as an alternative to a web based SMS provider.

Minimum requirements

Android OS 4.1

Downloading the GpsGate SMS Proxy for Android

Download the latest version of SMS proxy from here:

GpsGate SMS Proxy download

Installing SMS Proxy in an Android device

1. Copy-paste the downloaded APK file, into your phone's storage location.

2. Install the APK file following your phone's instructions.

Setting up GpsGate Android SMS Proxy

GpsGate Installation

1. Log in to Site Admin.

2. Go to the Settings tab.

3. Go to the SMS option.

4. Select ProxyMessageProvider from the list.

5. Set the Name field to something to describe your new SMS proxy.

6. Set the Proxy user credentials. You could use any of your choice here. These credentials will be used in the phone application to login.

7. Set the Sender ID. The Sender ID is the phone number from where your SMS will be sent.

8. These additional options are optional. Read their instructions in case you need them.

9. Click Save to finish.

Now your SMS proxy should be on the list and enabled, ready to use!

Setting up the Android app

Check that your Android device is capable of both sending and receiving SMS.

1. Open the SMS proxy app installed on your phone.

2. Enter the credentials specified in the setup above.

3. Click on the Start button.

4. Use the Test functionality to verify it's working as expected.

Your SMS proxy app is now ready to be used!

Tips

You are able to see the status of the GpsGate SMS Proxy in your device notification area while the app is connecting or connected.

Please note, while the GpsGate SMS Proxy app is Connected to the server, all SMS received by the device will be sent to the server.
Make sure to install the app on a device that is purchased specifically for the task of being a GpsGate SMS proxy.

Troubleshooting

Permanently stuck on Connecting to server

When the Start button is pressed the app will try to connect to GpsGate. It will keep trying to connect to the specified hostname or IP address until it makes a connection. If you see the connecting screen below for more than a minute click the Stop button and check your server address again.

You may have a networking issue. Check our guide to resolving connectivity issues.

Username or password is incorrect

If the app can connect to the GpsGate, but the wrong credentials were supplied you will see the error message below.

Check your credentials against those entered in Site Admin > Settings > SMS > Your proxy provider

Viewing your message history

1. Look on your device's file system on the primary storage drive.

You can access this either by using a file navigator program on the device or by plugging your device into a PC with a USB cable and browsing its storage.

2. Find the "GpsGate" folder and browse in the SmsProxy sub-folder.

3. To find the error log for the day you want to observe, find the files named with the format sms-YYYYMMDD.txt where YYYY is the year, MM is the month and DD is the day.

4. You can read this file to see a complete history of outgoing and incoming text messages that were successfully sent by the GpsGate Android SMS Proxy app

Feedback

If you still experience problems with SMS Proxy, we might have to take a look at the logs.

Sending the error log

1. Look in your device's file system on the primary storage drive.