gnu-social/doc-src/sms

<!-- Copyright 2008-2010 StatusNet Inc. and contributors. -->
<!-- Document licensed under Creative Commons Attribution 3.0 Unported. See -->
<!-- http://creativecommons.org/licenses/by/3.0/ for details. -->

You can post messages to %%site.name%% using many kinds of cell
phones that support SMS messaging. This site does not support SMS
directly; rather, it uses your carrier's email gateway to send and
receive messages.

Managing your SMS settings
--------------------------

Use the [SMS settings](%%action.smssettings%%) page to set your SMS
preferences. You can add or change your SMS number and set the
flags for SMS updates.

When you add or change your phone number, you'll receive a message on your
phone with a verification code. Enter it into the SMS settings page to
confirm that the owner of the phone authorizes sending it messages.

Note that only the carriers listed in the drop down list on the form
are supported by %%site.name%%. They're the only ones we know how to
make email addresses for.

Receiving messages
------------------

Once you've verified your phone number, you can enable sending
messages to your phone. If you have a lot of friends and a typical
phone, it can be hard to keep up.

Sending messages
----------------

To send a message, you must send an email to the incoming email
address visible on your SMS settings page. The method for sending
email from your phone varies from carrier to carrier and from handset
to handet; if in doubt, ask your carrier.

Keep your incoming email address a secret -- it's the only way we know
you're really you!

Commands
--------

You can use the following commands with %%site.name%%.

* on - turn on notifications
* off - turn off notifications
* help - show this help
* follow &lt;nickname&gt; - subscribe to user
* leave &lt;nickname&gt; - unsubscribe from user
* d &lt;nickname&gt; &lt;text&gt; - direct message to user
* get &lt;nickname&gt; - get last notice from user
* whois &lt;nickname&gt; - get profile info on user
* fav &lt;nickname&gt; - add user's last notice as a 'fave'
* stats - get your stats
* stop - same as 'off'
* quit - same as 'off'
* sub &lt;nickname&gt; - same as 'follow'
* unsub &lt;nickname&gt; - same as 'leave'
* last &lt;nickname&gt; - same as 'get'
* on &lt;nickname&gt; - not yet implemented.
* off &lt;nickname&gt; - not yet implemented.
* nudge &lt;nickname&gt; - not yet implemented.
* invite &lt;phone number&gt; - not yet implemented.
* track &lt;word&gt; - not yet implemented.
* untrack &lt;word&gt; - not yet implemented.
* track off - not yet implemented.
* untrack all - not yet implemented.
* tracks - not yet implemented.
* tracking - not yet implemented.