This guide concerns the installation of kChat, the instant messaging solution of my kSuite.

Get kChat

kChat is offered with my kSuite, with capabilities adapted to each version.

Once you have set up my kSuite within your Organization:

• Access the kChat Web app (online service ksuite.infomaniak.com/kchat)
• … or click here to download the mobile app (application for iOS / Android smartphone or tablet) and the desktop app (desktop application on macOS / Windows / Linux).

Also refer to the getting started guide.

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

Add a reaction to a message

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

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

You will thus open the panel with hundreds of emoticons available (and even custom emojis - read below).

Expressing yourself with an emoticon or a GIF

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

• Just 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 thanks to the tab located at the top of the box that appears when you click on the smiling face:
  
   
• If you know the name of the symbol to insert, you can also type : (2 points) followed by at least the first 2 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, send a message like '# :smile:' (note that your custom settings may "disable" this display feature on your interface).

To set the default skin tone of human emojis, click on this symbol of the emoji panel:

Custom emoticons

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

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

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

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

This guide explains how to insert rich text and images within 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 in the message…

… from a URL

Insert the following code into your message by replacing the alternative text and the address (URL) of the image with the image link (the latter must be accessible and visible on the Web):

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

Example

Message with image insertion syntax:

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

… from the hard drive or kDrive

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

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

This guide explains how to invite a user who is still external to your Organization to kChat but who will be counted as a my kSuite user.

Preamble

• Refer to this other guide to grant access to one or more kChat channels to an external user who can thus interact with your team without being counted as a my kSuite user and without having any special rights in the Organization (of which they will not be a part).
• You can also invite an entire work team from kChat.
• Refer to this other guide if you wish to manage the channels to which new members will automatically belong.

Invite to use my kSuite

Prerequisites

•  Be an administrator of the Organization where my kSuite is located with full rights granted for kChat.
   

Once invited, the user can confirm their membership and will access kChat with the limited permissions you have granted them:

1. Click here to access the management of kChat on the Infomaniak Manager (need help?).
2. Click on Add a user:
   
3. Click on Create a my kSuite user.
4. Click on Next:
   
5. Enter the user's first and last name, and define their role as a simple user:
   • Legal representative
     • Legal responsibility of 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 an email address for the user and indicate their existing email address to which to send the invitation:
   • You can force this future user to log in with this email address or allow them to specify another email address (useful if they already have a user account with Infomaniak with another login identifier).
   • Add the user to your my kSuite with the toggle switch.
7. Click on the Invite button:
   
   • The invitation is pending until the invited user's final registration (see below). The Organization's user dashboard clearly indicates this status:
     

Accept the invitation

To access the Organization holding kChat:

1. The invited user receives the invitation on their email address and clicks on the Accept the 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 kChat to which they have been invited.
4. Existing users are automatically notified of the arrival of the new participant and can now converse with them; as soon as they are added, the new user receives a message from Euria (Infomaniak AI Bot) welcoming them:
   

Access to kSuite, and not access to kSuite management!

It is important to differentiate the use of the kChat app (within kSuite) and the management of kSuite itself.

In the invitation example above, the new user has been invited to join kChat, so they are now counted as a kSuite user when an administrator accesses kChat user management:

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, as their role (defined in the first point 5 above) does not authorize them to do so:

1. This is why this user will see no active link in the Collaborative Tools → kSuite section of their Infomaniak Manager.
2. They will need to switch to the Infomaniak applications using the menu at the top right:
   

Note that if they wish, this user can order their own kSuite with no link to the kSuite to which they have been invited.

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

Preamble

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

Manage desktop app icon notifications

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

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

Manage chat & 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 smartphone or tablet) or the kChat desktop app (desktop application on macOS / Windows / Linux).
2. Click on the Settings icon ‍ at the top right of the interface.
3. Click on Notifications.
4. Define how to be notified (computer/mobile, present/absent, etc.) and in what case (all messages or only messages with mention, followed message, etc.).
5. Choose to receive regular email notifications:
   • This email is sent either every day or once a week, between 6 and 8 am and indicates to the user the messages they may not have read.
   • The user receives an email per kChat product they have access to.
