This guide covers the installation of kChat, the instant messaging solution from kSuite. Also, refer to the getting started guide.

Getting kChat

kChat is offered with kSuite, with features tailored to each version of kSuite.

Once you have set up kSuite within your Organization:

• Access the kChat web app (online service at ksuite.infomaniak.com/kchat).
• … or click here to download the mobile app (application for iOS/Android smartphones or tablets) and the desktop app (desktop application for macOS/Windows/Linux).

Install kChat

macOS

• kChat may request access to the macOS Keychain for “Chromium Safe Storage”, which is used to store your access token.
• This request is normal and necessary for kChat to function properly; no additional sensitive data is requested, and nothing is sent externally.

Linux

• Under Linux, kChat is distributed in AppImage format, so depending on your system configuration, you may need to disable sandboxing for the application to function correctly:
  • If kChat does not launch, run it from a terminal using the following command: ./kchat.AppImage --no-sandbox
  • You can also create a launcher or script that includes this parameter to avoid having to enter it each time you use the application.

This guide details how to use smileys and other emojis to react to and interact with the discussions in the kChat service.

Introduction

• Refer to this other guide to add an emoticon to your username on kChat.
• Maximum number of custom emoticons:
  • kSuite Free = 5
  • kSuite Standard = 100
  • kSuite Business = 500
  • kSuite Enterprise = unlimited

Add a reaction to a message

To react to any message you have access to in kChat, simply hover over the message and select…

• either the emoticon from the selection
• or on the smiley with the small +:
  
• If there are already reactions (displayed below the messages), you can add one in the same place:
  
  

This will open the panel with hundreds of emoticons available (and even custom emojis - see below).

Express yourself with an emoticon or a GIF

Adding an emoji within the message you are writing is very simple:

• Simply click on the smiling face icon in the formatting bar of your message:
  
• You can then choose an emoji or insert short animated GIFs instead of an emoticon using the tab at the top of the panel that appears when you click on the smiling face:
  
  
• If you know the name of the symbol you want to insert, you can also type : (colon) followed by at least the first two characters:
  

Tip: if you add #, ##, or ### as the first character of a new line containing an emoticon, you can use a larger emoticon. To try it, send a message like '# :smile:' (note that your custom settings may "disable" this display feature in your interface).

To define the default skin tone for human emojis, click on this symbol in the emoji panel:

Custom Emojis

To manage additional emoticons, click this button in the emoji panel:

Specify a name up to 64 characters long. It can contain lowercase letters, numbers, and the characters “-”, “+”, and “_”.

Specify a .gif, .png, or .jpg file for your emoticon. The file can be up to 1 MB in size. The size is automatically resized to 128x128 pixels, while maintaining the aspect ratio.

The emoticon can then be used by all kChat users in your Organization using the unique name you assigned to it:

This guide explains how to insert rich text and images into your messages on kChat.

Format the message text (markdown)

Here are the symbols to add before and after your text to format it in the desired style:

ligne de code

You can also insert this:

Insert an image into the message…

… from a URL

Insert the following code into your message, replacing the alt text and the image address (URL) with the image link (the image must be accessible and visible on the web):

![alt-text](https://www.domain.xyz/xyz/image.png)

Example

Message with the image insertion syntax:

If the URL to the image is saved in your clipboard, simply paste the link into a conversation, and the image will be added to your message.

… from your hard drive or kDrive

Click on the paperclip icon to insert an existing image from your hard drive or from kDrive:

The image will be inserted into the message, which you can then send directly in the conversation without necessarily adding additional text.

This guide explains how to invite a user who is not yet part of your Organization to kChat, and who will be registered as a kSuite user.

Introduction

• Refer to this other guide to grant access to one or more kChat channels to an external user, who will then be able to interact with your team without being counted as a kSuite userand without having any specific rights within the Organization (of which he will not be a part).
• You can also invite an entire Group from kChat.
• Refer to this other guide if you wish to manage the channels to which new members will automatically belong.

Invite users to use kSuite

Prerequisites

• You must be a kChat administrator:
  
  • The role within the Organization is irrelevant; being an Organization administrator in the Organization that contains the kSuite (and therefore kChat) is not required, and is not sufficient in any case:
    
    

Next, invite the user following the procedure below. Once invited, the user will be able to confirm their membership and access kChat with the limited permissions you have granted them:

1. Click here to access the kChat management interface in the Infomaniak Manager (need help?).
2. Click on Add a user:
   
3. Click on Create a kSuite user.
4. Click on Next:
   
5. Enter the user's first name and last name, and define their role as a standard user:
   • Legal representative
     • Legal responsibility for the organization
     • Can manage all products and users
     • Can manage accounting and orders for new products
   • Administrator
     • Can manage all products and users
     • Can manage accounting and orders for new products
   • User
     • Can manage the products you authorize
     • Can manage accounting if you authorize it
6. Do not create a new email address for the user; instead, specify their existing email address to which the invitation should be sent:
   • You can require this future user to log in with this email address, or allow them to specify a different email address (this is particularly useful if they already have a user account with Infomaniak using a different login ID).
   • Add the user to your kSuite using the toggle switch.
7. Click the Invite button:
   
   • The invitation is pending until the invited user registers. The user dashboard for the Organization displays this status:
     

Accept the invitation

To access the Organization that owns kChat:

1. The invited user receives the invitation at their email address and clicks on the Accept invitation button:
   
2. They specify their contact details as well as the email address/password they wish to use and complete the registration:
   
3. Once registration is complete, the newly registered user can log in to their Manager and access the kChat to which they were invited.
4. Existing users are automatically notified of the new participant's arrival and can now chat with them; as soon as they are added, the new user receives a welcome message from Euria (Infomaniak's AI Bot):
   

