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

Get kChat

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

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).

Install kChat

macOS

• kChat requests 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 outside.

Linux

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

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.