6. Define a keyword to be alerted when a new message is published:
   

Manage notifications from a specific channel

In the relevant discussion 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. Navigate and activate the various desired notifications.
4. One of the options offered allows you to be automatically notified as soon as a discussion thread (thread) starts following a message posted in the relevant channel.
5. Save your choices by clicking on the button at the bottom:
   

Manage notifications for a specific discussion

To be notified of a new message in a specific discussion thread (thread), even if you are not directly participating, you need to enable Follow:

• either by hovering over the action menu ••• to the right of a user in a discussion:
  1. and by clicking on More…:
     
  2. then Follow the 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 Unfollow the exchanges in this discussion thread): 
     

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

Translate text while reading

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

1. Click here to access the kChat Infomaniak web app (online service ksuite.infomaniak.com/kchat) or open the mobile app (iOS / Android smartphone or tablet application) or the desktop app (macOS / Windows / Linux desktop application).
2. View the message to be translated.
3. Click on the action menu ••• located at the top right of the item in question.
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 writing:

1. Click on the Euria icon.
2. Specify your instructions:
   
3. The text will then be displayed in the desired language and you can send it like this:
   

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

Preamble

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

Obtain a schedule automatically and daily

Prerequisites

• Sending a summary on kChat requires having kChat within your Organization.

To start the day by consulting a message in your Infomaniak inbox containing the schedule based on your Infomaniak agenda:

1. Click here to log in to the unified settings of your Infomaniak Web apps and more specifically to the settings of the daily reminder of the Calendar app.
2. Check or select the relevant Organization in the dropdown menu of the left sidebar.
   1. If you modify 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 relevant calendar.
2. Choose the reception mode (Mail, kChat or both).
3. Choose the time you want to receive the reminder (the evening before or early the same day).
4. Choose whether or not to include recurring events.
5. Choose the days on 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 by email or via Euria on kChat:

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

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

⚠ Available with:

* without customizing the time

Remind a kChat message at a fixed time

To review a message with a future notification:

1. Hover over the message to be reminded and select the additional actions icon ••• in the top right corner.
2. Click on Remind.
3. Choose the desired time to be notified:
   
4. A notification in the channel (visible only to you) indicates the next reminder of the message:
   
5. You will then receive a notification at the chosen time in the Euria channel in the left sidebar, leading to the reminder containing a quote from the message, as well as the necessary information to view the message, set a reminder later, cancel any other reminders, etc.
    

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

Start a conversation

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

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

Compose and send your message by pressing the send button:

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

Scheduled sending: schedule a message

✘ UNAVAILABLE with
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

Free kSuite does not allow customization of the time when scheduling.

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

On the kChat mobile app (iOS/Android smartphone or tablet app), press for a few seconds on the send button, and a menu to schedule the message will appear.

Mention another user

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

Request a read receipt

For users to acknowledge receipt of your message and thus indicate that they have read the message, activate a read receipt before sending the message on the channel, by clicking on the icon (!) and then activating the toggle switch:

Once the message is sent, the result will be as follows:

Edit/delete a message, or pin it

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

An indication regarding the deletion will appear to all other users of the channel at 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.
• Pinned messages 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 of the channel.
• To remove a pinned message, hover over it again and select « Unpin ».

Organize conversations in kChat

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

Imagine opening kChat after several days of absence, unread conversations will be displayed one after the other. After reading them, you may want to find a piece of information read among them, so sorting by recent activity, for example (see below for other possibilities), allows you to find the latest conversations that concerned you.

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

Search for a conversation

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

Discussion thread