Access to kSuite, and not access to the management of kSuite!

It is important to differentiate between using the kChat app (within kSuite) and managing kSuite itself.

In the invitation example above, the new user has been invited to join kChat, and is therefore now counted as a kSuite user when an administrator accesses the kChat user management section:

The same applies, of course, to kSuite user management:

However, this new user will not be able to directly manage the kSuite to which they have been invited, since their role (defined in point 5 above) does not authorize them to do so:

1. This is why this user will not see any active links in the Collaborative Tools → kSuite section of their Infomaniak Manager.
2. He will need to switch to the Infomaniak applications using the menu ‍ in the top right corner:
   

Note that, if he wishes, this user can order his own kSuite, independent of the kSuite to which he was invited.

This guide details the important elements to ensure you don't miss any of the kChat discussions that are relevant to you.

Introduction

• If notifications are correctly configured to work on the kChat mobile app, they will also work on smartwatches such as Garmin or Apple Watch.

Manage notifications from the desktop app icon

For example, you can choose to animate the desktop app icon when a new message arrives:

1. Open the kChat desktop app (desktop application on macOS / Windows / Linux).
2. Click on the desktop app icon in the notification area of your computer (top right on macOS, bottom right on Windows, and double-click in the taskbar on Linux).
3. Click on Preferences...
4. Under Application Options, adjust the operating system's notification preferences:
   

Manage discussion & event notifications

To manage kChat notifications, and thus be notified, for example, when a new message is sent directly to you or when you follow a specific message, including based on certain keywords:

1. Click here to access the kChat web app (online service ksuite.infomaniak.com/kchat), or open the kChat mobile app (application for iOS/Android smartphones or tablets), or the kChat desktop app (desktop application on macOS/Windows/Linux).
2. Click on the Settings icon ‍ in the top right corner of the interface.
3. Click on Notifications.
4. Define how you want to be notified (computer/mobile, present/absent, etc.) and under what circumstances (all messages or only messages with mentions, followed messages, etc.).
5. Choose to receive regular notifications by email:
   • This email is sent either every day or once a week, between 6 and 8 a.m., and informs the user about the messages they have not read.
   • The user receives an email per kChat product they have access to.
6. Define a keyword for which you want to be notified when a new message is posted:
   

Manage notifications for a specific channel

In the relevant chat channel:

1. Click on the chevron ‍ to the right of the name of the relevant channel.
2. Click on Notification Preferences (or directly on the dedicated icon at the top of the channel):
   
3. Browse and enable the desired notifications.
4. One of the options allows you to be automatically notified as soon as a discussion thread (thread) is initiated following a message posted in the relevant channel.
5. Save your choices by clicking the button at the bottom:
   

Manage notifications for a specific discussion

To be notified of a new message in a specific discussion thread, even if you are not a direct participant, you need to enable Follow:

• either by hovering over the action menu ••• to the right of a user in a discussion:
  1. and clicking on More…:
     
  2. then Follow message:
     
• or in a discussion thread (reply to a message):
  1. click on Follow at the top of the discussion (you automatically follow the discussion from the moment you post a message, and you can then Stop following the exchanges in this discussion thread):
     

This guide details the automatic translation service integrated into the kChat app by Infomaniak.

Translate text while reading

To automatically translate a received message written in a foreign language into your language:

1. Click here to access the Infomaniak kChat web app (online service ksuite.infomaniak.com/kchat) or open the mobile app (application for iOS/Android smartphones or tablets) or the desktop app (desktop application on macOS/Windows/Linux).
2. Go to the message you want to translate.
3. Click on the action menu ••• located in the upper right corner of the item.
4. Click on Translate:
   
