Daniel Wilms from the Maemo team said they're working on getting the Telepathy API documented with examples, but it is a complex task. He said it over here in the "Incoming call hook" thread.