This guide explains how to get event reminders from the Infomaniak web app Calendar (online service calendar.infomaniak.com) on a chat system like kChat or Slack.

Preamble

• This feature will allow you to be notified in the chat thread of your choice when an event is approaching.
• The webhook system is a method for one application or service to send information to another application or service in real-time, securely and authenticated.

Announce the webhook to Calendar

To add the webhook of your chat system to Calendar:

1. Click here to access the Web app Calendar (online service calendar.infomaniak.com).
2. Click on the Settings icon ‍ at the top right.
3. Click on Integrations in the left sidebar.
4. Click the Add a webhook button:
   
    
5. Set up:
   
   1. A name to easily identify the webhook when you add reminders.
   2. The webhook URL (obtained from your chat system - examples are presented further down in the FAQ).
   3. The elements (automatically retrieved from your event and/or added manually here) and their arrangement in the message to be sent:
      • Insert %subject%‍ to include the event subject.
      • Insert %date%‍ to include the event date.
      • Insert %description%‍ to include the event description.
      • Insert %location%‍ to include the event's possible location.
6. Click on Add.

Create an event with a chat reminder

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. Click here to access the Web app Calendar (online service calendar.infomaniak.com).
2. Create a new event.
3. Click at the bottom right to display additional fields:
   
4. Add a reminder:
   
5. In the dropdown menu, select the configured webhook.
6. Confirm the changes.

You will now receive a reminder in the chat corresponding to the webhook.

Examples for obtaining a webhook

kChat

1. Click here‍ to access the kChat Web app (online service kchat.infomaniak.com) or open the kChat desktop app (desktop application for macOS / Windows / Linux).
2. Go to the Integrations section.
3. Click on Incoming Webhooks:
   
4. Click at the top right on Add.
5. Fill in the required information to create the "bot" that will post reminder messages in kChat in your chosen channel:
   
6. Save to get 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. Click here to access Slack WebHooks.
2. Choose the conversation thread where your reminders will appear (e.g. @slackbot or #general):
   
3. Save to get the webhook URL.

Create other webhooks to set reminders in other channels.

Customize the reminders of a Slack reminder

You can freely use Slack's formatting options in your notifications. Example in French:

N'oubliez pas de %subject% pour le %date%.
À prendre avec le jour J : %description%.
Lieu de l'évènement : %location%