...
Syntax | Description | Example | Note |
---|---|---|---|
@username | Selects messages sent by a particular user | @dpp |
|
any | Selects all messages regardless of their characteristics | any |
|
/regex/ | Selects messages if body matches a regular expression | /exception/ |
|
"string" | Selects messages if body contains the case insensitive string | "sales order" |
|
#tag | Selects the messages contains containing the tag. | #project gumbo | Note the tag could be in the message as a hash code or created by the user directly as a tag |
to = @username | Selects the messages that were sent to a particular user | to = @dpp |
|
to = (@username1, @username2) | Selects the messages that were sent to multiple users. | to = (@dpp, @m) | List should be comma separated |
to <> @username | Selects the messages that were not sent to a particular user | to <> @dpp |
|
not(exp) | Selects the messages in which the expression evaluates to false | not("sales order" ) |
|
exp1 | exp2 | Selects the messages in which either expression is true | "sales order" | "profit" |
|
exp1 & exp2 | Selects the messages in which both expressions are true | "sales order" & "profit" |
|
number% | Returns messages based on the percentage. | 44% | For example, the 45% will be true 45% of the time. |
Hooks (messages generated on system events)
Syntax | Description | Expansions in HTTP POST and mail actions |
---|---|---|
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 |
Info | ||
---|---|---|
| ||
Messages generated by events can be used in the actions test expression, since the event cause is attached to them. Messages generated by events appear by default in the user's timeline, but not in follower's timeline. The message can be resent to followers using the existing resend action, or suppressed from user's own timeline by means of the filter action. Any and all saved messages appear in the public timeline (this could be addressed by these messages being private by default in the future). |
Actions (performances)
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 irregardless 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, e.g. status=%s ; %s expands to original message | |||
atom: url:// | Posts the new entries from Atom/RSS feed | atom: http://twitter.com/statuses/friendsuser_timeline/esmeproject.atom![]() |
| rss: url:// | Bots can also post to ESME, but polling from ESME is more secure and robust |
Examples
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: | Posts the new entries from RSS feed | rss:// http://blog.esme.us/feed/rss![]() |
|
Examples
TODO
...
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 |
Additional Links
There are many lists of ad-hoc Twitter third-party tools, some of which might be assembled in ESME using actions.