1. Regardless of the channel or private chat with another user, you can start a discussion thread from another simply by choosing Reply on the desired message.
2. A discussion thread will open in a right sidebar panel allowing each user of the channel to contribute their comments in this specific thread without disrupting any potential new topics of the ongoing channel (this thread can then be followed or ignored to no longer receive notifications when a new message is received — following is managed at the top of the sidebar).
3. These discussion threads are then centralized to be read and reread in the Discussion Threads section of the left sidebar.

This guide details the management of members of your discussion service kChat.

Prerequisites

• Have sufficient permissions to administer the product in question.
• Invite a user to join kChat.

View members of a channel

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

1. Click here‍ to access the kChat Web app kChat (online service ksuite.infomaniak.com/kchat) or open the kChat desktop app kChat (desktop application on macOS / Windows / Linux).
2. Click on the character 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 member panel of a channel:

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

This guide allows you to manage external applications with kChat using webhooks.

Preamble

• A webhook is a method that allows an application to be immediately informed when a particular event occurs in another application, rather than constantly asking this application if something 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 chat history from another application (Slack, Teams, Jabber, etc.) or from another Organization.

⚠ Max. number of incoming/outgoing webhooks:

Access the kChat webhooks interface

Prerequisites

• Not being an external user (this user will not see the menu Integrations).

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

1. Click here‍‍ to access the Web app kChat (online service ksuite.infomaniak.com/kchat) or open the desktop app kChat (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

Integration examples on kChat:

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

Guides for any other use

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

1. Click on the Incoming Webhooks category.
2. Click on the blue button Add incoming webhooks:
   
3. Add a name and description for the webhook.
4. Select the channel that will receive the messages.
5. Click on 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”:
   

Webhook usage

Quick example

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

Details

On the application that needs to post on kChat:

1. Adjust the code below according to the URL obtained on 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. Optionally, use the same request but in curl (to test from a Terminal type application (command line interface, CLI / Command Line Interface) on your device) as in the image example above: 

   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, text1\nText2."}' https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx

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:

Example code with parameters

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

curl -i -X POST -H 'Content-Type: application/json' \
-d '{
"username": "System Monitor",
  "icon_url": "https://cdn-icons-png.flaticon.com/512/5971/5971593.png",
  "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."
}' \
https://faq-infomaniakaruh.kchat.infomaniak.com/hooks/019c23e9-a9a8-735c-b6ce-0a69df63aaf0

Result of a similar example in image:

Thank you for choosing Infomaniak and kChat as your communication solution between you, your loved ones or your company! These guides will help you organize your channels, users, conversations and more!

Introduction

• Multiplatform, kChat is the instant messaging of kSuite that allows you to exchange, share 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 the discussions, photos, videos, is stored online on Infomaniak's secure servers.
  • The storage size is that of the kSuite.

What do you want to do?

• Set up 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 on the Infomaniak kChat app

A question or feedback?

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

This guide covers messages that start with / on kChat interpreted as slash commands.

Execute a slash command on kChat

To access slash commands on kChat:

1. Click in the composition field within a channel.
2. Enter a / (slash or forward slash) and the attached command.
3. Confirm to send the command.

If you type only the / sign, a modal appears with the commands that can be executed, such as going offline, for example.

Here is a table of the main commands:

Create a custom slash command

Prerequisites

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

To create a custom slash command:

1. Click here‍ to access the Web kChat app (online service kchat.infomaniak.com) 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 the blue button to Add a command: 
   
6. Configure the slash command (name, trigger (without the /), expected content type, action to execute*, etc., including whether the command should appear in the help modal mentioned in the chapter above).
   • * This can 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 set additional parameters for the command, such as dropdown options, checkboxes, 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 get event reminders from the Infomaniak Web app Calendar (online service ksuite.infomaniak.com/calendar) on a chat system like kChat in order to be notified in your chosen chat thread when an event is approaching.

⚠ Available with:

*limited to 1 webhook

Prerequisites

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

Link the kChat webhook to Calendar

To add the webhook from your chat system to the Calendar app:

