Adventure Bot

Adventure bot (advbot for short) is a tool to help you make the most of the site whilst out on your adventures and to give your media context as part of your whole trip.

Adventure Bot can:

1. Tweet messages for you, automatically including your hashtag and a link to your map
2. Send you a status report with details of your latest (or current) track map
3. Change the icon of your last location
4. Change your latest map title
5. Change the privacy of your latest map

Enabling Adventure Bot

To enable Adventure Bot:

1. Login to shareyouradventure.com
2. Go to 'Your Settings' - 'Social Settings'
3. Tick the box to enable Adventure Bot

In order to work, you also need to be following the @advbot twitter account.

Using Adventure Bot with Twitter

To use Adventure Bot with Twitter, send @advbot a direct message:

a) starting with 'status' (without quotes) - this will trigger Adventure Bot to send you a direct message back with details of your last (or current) track map. The tweet includes: activity, how many beacons the map includes, distance, time (and timezone) the last beacon was received, whether comments are on, whether the map is live and a short URL to the map.

b) starting with 'echo' or 'e' (without quotes) followed by a space and a short message - this will trigger Adventure Bot to take the text of your message (after removing the command), add your hashtag and (if possible) a link to your map, and tweet the message for you from your Twitter account. A map link will only be included if the tweet can be linked to a map beacon.

For example, sending a direct message to @advbot like: "status" will return a direct message like "Status: hiking - public - 3 beacons - 14 miles - 18 Jun 2012 15:15 Europe/London - comments ON - http://bit.ly/Na0SfM" or "echo Loving the weather today" will cause a tweet to be sent from your account like "Loving the weather today http://bit.ly/Na0SfM #sh"

For the 'echo' and 'e' commands, Adventure Bot will send you a direct message back confirming the tweet has been sent.

c) starting with 'help', @advbot will send you a direct message back summarising the commands available, with a link back to this page.

d) starting with "icon" (without quotes) followed by #camp, #pub, #info, #food or #castle (or #clear which removes the icon) - Adventure Bot will change the last icon on your current live track map to the requested icon (only one icon can apply to each location)

e) starting with "title" (without quotes) followed by a new title - Adventure Bot will change the title of your latest track map to the requested title.

f) starting with "privacy" (without quotes) followed by either private or public - Adventure Bot will change the privacy setting for your latest track map to the specified privacy

Adventure Bot with SPOT

Adventure Bot can also be triggered using SPOT messages. As this is a passive function, some additional setup is required.

1. Ensure Adventure Bot is enabled (see details above)
2. Under 'Location Sources' - 'SPOT', edit your SPOT connection settings.
3. Tick the 'Enable Adventure Bot' option.
4. If you wish, you can setup Adventure Bot to process every SPOT message as an echo command - as this means no command is needed, it is cleaner if you have connected SPOT to Facebook, or you also share your SPOT map, however it does mean that all your SPOT messages (pre-defined or custom, but not emergency) will be published to your twitter stream.

Once setup, the same commands can be used as above. For example sending a SPOT message like:

"status" will cause you to receive a Twitter direct message like "Status: hiking - public - 3 beacons - 14 miles - 18 Jun 2012 15:15 Europe/London - comments ON -http://bit.ly/Na0SfM" or "echo Loving the weather today" will cause a tweet to be sent from your account like "Loving the weather today http://bit.ly/Na0SfM #sh"

For the 'echo' and 'e' commands, Adventure Bot will send you a message back confirming the tweet has been sent.

Receiving Responses from Adventure Bot

Be default, Adventure Bot will send you a direct message on Twitter with any response to your commands.

Adventure Bot can also send responses direct to your phone via a push notification using the service Pushover, or emails to your email address - the amount of information in each response varies depending on the command on how the response is being sent.

You can change how Adventure Bot sends you responses under the 'notifications' tab under 'your settings'.