...
Hooks (messages generated on system events)
Syntax | Description | Expansions in HTTP POST and mail actions Notes |
|---|---|---|
login | Selects the messages generated on user login. | %u expands to user nickname |
follow | Selects the messages generated when a user follows you. | %u expands to user nickname, %f expands to follower nickname |
unfollow | Selects the messages generated when a user unfollows you. | %u expands to user nickname, %f expands to ex-follower nickname |
profile | Selects the messages generated when your profile is changed. | %u expands to user nickname, %i expands to image URL, %w expands to user's full name (first + last) |
every number mins | Generates messages at regular intervals and selects them. | The message is not saved- too noisy, plus two identical tests never refer to the same event |
...
Syntax | Description | Example | Note | ||
|---|---|---|---|---|---|
filter | Filter the message out and don't put it in your mailbox | filter |
| ||
resend | Resend the message to all your followers regardless of their characteristics | resend | It will only be put in your followers timeline if it is not already there. | ||
mailto: email | Send the body of the message to the email recipient |
|
| ||
http:// server | Does an HTTP(S) POST of the message on a server with certain headers set | http://user:password@twitter.com/statuses/update.xml
| Enter HTTP POST data on a new line; %s expands to original message, %u expands to user nickname, %i expands to image URL, %w expands to user's full (mnemonic: w hole) name (first + last) | ||
atom: url:// | Posts the new entries from Atom/RSS feed | atom: http://twitter.com/statuses/user_timeline/esmeproject.atom | Bots can also post to ESME, but polling from ESME is more secure and robust |
Examples for assembling tests and actions
Test | Action | Description | Similar to |
|---|---|---|---|
follow | mailto: mail | Sends mail when followed by any user | Twitter sends messages on follow |
unfollow | mailto: mail | Sends mail when unfollowed by a user | Qwitter helps track who is unfollowing you |
profile | http:// server | Sends HTTP POST when the profile is changed | @chinposin on Twitter tracks your avatar change to chinposin.com |
every 5 mins | rss: http://blog.esme.us/feed/rss | Updates new posts from the ESME blog | twitterfeed posts your blog titles to Twitter |
login | resend | Notifies your followers when you log in | Yammer notifies when a user logs in for the first time |
http://user:password@twitter.com/statuses/update.xml
| Posts all messages tagged #twitter to Twitter | Identi.ca integrates with Twitter by reposting messages |
...