5. The translated message is displayed after the last message in your conversation and is only visible to you:
   

Translate text with Euria while writing

You can ask Euria to translate the text you are currently writing:

1. Click on the Euria icon.
2. Enter your instructions:
   
3. The text will then be displayed in the desired language, and you can send it as follows:
   

This guide explains how to automatically receive a summary of your activities recorded in Infomaniak Calendar in your Mail inbox and/or kChat every morning.

Introduction

• This feature is disabled by default on all calendars.
• This summary is sent to your email address (the one you use to log in to your Infomaniak account).
• It contains a list of all the events for the day, along with their most important information (possible kMeet link, location, times, etc.).
  • You can even share this daily schedule with your team or assistant so they know when it's best to contact you, including by creating an rule for automatic forwarding based on the criteria corresponding to the email received.

Get a schedule automatically and daily

Prerequisites

• To send a summary on kChat, you must have kChat within your Organization.

Start your day by checking a message in your Infomaniak inbox containing the schedule based on your Infomaniak calendar:

1. Click here to connect to the unified settings of your Infomaniak web apps, and more specifically to the settings for the daily reminder in the Calendar app.
2. Check or select the relevant Organization from the dropdown menu in the left-hand menu.
   1. If you change it, return to the settings by clicking on the daily reminder item to access the settings:
      
3. Click the button to Add a daily reminder and configure it:
   

To customize your reminder according to your needs:

1. Select the calendar in question.
2. Choose the notification method (Mail, kChat, or both).
3. Choose when you want to receive the reminder (the evening before or early on the day itself).
4. Choose whether or not to include recurring events.
5. Choose the days during which the daily reminder will be sent.
6. Confirm your choices at the bottom of the page:
   

Disable the daily reminder

To stop receiving the daily summary via email or Euria on kChat:

1. Click on the link located at the very bottom of the notification you received:
   
2. Click on the reminder to delete it:
   
3. Delete the reminder from the edit page:
   

This guide explains how to receive a notification to review a specific kChat message at a set time/customizable time (depending on the plan, see below) in 30-minute increments.

✘ NOT AVAILABLE‍ with
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

kSuite Free does not allow you to customize the schedule when planning.

Schedule a kChat message to be sent at a specific time

To review a message later using a notification:

1. Hover over the message you want to be reminded about and select the additional actions icon ••• in the upper right corner.
2. Click on Reminder.
3. Choose the time you want to be notified:
   
4. A notification in the channel (visible only to you) indicates the upcoming message reminder:
   
5. You will then receive a notification from the Euria channel in the left-hand menu at the chosen time, leading to the reminder containing a quote from the message, as well as the necessary information to view the message, reschedule a reminder for later, cancel any other reminders, etc.

This guide details the principle of kChat conversations, organized within private and public chat channels, and direct discussions between users.

Starting a conversation

To send a message to a user in your Organization, click on their name in the list of members on the left side of your kChat interface:

You can also click on the + to the right of Private Messages to select up to 7 members and create a group conversation:

Compose and send your message by clicking the send button:

If needed, you can attach files up to 100 MB. You can also use “reactions”.

Scheduled sending: plan a message

✘ NOT AVAILABLE‍ with
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

kSuite Free does not allow you to customize the schedule when planning an email.

To schedule an email to be sent at a later date/time, simply click the chevron to the right of the send button and then choose the time the message should be sent:

In the kChat mobile app (application for iOS/Android smartphones or tablets), press and hold the send button for a few seconds, and a menu will appear to schedule the message.

Mention another user

To contact one of the members of the Organization (or an entire Group) via a message, type the at symbol @ to display the people or channels to mention:

Request a read receipt

To allow users to acknowledge receipt of your message and indicate that they have read it, enable a read receipt before sending the message in the channel by clicking on the (!) icon and then activating the toggle switch:

Once the message has been sent, the result will be as follows:

Edit / delete a message, or pin it

To edit a message (which will then display an "edited message" notification), click on the action menu to the right of the message you want to edit. In the same location, you can also delete your message, which will then disappear from the discussion for all users:

A notification regarding the deletion will appear for all other users in the channel, in the original location of the message.

In the same place, you can pin a message:

• Pinned messages are visible to all members of the channel, whether it is public or private.
• Messages pinned in a private channel are only accessible to members of that channel.
• You can view the list of all pinned messages via the "Pinned Messages" option in the channel.
• To remove a pinned message, hover over it again and select “Unpin”.

Organize conversations in kChat

The sorting method for the items you manage on the left side of the screen is very important.

Imagine opening kChat after several days of absence; the unread conversations will be displayed one after the other. After reading them, you may want to find information from a previously read conversation. In this case, sorting by recent activity (see below for other options) will allow you to find the latest conversations that are relevant to you.

