ThingTweet

The ThingTweet App allows you to update a Twitter status via ThingSpeak. Twitter requires Open Authentication (OAuth) which is difficult for a low level device to interface with. ThingTweet acts a Twitter proxy, so the device can use Twitter by making simple API calls.


App Setup

Sign in to ThingSpeak, select Apps from the menu, and then click on ThingTweet.

Under the ThingTweet App, select "Link new Twitter account". This will redirect you to Twitter to see if you want the app to have the ability to access your account. You can Allow or Deny the process. Once you have confirmed the right Twitter account, Twitter will send you back to ThingSpeak.

The app generates a ThingTweet API Key for you to use. If you send an HTTP POST with your ThingTweet API Key, then the message will be relayed to Twitter. All of the parameters from the Twitter API (statuses/update) are possible including geolocation.


Update Twitter Status

To update your Twitter status send an HTTP POST to https://127.0.0.1:3000/apps/thingtweet/1/statuses/update and include your ThingTweet API key and message.

Example POST:
POST https://127.0.0.1:3000/apps/thingtweet/1/statuses/update
     api_key=XXXXXXXXXXXXXXXX
     status=I just posted this from my thing!

The response will be 1 if the update was successful, and -1 if there was an error.

Channel Values

You can retrieve the last value from a Channel field by including the following in the ThingTweet status:

%%channel_CHANNEL_ID_field_FIELD_NUMBER%%

For example, you can send a Tweet that includes the last value from Channel 1417, field 1:

status=The current CheerLights color is %%channel_1417_field_1%%.


Update Channel Feed and Twitter Status

Your Twitter status can also be updated when a Channel feed is updated by specifying the twitter and tweet parameters.

Example Channel feed update that also updates a Twitter status:
POST https://127.0.0.1:3000/update.json.xml
     api_key=XXXXXXXXXXXXXXXX
     field1=73
     twitter=thingspeaktest
     tweet=I just posted this from my thing!