1. Click here to access the Infomaniak Web app Calendar (online service ksuite.infomaniak.com/calendar).
2. Click on the Settings icon ‍ at the top right.
3. Click on Integrations in the left sidebar menu.
4. Click on the Add a webhook button:
   
5. Define:
   
   1. A name to easily identify the Webhook when you add 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 arrangement in the message to be sent:
      • Insert %subject% to include the subject of the event.
      • Insert %date% to include the date of the event.
      • Insert %description% to include the description of the event.
      • Insert %location% to include the possible location of the event.
6. Click the button to Add the configured element and see it created:
   

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 Infomaniak Calendar Web app (online service ksuite.infomaniak.com/calendar).
2. Click the button Create at the top left.
3. Click on Event:
   
   1. You could also click on an existing event on the calendar to modify it.
4. Enter the event details.
5. Display the additional fields:
   
6. Click on Add a reminder to configure it:
   
7. In the reminder type dropdown menu, choose the webhook configured (according to the name given in 5a above).
8. Save the event at the bottom of the page:
   
9. When the reminder time arrives, a message (in the format configured in 5c above) is sent to kChat about the event, on the channel configured in the kChat webhook (see prerequisites above):
   

And on other chat systems?

Slack

1. Click here to access Slack WebHooks.
2. Choose the chat 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 chat threads.

You can freely use Slack 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%

This guide explains how to configure an action on n8n to send a message to kChat when the conditions are met.

Prerequisites

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

Create the action on 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 type “HTTP Request”:
   
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 manual command:
    
13. The message specified on n8n then appears on kChat:
    

Now that this base works, you might imagine replacing the fixed text with data from elsewhere. For example, add an “Imap” or “RSS Feed” node before the HTTP Request node. Thus, instead of writing the text by hand, click on the small gear next to Value > Expression to say: “Send to kChat the title of the last received email”…

This guide allows you to quickly discover the essential functions of Euria, the artificial intelligence at your disposal within kSuite, particularly powerful for summarizing discussions on the kChat app.

Preamble

• Euria can help you perform all kinds of calculations, translations, provide information on various topics, and answer your questions.
• Refer to this other guide regarding the model used and the responsibilities of each party.
• As soon as a new user is added, they receive a welcome message from Euria.
• Refer to this other guide regarding the possibilities of discussion with the AI in kChat.

Automatically summarize a kChat message

To obtain the summary of a kChat message:

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

This guide explains how to reply to an email visible on 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, in the form of a private message to the email sender.

Preamble

• This feature allows you to reply to an email directly in kChat, with a reminder of the original message to facilitate understanding.
• It aims to streamline collaboration by allowing you to react quickly to an email without leaving the kSuite environment.
• It reduces the back and forth between classic messaging and the collaborative workspace.

Send a reply to an email via kChat

Prerequisites

• The button providing access to the feature will only appear in the case of an email received from a sender linked to the 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, refer to this other guide.

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

1. Click here to access the Mail Infomaniak web app (online service ksuite.infomaniak.com/mail).
2. Open the message to be replied to by kChat.
3. Click on the kChat icon in the email toolbar:
   
   • It is also possible to click on a button below the message:
     
4. Compose your kChat message, format it if necessary, and click on the Send button at the bottom right:
   
5. Your correspondent receives the message on kChat accompanied by a box representing the original email (date & time, subject):
   

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

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

This guide details the use and management of channels in kChat.

Preamble

• A kChat channel is a communication space dedicated to a project, a theme, or a team in which members can exchange documents, write in real-time, and organize video conferences.
• The number of private (and public) channels and guests is limited according to the kSuite offer acquired; refer to the comparison table on the sales page for more information.

