Event reminder via webhooks with Calendar

This guide explains how to get event reminders from Infomaniak Calendar on a chat system like kChat or Slack.

This feature will allow you to be notified in the chat thread of your choice when an event is approaching.

What is a webhook?

The webhook system is a method for one application or service to send information to another application or service in real-time in a secure and authenticated manner.

Setting up the webhook in Calendar

To add the webhook from your chat system to Calendar:

1. Log in to Calendar (calendar.infomaniak.com), the calendar/agenda part of Infomaniak Mail, using a web browser like Brave or Firefox
2. Click on the icon at the top right of the interface
3. Click on the Add a webhook button (under Custom notifications)
   
4. Configure:
   
   • (A) A name for easy identification of the webhook when you add reminders
   • (B) The URL of the webhook (obtained from your chat system - examples are provided below in the FAQ)
   • (C) The elements (automatically taken from your event and/or added manually here) and their arrangement in the message that will be sent:
     • Insert %subject% to include the event's subject
     • Insert %date% to include the event's date
     • Insert %description% to include the event's description
     • Insert %location% to include the event's location
5. Click Save

Create an event with chat reminders

Now that Calendar is linked to your chat system account, you can choose to be notified in a chat when you add a reminder to an event:

1. Log in to Calendar (calendar.infomaniak.com) using a web browser like Brave or Firefox
2. Create a new event
3. Click at the bottom right to show the additional fields
   
4. Add a reminder
   
5. In the dropdown menu, select the configured webhook
6. Save the changes

You will now receive a reminder in the chat associated with the webhook.

Examples of obtaining a webhook

kChat

1. Open the kChat application
2. Go to the Integrations section
3. Click on Incoming Webhooks:
   
4. Click on Add at the top right
5. Complete the required information to create the "bot" that will post reminder messages in kChat in the channel of your choice:
   
6. Save to obtain the webhook URL:
   
7. Create the custom notification in Calendar (read above if necessary):
   
8. Select your custom notification when adding a reminder to your event:
   

Slack

1. Open this Slack page and authenticate with your Slack credentials
2. Choose the channel where your reminders will appear (e.g., @slackbot or #general)
   
3. Save to obtain the webhook URL

Create other webhooks to set reminders in other chat threads.

Customize Slack reminder messages

You can freely use Slack's formatting options in your notifications. For example:

Don't forget to %subject% for %date%.
Mark the date: %description%.
Event location: %location%