This choice of sorting method is available for all items: discussion channels, categories, direct messages, etc. 

Search for a conversation

The search function for items (word, participant, file) is located at the top of the window. Once results are found, they appear on the right side of the window:

Thread

1. Regardless of the channel or private chat with another user, you can start a thread from another one simply by choosing Reply on the desired message.
2. A discussion thread will open in a side panel on the right, allowing each user in the channel to contribute to this specific thread without disrupting any new topics in the current channel (this thread can then be followed or ignored to stop receiving notifications for new messages – following is managed at the top of the side panel).
3. These discussion threads are then centralized for reading and rereading in the Discussion threads section of the left sidebar.

This guide details how to manage the members of your kChat chat service.

Prerequisites

• You must be a kChat administrator:
  
  • The role within the Organization is irrelevant; being an Organization administrator in the Organization where kSuite (and therefore kChat) is located is not required, and is not sufficient in any case:
    
• Invite a user to join kChat.

View the members of a channel

To view the users who have access to the selected channel:

1. Click here to access the kChat web app (online service ksuite.infomaniak.com/kchat) or open the kChat desktop app (desktop application on macOS / Windows / Linux).
2. Click on the profile icon to the right of the channel title or go through the Members menu.
3. Participants are displayed on the right side of kChat:
   

Invite or remove a member from a private channel

When you have opened the members panel of a channel:

1. The current participants are displayed on the right side of kChat.
2. The Manage button allows you to remove a member from this channel or designate them as the channel Administrator, so that they can, in turn, manage the members:
   
3. The blue Add button allows you to invite a kChat user or an entire Group that does not yet have access to this channel:
   
   • Refer to this other guide regarding guest additions, i.e., members who will not use a kSuite license to chat with you on kChat.

This guide explains how to manage external applications with kChat using webhooks.

Introduction

• A webhook is a method that allows an application to be notified immediately when a specific event occurs in another application, rather than constantly asking that application if anything new has happened ("polling").
  • Outgoing webhook: kChat communicates information to other apps when an event occurs in kChat.
  • Incoming webhook: kChat receives information from other apps to trigger actions in kChat.
• It is not possible to import the history of discussions from another application (Slack, Teams, Jabber, etc.) or from another Organization.
• Maximum number of incoming/outgoing Webhooks:
  • kSuite Free = 1 / 1
  • kSuite Standard = 20 / 20
  • kSuite Business = unlimited
  • kSuite Enterprise = unlimited

Accessing the kChat webhooks interface

Prerequisites

• You must not be an external user (they will not see the Integrations menu).

To configure a webhook, find self-hosted or third-party applications and integrations:

1. Click here to access the kChat web app (online service ksuite.infomaniak.com/kchat) or open the kChat desktop app (desktop application on macOS / Windows / Linux).
2. Click on the New icon ‍ next to your kChat organization's name.
3. Click on Integrations:
   
4. Access the categories:
   

Specific guides

Examples of integration on kChat:

• Calendar Infomaniak: display an event reminder on kChat
• n8n application: trigger the sending of a message on kChat

Guides for other uses

To create an incoming webhook (to display an external event on kChat):

1. Click on the Incoming Webhooks category.
2. Click on the blue Add incoming webhooks button:
   
3. Add a name and description for the webhook.
4. Select the channel that will receive the messages.
5. Click the button to Save:
   
6. The URL to keep for your developments is displayed (do not disclose it publicly); example: “https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx”:
   

Using the webhook

Quick example

1. A specific curl command (detailed below) is entered into a terminal.
2. The command contains the URL obtained in step 6 above.
3. The command will post a message in the channel specified in step 4 above:
   

Details

Regarding the application that will post on kChat:

1. Adjust the code below based on the URL obtained from kChat:

   POST /hooks/xxx-key-generated-xxx HTTP/1.1
   Host: your-server-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   {
       "text": "Hello, text1\nText2."
   }

2. If necessary, use the same request but with curl (to test from a Terminal application (command-line interface, CLI) on your device), as in the example image above:

   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, text1\nText2."}' {{URL_12}}

If no Content-Type header is defined, the request body must be preceded by payload= as follows:

payload={"text": "Hello, text1\nText2."}

A successful request will receive the following response:

HTTP/1.1 200 OK	
Content-Type: application/json	
X-Version-Id: 4.7.1.dev.12799dvd77e172e8a2eba0f4041ec1471.false	
Date: Sun, 01 Jun 2023 17:00:00 GMT	
Content-Length: 58	
	
