See privatemsg_hook.php for API documentation.