⚠ History kept visible (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 motivating good news.

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

Additional Channel

To add a new discussion 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 related to a channel

When you create a new channel, you can choose:

A. its name

It will be modifiable later.

B. its URL

By default, it takes the name of the channel, but you can modify it using lowercase letters, numbers, dots, dashes, and underscores - also modifiable later.

C. its PRIVATE or PUBLIC status

It will be modifiable later (read more below).

D. its description

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

Once the channel is 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 channel

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

PRIVATE channels allow you to restrict sensitive content to 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 (read more below).

⚠ Maximum number of PRIVATE/PUBLIC channels:

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

Prerequisites

• Be a kChat administrator user (being an administrator of the channel is not sufficient).

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

To lock a previously public channel (publicly shared files 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 discussion in the Public channel.
2. Click on the channel settings.
3. Choose Convert:
   

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

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

You can also perform the conversion from the kChat management on the Manager:

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

Leave a channel

Apart from the main channel named General, you can leave a channel at any time:

1. Click on the chevron on the channel title at the top of the discussion.
2. Click on Leave the channel:
   

If you leave a private channel, you will no longer find it in the search but only via its URL if you have it or by being reinvited by a member of the channel.

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

Archive / delete a channel

Apart from the main channel named General, you can archive a channel at any time, which prevents any new messages and will no longer count it in the quota of your available channels. The operation is possible from the Manager or directly on the kChat interface:

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

If you create a channel and then archive it, you can join 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 discussion.
2. Click on Unarchive the channel:
   
3. ... or close it to no longer see it on your interface:
   

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

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

Add to favorites

To add any channel (or user) to favorites:

1. From the kChat Web app (online service ksuite.infomaniak.com/kchat), click on the star icon located 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 to favorites (visible only to your user):
   

Mute a channel

You can hide the notifications of a channel to 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 concerned (in the left sidebar).
2. Choose Mute:
   

Organize by categories

⚠ Maximum number of categories (per user):

You can add one or more categories that allow you to place items (channel, contact, etc.) within them:

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. Then drag the desired channel to the created category (valid for your user only):
   
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

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

Each user of an Organization can freely create personal messages whose content will only be visible to the people concerned:

Infomaniak is a Swiss company certified ISO 27001 and ISO 9001 that complies with the GDPR.

Its main objective is to ensure the security and confidentiality of the data entrusted to it.

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

• The Infomaniak Manager allows you to check if the users of your Organization have activated two-factor authentication.
• Data at rest and in transit is encrypted, as are the backups automatically performed 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 you have approved.
• … can create private channels to restrict sensitive information to specific individuals.
• … control the access rights of users who can access kChat at all times.

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

Change the kChat interface language

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

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

Set up kChat on the Manager

To access kChat preferences on the Infomaniak Manager:

1. Click here to access kChat management on the Infomaniak Manager (need help?).
2. Access the different types of channels.
3. Archive or delete channels from the bottom section.
4. Click on Settings in the left sidebar:
   
5. Add the channels (one or more channels possible) to which new users (excluding external users) will be automatically added in addition to belonging to the channel General.
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 kChat app settings:

1. Click here to access the kChat web app (online service ksuite.infomaniak.com/kchat) or open the kChat mobile app (app for iOS/Android smartphone or tablet) or the kChat desktop app (desktop app on macOS/Windows/Linux).
2. Click on the icon in the top right of the interface:
   
3. You can choose:
   
   1. a display density, and possible color display in compact density
   2. whether or not to display previews in your conversations
   3. the size of a channel (width)
   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 indicates the list of keyboard shortcuts available to work faster with kChat:
   

Resolve a display zoom issue

To zoom in or out of the display that has become unreadable, you need to 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 reapply the default size

Dark Mode / Light Mode

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

Customize a discussion, a channel, etc.

Next to each element of the left sidebar is an action menu ⋮ allowing you to define the sort order (alphabetical, by recent activity, manual):

Set a status

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

1. Click on your avatar or initials at the top right of the interface.
2. Click on Choose a custom status:
   
3. Enter a custom status or choose one from the suggestions.
4. Enter an expiration date if necessary:
   
5. Click on the smiley icon if you want to choose an emoji next to your name.
6. Confirm with the Set status button.

⚠ Max. number of custom emoticons:

Use kChat with your domain and brand