APRS to WhatsApp Gateway for Amateur Radio
The 3 formats of the messages:
[@][international phone number/alias] [message body] [#][command] [command body] [follow up messages, coversation mode]
@sign will indicate a command to send messages: It should be followed by an international phone number or an alias.
Example: Sending a message “this is my message” to the international phone number
To: WTSAPP Message: @+123-456-7890 this is my message
OR without dashes
To: WTSAPP Message: @+1234567890 this is my message
Example: Sending a message “this is my message” to the alias
To: WTSAPP Message: @me this is my message
#sign this indicates a command. Currently, there are two commands. One
SETto set or create an alias. One
RMto remove an alias.
Example: Creating an alias called
me with the international number +123-456-7890
To: WTSAPP Message: #SET me +123-456-7890
Example: Removing an alias called
To: WTSAPP Message: #RM me
Once an initial message establishes a destination by the use of
@ Subsequent messages to the same destination don’t need the destination anymore.
Example: Sending a message “this is a follow up message” to the destination used before.
The session time is 1 hour, after that conversation mode will not work, and you will need to use the
@ sign again to establish a destination.
Note: If you are sending messages to multiple recipients at the same time, you should always use the
To: WTSAPP Message: this is a follow up message
The format of the numbers:
Phone numbers must be numeric. They can contain dashes
- and they can start with international format using the
+ sign, otherwise it will be considered a USA based number.
Numbers not correctly formatted will cause an error.
The format of the aliases:
Aliases can be any single word format. However, if it looks exactly like a phone number it will be considered invalid. Aliases not correctly formatted will cause an error.
Rate Exceeded*various messages that indicate the rate limitations
No conversation to follow up, missing directive.You sent a messages from APRS without a destination using the
Invalid commandYou sent a message starting with
#sign but doesn’t match any of the commands known.
Invalid set alias command bodyYou tried to use the set alias command but the message was not properly formatted.
Invalid remove alias command bodyYou tried to use the remove alias command but the message was not properly formatted.
No active session found for incoming fromThe WhatsApp user replied to WTSAPP Gateway but there was no active conversation. Conversations must be initiated by the radio user and conversations remain active for one hour to allow replies.
statusmessages on both ends. Watch for them.
stay in touchor
check induring limited connectivity, it is not intended to create a full day-to-day conversations. Please use it sparingly.
THE SERVICES ARE PROVIDED “AS IS” AND “AS AVAILABLE” WITHOUT REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF ANY KIND, WHETHER EXPRESS, IMPLIED, LEGAL, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY, TITLE, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. I DO NOT WARRANT THAT THE SERVICES ARE ACCURATE, COMPLETE, RELIABLE, CURRENT, OR ERROR FREE. I DO NOT CONTROL, ENDORSE, OR TAKE RESPONSIBILITY FOR ANY CONTENT AVAILABLE ON OR LINKED TO THE SERVICES OR THE ACTIONS OF ANY THIRD PARTY OR USER, INCLUDING LICENSED RADIO AMATEURS.
IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY INDIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, SPECIAL, OR PUNITIVE DAMAGES, OR LOST PROFITS ARISING FROM OR RELATING TO THESE TERMS OR THE SERVICES, INCLUDING THOSE ARISING FROM OR RELATING TO CONTENT MADE AVAILABLE ON THE SERVICES THAT IS ALLEGED TO BE DEFAMATORY, OFFENSIVE, OR ILLEGAL. ACCESS TO, AND USE OF, THE SERVICES IS AT YOUR OWN DISCRETION AND RISK, AND YOU WILL BE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR DEVICE OR COMPUTER SYSTEM, OR RESULTING LOSS OF DATA.
Special thanks to VK3TMO for extensive testing and finding many bugs.
Best place to discuss this is at this reddit community r/aprs_wtsapp You can also email me at wtsapp [at] wtsapp.org Please forgive me if I don’t reply immediately, this is a side project with limited time.
Anything helps with the server and service fees. Thanks.