Event Hooks

Event hooks allow you to extend Obsidian's event notifications to support things like instant messaging, customized logging, etc. This feature was introduced in version 4.5.0.

EventHook Interface

EventHook Javadoc

Note: If you need to set up a development environment to create Obsidian event hooks, see the Classpath section.

Implementing custom notifications in Obsidian is as simple as implementing a single interface and calling a method to register it with the scheduler.

The interface you need to implement is the following.

public interface EventHook {
    public abstract void dispatch(Event event) throws Exception;
}

After creating an instance of a class that implements EventHook, you simply need to register it with Obsidian. The example below shows our reference implementation which posts notifications to a Slack channel by using incoming web hooks.

    EventHook customNotifier = new SlackEventHook("Obsidian Scheduler", "https://hooks.slack.com/services/XXXXXXX/YYYYYYYY/ZZZZZZZZZZ", SlackEventHook.DEFAULT_LEVELS, SlackEventHook.Default_CATEGORIES);
    eventHooks.register(customNotifier);