{	
    "id":"x",	
    "create_at":1713198308869,	
    "update_at":1713198308869,	
    "delete_at":0,	
    "user_id":"x",	
    "channel_id":"x",	
    "root_id":"",	
    "original_id":"",	
    "participants":null,	
    "message":"test",	
    "type":"",	
    "props":{	
        "override_username":"webhook",	
        "override_icon_url":null,	
        "override_icon_emoji":null,	
        "webhook_display_name":"test",	
        "attachments":[	
	
        ],	
        "card":null,	
        "from_webhook":"true"	
    },	
    "hashtags":null,	
    "metadata":{	
        "embeds":[	
            {	
                "type":"message_attachment"	
            }	
        ],	
        "files":[	
	
        ],	
        "reactions":[	
	
        ]	
    },	
    "file_ids":null,	
    "has_reactions":false,	
    "edit_at":0,	
    "is_pinned":false,	
    "remote_id":null,	
    "reply_count":0,	
    "pending_post_id":null,	
    "is_following":false	
}

If you want to have the same response format as Slack:

HTTP/1.1 200 OK
Content-Type: text/plain
X-Request-Id: hoan69ws7rp5xj7wu9rmystry
X-Version-Id: 4.7.1.dev.12799dvd77e172e8a2eba0f4041ec1471.false
Date: Sun, 01 Jun 2023 17:00:00 GMT
Content-Length: 2
ok

You must add ?slack_return_format=true to the webhook URL.

Parameters

In addition to the text field, here is the complete list of supported parameters:

Code example with parameters

Here's how to generate a more complete message with parameters, some of which can replace parameters already defined when creating the webhook (username, preferred channel, avatar, etc.), as shown in the table above:

curl -i -X POST -H 'Content-Type: application/json' \
-d '{
"username": "System Monitor",
  "icon_url": "{{URL_13}}",
  "text": "### System Status Report\nEnvironment: PRODUCTION\nStatus: SUCCESSFUL\n\n---\n\n| Component | Version | Build ID | Status |\n|:----------|:-------:|:---------|:-------|\n| API-Core  | 2.4.1   | #88421   | OK     |\n| Web-UI    | 1.9.0   | #88425   | OK     |\n| Database  | 14.5    | N/A      | OK     |\n\n---\n\n**Commit Reference:**\n`git-ref: a7f8e9c21b` \n\n**Summary:**\nAll automated integration tests passed successfully. No manual intervention is required. Please contact the DevOps team for further details regarding this release."
}' \
{{URL_14}}

Result of a similar example in the image:

Thank you for choosing Infomaniak and kChat as your communication solution for you, your network, or your company! These guides will help you organize your channels, users, discussions, and more!

Introduction

• Cross-platform, kChat is the instant messaging service in kSuite that allows you to exchange messages, share files, and coordinate your teams securely from…
  • … your web browser
  • … your iOS / Android device
  • … your macOS / Windows / Linux computer
• Download the kChat app on your devices!
  • It is not possible to change the location of the kchat-desktop folder on your hard drive.
  • The content of discussions, photos, and videos is stored online on Infomaniak's secure servers.
  • The available storage size is the same as for kSuite.

What would you like to do?

• Configure kChat
• Manage users
• Manage a channel
• Manage a conversation
• React to messages
• Manage kChat notifications
• Format messages and insert images
• Send a voice message and its automatic transcription
• Translate the content of a message in the Infomaniak kChat app

A question or feedback?

• If you encounter a problem, please consult the knowledge base before contacting support.
• Click here to share feedback or a suggestion about an Infomaniak product.

This guide concerns messages that begin with / on kChat, which are interpreted as slash commands.

Executing a slash command on kChat

To access slash commands on kChat:

1. Click in the writing field within a channel.
2. Enter a / (slash or forward slash) and the associated command.
3. Validate to send the command.

If you only type the / sign, a modal will appear with the commands that can be executed, such as setting your status to "away," for example.

Here is a table of the main commands:

Creating a custom slash command

Prerequisites

• You must not be an external user (they will not see the Integrations menu).

To create a custom slash command:

1. Click here to access the Web kChat app (online service ksuite.infomaniak.com/kchat) or open the desktop kChat app (desktop application on macOS / Windows / Linux).
2. Click on the New icon next to your kChat organization name.
3. Click on Integrations:
   
4. Click on Slash command:
   
5. Click on the blue button to Add a command:
   
6. Configure the slash command (name, trigger (without the /), expected content type, action to be executed*, etc., including whether the command should appear in the help modal mentioned in the chapter above).
   • * This may include calling an external API, running a script, displaying a specific response, etc. For this, you will generally need an external script or application that will respond to the commands. You can also define additional parameters for the command, such as drop-down options, check boxes, etc., depending on your needs.
7. Save the command.
8. Make sure to test the command to ensure it works as expected.

