Event Notifiers

Creating an Event Notifier

Event Notifiers are created within Chronicle Bot to link Google Calendars to your Discord Server.

Connecting Calendars

One or more calendars may be selected from which Chronicle Bot will pull events.

To add a new calendar connection, locate the Calendar Connection section. On the left, you can select the green "Connect a Calendar" button which will open the calendar selection pop-up. From here you can pick your calendar type.

Connecting a Calendar and Discord Channel

If you wish to connect additional calendars click the green "Add" button and repeat the steps.

Google Calendar

When picking the Google Calendar connection type you will have the option of selecting a Google Account and a calendar, or to link a new Google Account.

Once a Google Account is selected, a new dropdown will appear from which you can select your desired calendar. It is a good idea to make a new calendar just for the events you want to be sent to Discord.

Google Calendar is a preferred calendar connection type as updates occur in near real-time. Chronicle Bot subscribes to a push notification feed for your calendar. As you create, update, or delete Google Calendar events, we receive push notifications from Google with the changes and can process those immediately.

iCal / ICS Calendar

When picking the iCal/ICS Calendar connection type, you can enter a calendar name and URL. The name is for your reference, but the calendar URL must resolve to a publicly available iCal document. The bot will validate this URL to ensure the calendar can be processed before being saved.

Due to iCal's limitations, this connection type requires regular polling, which prevents real-time updates. Premium licensed servers automatically refresh every hour, while unlicensed server iCal connections refresh every 12 hours.

Selecting the Discord Server and Channel

Next, on the right side of the screen select the Discord server and channel from the dropdown boxes. If your server is not listed make sure the bot has been added and you have the Manage Server permission.

Each Event Notifier can have only one Discord server and channel selected. This is the server and channel to which Chronicle Bot will send the events, reminders, and summaries.

Announcement Channels

When selecting an announcement channel an additional Auto Publish option will appear. Selecting this will cause Chronicle Bot to automatically publish all reminders and summaries sent to this channel. Due to rate limits on Discord announcement channels publishing and edits to these messages may be delayed.

Auto Publish Discord Announcement Messages

Event Filters

Events retrieved from connected calendars can also be filtered, allowing you to include or remove events from being processed based on their titles or tags. Event filters can also help split events from the same calendar into different Discord channels.

The Event Filters section can be found in a dropdown just below the Calendar Connections of your Notifier. When adding a filter, you can select to Include or Remove events whose Titles or Tags contain the Search Term you specify.

Creating an Event Filter

An additional dropdown will appear when adding more than one filter allowing you to select how the filters are combined. The options are Match All Filters (Logical AND) and Match Any Filter (Logical OR).

Event Filters will affect which events sync to Discord, are included in event summary messages, and which reminders appear in your Discord channel.

Naming a Notifier

When creating a notifier, you can optionally enter a name to identify the notifier. For those users who have a large number of notifiers, this can help with organization and identification.

Discord → External Calendar