Contents

Settings

Account

Email address and API password

This application requires access to the VoIP.ms API in order to retrieve SMS messages from your VoIP.ms account.

As such, before using this application, please ensure that you have:

You can make changes to VoIP.ms API settings here.

When signing into this application in Settings, please use:

DID (phone number)

This application can only retrieve SMS messages from one DID (phone number) in your account at a time.

As such, before using this application, you must select a DID from a list of SMS-enabled DIDs in your VoIP.ms account in Settings.

Synchronization

You can initiate a synchronization with the VoIP.ms servers by swiping down on the conversations list.

Synchronization tends to use up a lot of data if you don't have the "Retrieve only recent messages" option enabled, so you should minimize how often you do it. In general, it is only necessary to synchronize:

In general, it is not necessary to perform a synchronization to retrieve new messages; all new messages are downloaded automatically when the main conversations screen is loaded and when a push notification is received.

This limited update only looks at messages dated after the most recent message stored locally (similar to the "Retrieve only recent messages" option), so it uses up a lot less data.

Synchronization interval

You can configure the application to perform synchronizations automatically. Since it's not necessary to synchronize that often, the smallest interval is one day.

Message retrieval start date

When the application synchronizes with the VoIP.ms servers, it only retrieves messages on or after the message retrieval start date.

By default, this date is set to the date you installed the application. It is recommended that you set this to the date on which you created your VoIP.ms account, so that all of your SMS messages will be downloaded during synchronization.

Retrieve only recent messages

Normally, synchronization retrieves all messages dated on or after the message retrieval start date. You can configure synchronization to retrieve only those messages from the VoIP.ms servers that are dated after the most recent message that is stored locally by enabling this option.

This option significantly reduces the amount of data that synchronization uses.

Retrieve deleted messages

Normally, synchronization does not retrieve messages that have been deleted locally. You can choose to restore these messages during synchronization by enabling this option.

Propagate local deletions

Normally, synchronization< does not delete messages stored on the VoIP.ms servers that were deleted locally. You can choose to do this by enabling this option.

Propagate remote deletions

Normally, synchronization does not delete messages stored locally if they have been deleted from the VoIP.ms servers. You can choose to do this by enabling this option.

Note: Once you delete a message from the VoIP.ms servers, you can't put it back! This is true even if the message is stored locally. The VoIP.ms SMS API does not allow you to upload messages to the VoIP.ms servers.

Notifications

This application supports push notifications using Google Cloud Messaging. To enable push notifications:

You can make changes to VoIP.ms DID settings here.

The application will attempt to configure the URL callback feature for you automatically when you enable notifications; this second step is only necessary if the automatic configuration fails.

When push notifications are enabled, the application stores your DID and GCM registration ID on a server run by the developer. When your DID receives a text message, VoIP.ms will send a callback to the server. The server will then forward the callback to your device using Google Cloud Messaging.

To protect your privacy, the server only links DIDs with GCM registration IDs and tells your device when to sync with the VoIP.ms servers. It does not process or store the text of individual SMSes.

Database

Edit message database

This option exports the message database in JSON format and allows you to make changes to it using a text editor.

This allows you to make backups of the database in case you delete messages from the VoIP.ms servers or simply want to avoid re-downloading them all from the servers after resetting your phone.

Delete message database

This option deletes the entire SMS message database. This option is useful if you want to clean out old messages associated with a DID you no longer use.

Donations

If you'd like, you can make a donation to the developer using Google's in-app purchase feature in $0.99 CAD increments (or the equivalent in your local currency) using the Donate option in the application's main menu.

The in-app purchase is consumed immediately after you make the donation, so you can donate as many times as you'd like! :)

If you'd rather donate via PayPal, please click here.

Note: Making a donation does not unlock any additional features.

Reporting Bugs

If you believe you've found a bug, feel free to file a report at the project's GitHub repository here.

Contacting the Developer

If you have any further questions, feel free to contact the developer at michael@kourlas.net.