This guide explains how to receive event reminders from the Infomaniak Web app Calendar (online service ksuite.infomaniak.com/calendar) on a messaging system like kChat, so you can be notified in the chat thread of your choice when an event is approaching.

Introduction

• The kSuite Free plan is limited to 1 webhook.

Link the kChat webhook to Calendar

Prerequisites

• Create an inbound webhook on the kChat app to obtain a URL of the type https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx:
  

Next, to add the webhook for your chat system to the Calendar app:

1. Click here to access the Infomaniak web Calendar app (online service ksuite.infomaniak.com/calendar).
2. Click on the Settings icon ‍ in the top right corner.
3. Click on Integrations in the left-hand menu.
4. Click on the Add a webhook button:
   
5. Define:
   
   1. A name to easily identify the webhook when adding reminders.
   2. The webhook URL (obtained from your chat system).
   3. The elements (automatically taken from your event and/or added manually here) and their layout in the message that will 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 location, if applicable.
6. Click the button to Add the configured item and see it created:
   

Create an event with chat reminder

Now that Calendar is linked to your messaging 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 Infomaniak Calendar web app (online service ksuite.infomaniak.com/calendar).
2. Click the ‍Create button in the upper left corner.
3. Click on Event:
   
   • You can also click on an existing event in the calendar to edit it.
4. Enter the event details.
5. Click on Add reminder to configure it:
   
6. In the dropdown menu for reminder types, select the webhook you configured (according to the name given in step 5a above).
7. Save the event at the bottom of the page:
   
8. When the reminder time arrives, a message (in the format configured in point 5c above) is sent to the event's recipient on the channel configured in the webhook (see prerequisites):
   

And on other messaging systems?

Slack

