Jabber Bot

From StatusNet

Jump to: navigation, search
identi.ca
documentation

Contents

[edit] The Jabber Bot

StatusNet comes with a XMPP/Jabber bot written in php. If that bot is running at your server, you can post and receive dents within your Jabber/GTalk client. The bot will then act as a normal contact. To publish notices just send them to the bot, in exchange you get all the dents from your webinterface all time-line (and eventually also @replies from peoples you're not subscribed to) delivered into your client.

At identi.ca the bot can be reached at update(at)identi.ca. Other servers may or may not offer the bot.

After you registered the Jabber bot as a contact, you have to configure its behaviour. The settings for XMPP are located in the upper menu Connect and then the IM tab.

[edit] Bot Commands

The Jabber bot understands some commands to do things via XMPP that you also can do in the webinterface. You can tell the bot to show a basic help just by sending the word

help

to it. No preceding / like in IRC.

At the moment the Jabber bot understands the following commands:

on ................... turn on notifications
off .................. turn off notifications
help ................. show this help
follow <nickname> .... subscribe to user
leave <nickname> ..... unsubscribe from user
d <nickname> <text>  . direct message to user
get <nickname> ....... get last notice from user
whois <nickname> ..... get profile info on user
fav <nickname> ....... add user's last notice as a 'fave'
fav #<notice_id> ..... add notice with the given id as a 'fave'
stats ................ get your stats
stop ................. same as 'off'
quit ................. same as 'off'
sub <nickname> ....... same as 'follow'
unsub <nickname> ..... same as 'leave'
last <nickname> ...... same as 'get'
groups ............... lists the groups you have joined
subscriptions ........ list the people you follow
subscribers .......... list the people that follow you
reply #<notice_id> ... reply to notice with a given id
reply <nickname> ..... reply to the last notice from user
join <group> ......... join group
drop <group> ......... leave group
nudge <nickname> ..... remind a user to update.

For some currently unknown reasons identi.ca has a problem with jabber.org XMPP accounts. If it happens to sadden your StatusNet experience you might try another XMPP service ;-)

[edit] IdentiSpy

IdentiSpy is a real-time tracker by @dustin and @kshep. You can use it to track topics from identi.ca and the TWiT Army. You can also use it to post to these two and twitter.

To use IdentiSpy just add laconica(at)west.spy.net to your Jabber contact list and tell it the topics to track with the command

track topic

Then wait some minutes and IdentiSpy will send you all notices in which the topic was mentioned.

If you don't want to get the notices from one particular user, you can add an

add_stop from:user

to your track list. You will not receive any more notices from that user in the tracker. Also you can tell IdentiSpy to not send you notices covering a specific topic by

add_stop badtopic

For further information please ask "help" in the chat window with IdentiSpy and have a look at the homepage at www.microblog.org/wiki/IdentiSpy.

[edit] IdentiChat

If you rather like to have a "multi user chat" (MUC) interface for your identi.ca usage, you can use the IdentiChat service by @zeen. For each user exists a MUC that you can access at your-identica-id@identichat.prosody.im. Beside you, all the accounts you are subscribed to are participants in the MUC, but one you can post there, the service posts every notice of the other participants.

To register at IdentiChat you have to send

!register identica-username identica-password

as message in the MUC, the bot will recognize this as your identi.ca login data and save them in association to your Jabber-id.

For more information please visit the service homepage at identichat.prosody.im.

[edit] Setting up your own jabber

If you have your own installation of StatusNet, you can find info on how to set up a jabber/xmpp bot at Jabber/Setup

Personal tools