Perl API messages waiting

[Andy Brown]

Hi guys,
I'm trying to find how to trap when a new message is waiting and/or 
number of current unread messages.

The plugin I'm working on flashes an LED when unread messages are found, 
and it should then turn the LED off when there are no longer any waiting 
(mirroring the flashing status icon effectively), but I cannot spot the 
right procedural tie-in.
I found these 3:
Purple::Notify::message
Purple::NotifyUserInfo::new
Purple::Serv::got_im:

Which seem close to what I want, can anyone advise if there is a better 
one that I'm missing here please?

(please cc me to replies as i'm not subscribed to the list)

Thanks!

-- 
Andy
e: andy @ thebmwz3.co.uk
e: andy @ broadcast-tech.co.uk
w: http://www.thebmwz3.co.uk
w: http://www.broadcast-tech.co.uk