1. Click here to access the Slack WebHooks.
2. Choose the discussion thread where your reminders will appear (e.g. @slackbot or #general):
   
3. Save to obtain the webhook URL.

Create additional webhooks to define reminders in other threads.

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'event : %location%

This guide explains how to configure an action in n8n so that a message is sent on kChat when the conditions are met.

Prerequisites

• Install n8n on an Infomaniak hosting.
• Create a webhook on the Infomaniak kChat app.

Create the action in n8n

In your n8n session:

1. Click to start from scratch:
   
2. Click to add a first action.
3. Choose a manual trigger:
   
4. Click to add an action to trigger.
5. Search for and activate an action of the “HTTP Request” type:
   
6. Choose the POST method.
7. Enter the URL of your kChat webhook.
8. Authentication is not required (already applied in the URL).
9. Activate the “Send body” toggle switch to specify content:
   
10. In the “Name” field, enter the exact term “text” as expected by kChat.
11. In the “Value” field, enter the information you want to display on kChat.
12. Click the button to test and apply your custom command:
    
13. The message specified in n8n will then be displayed on kChat:
    

Now that this base is working, you could imagine replacing the fixed text with data from elsewhere. For example, add an "Imap" or "RSS Feed" node before the HTTP Request node. This way, instead of writing the text manually, click on the small gear next to Value > Expression to say: "Send the title of the last email received on kChat"…

This guide will quickly introduce you to the essential functions of Euria, the artificial intelligence available within kSuite, which is particularly effective for summarizing discussions on the kChat app.

Introduction

• Euria can help you perform all kinds of calculations, translations, provide information on various topics, and answer your questions.
• Please read this other guide about the model used and the responsibilities of each party.
• When a new user is added, they receive a welcome message from Euria.
• Please read this other guide about the possibilities for discussing with the AI in kChat.

Automatically summarize a kChat message

To obtain a summary of a kChat message:

1. Hover over the message and select the Euria actions icon in the upper right corner.
2. Click on Summarize the conversation:
   ‍
3. Get the summary, generated by Euria in the right sidebar:
   

This guide explains how to reply to an email visible in the Mail Infomaniak web app (online service ksuite.infomaniak.com/mail) by sending the reply directly in the kChat web app (online service ksuite.infomaniak.com/kchat) or the desktop app, as a private message to the email sender.

Introduction

• This feature allows you to reply to an email directly within kChat, with a reminder of the original message to facilitate understanding.
• It aims to streamline collaboration by enabling quick responses to emails without leaving the kSuite environment.
• It reduces the back-and-forth between traditional email and the collaborative workspace.

Reply to an email via kChat

Prerequisites

• The button providing access to the feature will only appear if the email was received from a sender associated with kSuite, and this within the same Organization as the user who wishes to reply.
• To display a shortcut to this feature, as in the first point 3 below, please refer to this other guide.

When you have received an email from a colleague and you want to reply to them directly on kChat:

1. Click here to access the Mail Infomaniak web app (online service ksuite.infomaniak.com/mail).
2. Open the message you want to reply to using kChat.
3. Click on the kChat icon in the email toolbar:
   
   • You can also click on a button below the message:
     
4. Write your kChat message, format it if necessary, and click the Send button in the bottom right corner:
   
5. Your contact receives the message on kChat, along with a box displaying the original email (date & time, subject):
   

You can access this message on kChat (in the thread of private messages exchanged with your contact as shown above), but also:

1. in an information banner on the email conversation,
2. in the email sending confirmation message:
   

This guide details how to use and manage channels in kChat.

Introduction

• A kChat channel is a dedicated communication space for a project, a topic, or a team, where members can exchange documents, chat in real time, and organize video conferences.
• The number of private (and public) channels, as well as the number of guests, is limited depending on the kSuite plan purchased; please refer to the comparison table on the sales page for more information.

⚠ History retention period (in days):

General Channel

Each Organization on kChat automatically has a General channel in which all users are automatically invited:

You can use this channel to share information that concerns your entire organization, such as company outings or inspiring good news.

You can, of course, start a new conversation thread within the General channel.

Additional channel

To add a new chat channel:

1. Click on the ‍ New button located in the left sidebar of the kChat web app (online service ksuite.infomaniak.com/kchat).
2. Click on Create a new channel.
3. You can also click on ‍Add channels below the list of channels:
   

Information about a channel

When you create a new channel, you can choose:

A. its name

It can be modified later.

B. its URL

By default, it uses the channel name, but you can modify it using lowercase letters, numbers, periods, hyphens, and underscores – it can also be modified later.

C. its status: PRIVATE or PUBLIC

It can be modified later (see below).

D. its description

The description allows you to specify how this channel should be used. This text appears in the channel list in the "More..." menu and provides users with an indication of whether or not they should join the channel.

Once the channel has been created, you can still define:

E. a header

and you can click on Information (F)…

… to find the information and be able to edit some of it:

Differences between PRIVATE and PUBLIC channels

PUBLIC channels increase transparency. All users can see and join a public channel, ensuring that everyone involved in a project, topic, or team has access to the same information.

PRIVATE channels allow you to restrict sensitive content to the users of your choice. Only an existing member can invite another user to a private channel. There are also differences in the management of archiving/deletion (see below).

⚠ Maximum number of PRIVATE / PUBLIC channels:

Convert a public channel to a private channel, or vice versa

Prerequisites

• Being a kChat administrator:
  
  • The role within the Organization is irrelevant; being an Organization administrator in the Organization that has kSuite (and therefore kChat) is not required, and is not sufficient in any case:
    
  • Being a channel administrator is also not sufficient.

It is possible to change a Public channel to a Private channel, or vice versa, and to make a private channel public. The message history and the members who already have access to the channel will be preserved.

To lock a channel that was previously public (files shared publicly remain accessible to anyone with the link; the change is permanent and cannot be undone):

1. Click on the chevron ‍ on the channel title at the top of the Public channel.
2. Click on the channel settings.
3. Choose Convert:
   

To make accessible a channel that was previously private (the channel will become accessible to all users of the other public channels in the Organization, except for external users who will need to be invited manually):

1. Click on the chevron on the channel title at the top of the chat on the Private channel.
2. Click on the channel settings.
3. Choose Convert:
   

You can also perform the conversion from the kChat management section in the Manager:

1. Click here to access the management of your kChat in the Infomaniak Manager (need help?).
2. Click on the dropdown menu to display private channels.
3. Click on the action menu ⋮ located to the right of the item in question.
4. Click on Convert to public channel:
   

Leave a channel

Aside from the main channel called General, you can leave a channel at any time:

1. Click on the chevron ‍ in the channel title at the top of the chat.
2. Click on Leave channel:
   

If you leave a private channel, you will no longer be able to find it in the search results, only via its URL if you have it, or by being re-invited by a member of the channel.

If you leave a public channel, you will leave it immediately, but you can rejoin it whenever you want by simply finding it again using its name (2) in the search (1), even if it has been archived:

Archive / delete a channel

Aside from the main channel called General, you can archive a channel at any time, which prevents any new messages and will no longer count towards the quota of your available channels. This operation can be performed from the Manager or directly on the kChat interface:

1. Click on the chevron ‍ on the channel title at the top of the chat.
2. Click on Archive the channel:
   

If you create a channel and then archive it, you can rejoin it whenever you want by simply finding it by its name (2) in the search (1):

You can then unarchive it:

1. Click on the chevron ‍ on the channel title at the top of the chat.
2. Click on Unarchive channel:
   
3. … or close it to no longer see it in your interface:
   

You can also delete a channel, in which case all associated data will be permanently deleted:

1. Click here to access the management of your kChat in the Infomaniak Manager (need help?).
2. Click on the action menu ⋮ located to the right of the item in question.
3. Click on Delete:
   

Add to favorites

To add any channel (or user) to your favorites:

1. From the kChat web app (online service ksuite.infomaniak.com/kchat), click on the star icon at the top of a channel or user.
2. A new Favorites menu will appear in the left sidebar, grouping all the items you have added as favorites (visible only to your user):
   

Mute a channel

You can hide the notifications from a channel so that you no longer receive them when a new message is posted:

1. From the kChat web app (online service ksuite.infomaniak.com/kchat), click on the action menu ⋮ to the right of the channel in question (in the left sidebar).
2. Choose Mute: 
   

Organize by categories

⚠ Maximum number of categories (per user):

You can add one or more categories to which you can assign items (channel, contact, etc.):

1. Click on the ‍ New button located in the left sidebar of the kChat web app (online service ksuite.infomaniak.com/kchat).
2. Click on Create a new category:
   
3. Next, drag the desired channel onto the created category (this applies only to your user):
   
4. You can also use the action menu ⋮ to the right of the channel in question (in the left sidebar) to perform these operations:
   

User-to-user chat channel

Private messages are direct conversations between two or more people that take place outside of channels.

Each user in an Organization can freely create personal messages, the content of which will only be visible to the relevant people:

Infomaniak is a Swiss company certified according to ISO 27001 and ISO 9001, and complies with GDPR.

Its primary objective is to guarantee the security and confidentiality of the data entrusted to it.

Numerous measures are in place to ensure the protection of your communications with kChat:

• The Infomaniak Manager allows you to check whether users in your Organization have enabled two-factor authentication.
• Data at rest and in transit is encrypted, as are the backups automatically created by Infomaniak.
• Data is hosted in Switzerland in data centers developed and managed exclusively by Infomaniak.

• … receive messages only from your colleagues or external users that you have approved.
• … can create private channels to restrict sensitive information to specific people.
• … continuously control the access rights of users who can access kChat.

This guide details the various elements that can be configured and customized in kChat to best suit your usage preferences.

Change the language of the kChat interface

The kChat web app is displayed in the language chosen in the Manager, and just like your avatar/profile picture, these settings are managed within your Infomaniak profile.

The desktop app is configured to use the operating system's language; you can manage this in the app's settings:

Configure kChat in the Manager

To access kChat settings in the Infomaniak Manager:

1. Click here to access the kChat management interface in the Infomaniak Manager (need help?).
2. Access the different types of channels.
3. Archive or delete channels from the bottom.
4. Click on Settings in the left-hand menu:
   
5. Add the channels (one or more channels possible) to which new users (excluding external users) will be automatically added, in addition to being members of the General channel.
6. Choose whether everyone can post in the General channel.
7. Save your changes at the bottom of the page:
   

Customize the general display of kChat

To access the kChat application settings:

1. Click here to access the web app kChat (online service ksuite.infomaniak.com/kchat) or open the mobile app kChat (application for iOS/Android smartphones or tablets) or the desktop app kChat (desktop application on macOS/Windows/Linux).
2. Click on the ‍ icon in the top right corner of the interface:
   
3. You can choose from the following options:
   
   1. a display density, and optional color display in compact density
   2. whether or not to display previews in your conversations
   3. the size (width) of a channel
   4. the starting position when you return to an unread channel
   5. the number of personal messages to display
4. The Notifications tab allows you to customize kChat notifications:
   
5. The Shortcuts tab displays the list of keyboard shortcuts available for working more efficiently with kChat:
   

Troubleshooting Display Zoom Issues

To zoom in or out if the display has become unreadable, use the following keyboard shortcuts:

• as in a browser, CTRL/CMD and - to zoom out
• CTRL/CMD and + to zoom in
• CTRL/CMD and 0 to revert to the default size

Dark Mode / Light Mode

The light or dark theme for the Web app is configured globally (refer to this other guide). However, the desktop app can be configured independently of the rest; this is configured from the ‍ icon in the top right corner of the interface:

Customize a chat, channel, etc.

Next to each item in the left sidebar is an action menu ⋮ that allows you, in particular, to define the sort order for channels (alphabetical, by recent activity, manual):

Set a status

To enhance your profile and its display, in kChat discussions but also on the various kSuite pages and tools, you can define a status in the form of text and/or an emoticon, with an optional expiration date:

1. Click on your avatar or initials in the top right corner of the interface.
2. Click on Choose a custom status:
   
3. Click on the smiley icon if you want to choose an emoji to display next to your name.
   • Refer to this other guide about kChat emoticons.
4. Enter a custom status or choose one from the suggestions.
5. Enter an expiration date if necessary.
6. Confirm with the Set Status button:
   

Using kChat with your domain and brand