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

Preamble

• Multiplatform, kChat is the instant messaging service of kSuite that allows you to exchange, share and coordinate your teams securely from…
  • … your web browser
  • … your iOS / Android device
  • … your mobile tablet or 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, videos, is stored online on Infomaniak's secure servers.

What would you like 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 kChat app Infomaniak

A question or feedback?

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

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 (known as "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.

Access the kChat webhooks interface

Prerequisites

• Not being an external user (they 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 kchat.infomaniak.com) or open the desktop app kChat (desktop application on macOS / Windows / Linux).
2. Click on the New icon ‍ next to your kChat organization name.
3. Click on Integrations.
4. Access the categories:
   

Integration example

• Calendar event reminder on Infomaniak kChat

Create a simple incoming webhook

To do this:

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

Using the webhook

On the application that needs to post to kChat:

1. Adjust the code below according to the URL obtained:

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

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

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

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

payload={"text": "Hello, text1
Text2."}

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

Settings

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

Code example 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:

POST /hooks/xxx-clé-générée-xxx HTTP/1.1
Host: votre-serveur-kchat.xyz
Content-Type: application/json
Content-Length: 630
{
  "channel": "kchatemp",
  "username": "test-automation",
  "icon_url": "https://domain.xyz/wp-content/uploads/2023/06/icon.png",
  "text": "#### Résultats des tests pour le 27 juillet 2023
@channel veuillez vérifier les tests échoués.

| Composant  | Tests effectués   | Tests échoués                                   |
|:-----------|:-----------:|:-----------------------------------------------|
| Serveur     | 948         |  0                           |
| Client Web | 123         |  2 [(voir détails)](https://linktologs) |
| Client iOS | 78          |  3 [(voir détails)](https://linktologs) |"
}

This will result in the display of this message in the kchatemp channel of the organization:

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

Translate the text while reading

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

1. Click here to access the Web app kChat Infomaniak (online service kchat.infomaniak.com) or open the mobile app (application for iOS/Android smartphone or tablet) or the desktop app (desktop application for macOS/Windows/Linux).
2. View the message to be translated.
3. Click on the action menu ••• located at the top right of the relevant item:
   
4. Click on Translate:
   
5. The translated message appears below your conversation and is only visible to you.

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

Preamble

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

Announce the webhook to Calendar

To add the webhook of your chat system to Calendar:

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

Create an event with a chat reminder

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

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

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

Examples for obtaining a webhook

kChat

1. Click here‍ to access the kChat Web app (online service kchat.infomaniak.com) or open the kChat desktop app (desktop application for macOS / Windows / Linux).
2. Go to the Integrations section.
3. Click on Incoming Webhooks:
   
4. Click at the top right on Add.
5. Fill in the required information to create the "bot" that will post reminder messages in kChat in your chosen channel:
   
6. Save to get the webhook URL:
   
7. Create the custom notification in Calendar (read above if necessary):
   
8. Select your custom notification when adding a reminder to your event:
   

Slack
 

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

Create other webhooks to set reminders in other channels.

Customize the reminders of a Slack reminder

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

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

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

Refer to this other guide if you wish to manage the channels to which new members will automatically belong.

Prerequisites

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

See the members of a channel

To view the users with access to the selected channel:

1. Click here‍ to access the kChat web app (online service kchat.infomaniak.com) or open the kChat desktop app (desktop application for macOS / Windows / Linux).
2. Click on the person icon below the channel title.
3. The participants are displayed in a column on the right side of kChat:
   

Add or remove a member from a private channel

To manage users with access to a private channel:

1. Click on the person icon below the channel title.
2. The current participants are displayed in a column on the right side of kChat.
3. The blue Add button allows you to invite a kChat user or a complete work team that does not yet have access to this channel:
   
4. The Manage button allows you to remove a member from this channel or appoint them as Administrator of the channel so that they can in turn manage the members:
   

This guide details the use of smileys and other emojis to react and interact with discussions in 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 small +:

 

If there are already reactions, you can add one in the same place:

You will thus open the panel with hundreds of emoticons at your disposal (and even custom emojis - read more 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 emoji using the tab located at the top of the pop-up 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 emoji, you can use a larger emoji. To try it, send a message like '# :smile:' (note that your custom settings may "disable" this display feature on your interface).
 

To set the default shade, click on this symbol from the emoji panel:
 

Custom emoticons

To manage additional emoticons, click on this button on 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 emoji. The file can weigh up to 1 Mo. The size is automatically resized to 128 by 128 pixels, while maintaining the aspect ratio.

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

This guide concerns Infomaniak products that integrate the use of artificial intelligence (AI), including kSuite, kChat, kDrive, Mail, Site Creator…

Preamble

• The use of AI at Infomaniak is based on a transparent and ethical approach.
• Each service integrating AI follows strict principles to ensure reliable and respectful use:
  • The protection of information is ensured by the complete processing of data within infrastructures located exclusively in Switzerland, thus guaranteeing full control over digital sovereignty,
  • the results generated are never used to train models or for advertising purposes,
  • and AI is not intended to replace humans, but to assist them.

kChat

The AI integrated into kChat saves time in exchanges: it can rephrase sentences, generate quick responses, correct spelling, or adjust the tone of a message. The user retains full control over the suggestions, which are local to each session only.

Mail Infomaniak

In the Mail application, AI assists in drafting emails. It can generate content from a few keywords, rephrase or structure a message, adapting to different tones. Nothing is sent automatically, and the user can modify the texts at any time.

Site Creator

An AI-powered writing assistant enables Site Creator to quickly generate content tailored to various types of web pages. This service is useful for those launching a site and looking to produce clear, optimized, and relevant texts.

kDrive

On kDrive, artificial intelligence is deployed at two complementary levels to simplify document management.

On the one hand, an AI assistant accessible via Euria allows you to interact with text files stored in the drive. This module can answer questions about the content of a document, summarize, translate, or extract useful information. It is particularly effective for reading reports, understanding complex texts, or quickly generating an overview of a file.

Moreover, AI facilitates the automatic classification of files imported into kDrive thanks to an intelligent categorization system. By analyzing the content, kDrive can assign files to categories such as “administrative”, “photo”, “personal”, etc. This allows for quick sorting and better search, especially for files synchronized from different devices (computer, mobile).

On-demand AI with AI Tools

Infomaniak provides a platform that allows for easy integration of open-source models into custom projects. It is possible to leverage text analysis, content generation, translation, or other AI uses via on-demand calls. These services enable developers to benefit from high-performance AI without relying on closed or proprietary solutions.

Responsibilities of the parties

Data provided to the AI

• Infomaniak's AI is currently based by default on these models.
  • Among them, Mistral, Whisper, DeepSeek, Llama, granite…
• When using a writing assistant, the messages and requests sent to the AI are exclusively processed in Switzerland by Infomaniak's infrastructure.
• No data is processed or shared with a third party.

Data provided by the AI

• The language model generates text based on the data it has assimilated during its training, devoid of consciousness, intentions, or moral responsibilities.
• It is crucial that the user is aware that the information generated by the model is not always accurate and should not be considered an infallible source of information.
• He must exercise his critical judgment and verify the information provided by the assistant with reliable sources when necessary.
  • For example, if someone uses the model for crucial tasks such as medical, legal, or financial advice, they must take extra precautions to confirm the information provided by the model.
• In case of inappropriate or dangerous use of this assistant, the responsibility lies with the user who takes these actions.

This guide explains how to automatically obtain a summary of the content of a message kChat.

Automatically summarize a kChat message

To get the summary of a kChat message:

1. Hover over the message and select the AI actions icon at the top right.
2. Click on Summarize the conversation thread:
   ‍
3. Get the summary, generated by AI and sent by kChat Bot in the right sidebar:
   

Check out this other guide about kChat's conversational agents.

This guide details the principle of conversations in kChat, organized within Discussion Channels that are private and public, 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 thus create a group conversation:

Write and send your message by pressing the send button:

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

Schedule a send

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

Mention another user

To mention one of the Organization's members (or an entire work team) in a message, type the at symbol @ to display the people or channels to mention:

Request a read receipt

To have users 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 (!) then activating the toggle switch:

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

Edit or delete a message

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

Organize conversations in kChat

The sorting type for the elements 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 below the other. After reading them, you might want to find some information you have read among them. For example, sorting by recent activity (see below for other possibilities) allows you to find the latest conversations that concerned you.

This sorting option 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

No matter the channel or private chat with another user, you can start a discussion thread from another simply by choosing Reply on the desired message.

A discussion thread will open on your right, allowing each user of the channel to contribute to this specific thread without disrupting any new topics in the ongoing channel:

These discussion threads are then centralized to be read and reread in the Discussion Threads section of the left sidebar.

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

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 user 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, including by setting up an automatic forwarding rule based on the criteria matching the received email.

Get a schedule automatically and daily

Prerequisites

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

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

1. Click here to access the unified settings of your Infomaniak Web apps and, more specifically, the settings for the daily reminder of the Calendar app.
2. Check or select the relevant Organization from the dropdown menu on 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 on 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 kChat Bot or by mail:

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

This guide concerns kChat, the instant messaging service from Infomaniak that allows you to exchange, share and coordinate your teams securely from your web browser, mobile, tablet or computer.

Get kChat

kChat is available with kSuite.

Once you have set up kSuite within your Organization, download…

• … the mobile app kChat (app for iOS/Android smartphone or tablet)
• … the desktop app kChat (desktop application for macOS / Windows / Linux).

and/or click here to access the kChat web app (online service kchat.infomaniak.com).

Also, familiarize yourself with the getting started guide.

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

Introduction

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

General Channel

Every Organization on kChat automatically has a General channel to 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 thread within the General channel.

Additional Channel

To add a new discussion channel:

1. Click on the button ‍ located in the left sidebar of the Web app kChat (online service kchat.infomaniak.com).
2. Click on Create a new channel:
   

Information about a channel

When you create a new channel, you can choose:

A. its name

It will be modifiable later on.

B. its URL

By default, it takes the name of the channel, 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 will be modifiable later (read below).

D. its description

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

Once the channel is created, you can also set:

E. a header

Differences between PRIVATE or PUBLIC channels

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

Convert a public channel to a private channel

To convert a Public channel to a Private channel:

1. From the Web app kChat (online service kchat.infomaniak.com), click on the Public channel in the left sidebar.
2. Then click on the chevron ‍ on the channel title at the top of the discussion.
3. Choose Convert:
   

The history and membership of the members are preserved; publicly shared files remain accessible to anyone with the link; the change is permanent and cannot be undone.

What about the opposite?

The reverse (changing a private channel to a public channel) is also possible, but only a kChat administrator user can do it; the message history and members who already have access to the channel will be retained; the channel will become accessible to all users of the other public channels of the Organization except external users who will need to be invited manually.

To perform the conversion from kChat management on the Manager:

1. Click here to access the management of your product 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 relevant item.
4. Click on Convert to public channel:
   

Leave a channel

Except for the main channel named General, you can leave a channel at any time:

1. From the Web app kChat (online service kchat.infomaniak.com), click on the relevant Public channel in the left sidebar.
2. Then click on the chevron ‍ on the channel title at the top of the discussion.
3. Click on Leave channel:
   

If you leave a private channel, you will no longer find it in the search results, 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 by name (2) in the search (1), even if it has been archived:

Archive / delete a channel

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

1. From the Web app kChat (online service kchat.infomaniak.com), click on the channel in the left sidebar.
2. Then click on the chevron ‍ on the channel title at the top of the discussion.
3. 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 name (2) in the search (1):

You can then unarchive it:

1. From the Web app kChat (online service kchat.infomaniak.com), click on the relevant channel in the left sidebar.
2. Then click on the chevron ‍ on the channel title at the top of the discussion.
3. Click on Unarchive the channel:
   

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 product on the Infomaniak Manager (need help?).
2. Click on the action menu ⋮ located to the right of the relevant item.
3. Click on Delete:
   
    

Add to favorites

To favorite any channel:

1. From the Web app kChat (online service kchat.infomaniak.com), click on the star icon located at the top of a channel.
2. A new Favorites menu will appear in the left sidebar, grouping all the items you have favorited (valid for your user only):
   

Mute a channel

You can hide the notifications of a channel:

1. From the Web app kChat (online service kchat.infomaniak.com), click on the action menu ⋮ to the right of the relevant channel (in the left sidebar).
2. Select Mute:
   
   
   
    

Organize by categories

By clicking the + button located in the left sidebar of kChat, you can add one or more categories allowing you to place items (channel, contact, etc.) within them. Then drag the desired channel to the created category (valid for your user only):

User-to-user discussion channel

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 be visible only to the people concerned:

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

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

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

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

This guide explains how to invite an external user to your Organization on kChat who will be counted as a kSuite user.

Preliminary

• 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 kSuite user and without having any special rights in the Organization (of which they will not be a part).
• You can also invite a work team in full from kChat.
• Refer to this other guide if you wish to manage the channels to which new members will automatically belong.

Invite to use kSuite

Prerequisites

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

Once invited, the user will be able to confirm their membership and access kChat with the limited permissions that you will 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 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 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 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 (especially useful if they already have a user account with Infomaniak under a different login ID).
   • Add the user to your kSuite with the toggle switch.
7. Click on the Invite button:
   

The invitation is pending until the invited user completes their registration (read more 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 at their email address and clicks on the Accept the invitation button:
   
2. He specifies his contact details as well as the email address/password he wishes to use and completes 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 new participant's arrival and can now converse with them; as soon as they are added, the new user receives a welcome message from kChat.bot:
   

Access to kSuite, not access to managing kSuite!

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. They are counted as a kSuite user when an administrator accesses the management of their kSuite users:

However, this new user will not be able to directly manage the kSuite to which he was invited since his role (defined in the first point 5 above) does not authorize him to do so.

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

Note that if necessary, this user can order their own kSuite with no connection to the kSuite to which they were invited.

This guide explains how to enable or disable dark mode on your operating system (macOS / Windows) since the theme setting "automatic" of Infomaniak tools (animation below) is based on the Dark mode or Light mode setting of the OS:

Managing dark or light mode…

… on macOS

1. Click on System Preferences…
   
2. Click on Appearance and choose the dark mode on the right:
   

… on Windows

1. Open the start menu
2. Click on Settings:
   
3. Click on Personalize then Colors:
   
4. Click on Dark:
   

And on mobile?

The dark theme is enabled on mobile devices for Infomaniak login and account creation pages; it automatically adapts to the mobile system's preferences, thus providing a consistent visual experience between mobile apps and login and account creation pages.

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 latter must be accessible and visible on the Web):

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

Example

Message with image insertion syntax:

But if the URL of the image is in the 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 that you can send directly in the conversation without necessarily adding any additional text.

This guide explains how to start an audio or video conversation between one or more users kChat, with Infomaniak's free ethical videoconferencing solution, kMeet.

Preamble

• The call function in kChat is available on all Web (browser), mobile (iOS / Android) and computer (macOS / Windows) versions.

Create a meeting between kChat users

To be able to discuss in a virtual room with the microphone and webcam of your device, simply press the Call button visible on any kChat conversation, private or public channel, via the application or directly on the browser:

• Call a user directly if you are in a direct discussion with them, or initiate a call to all members of a channel if you start the meeting from the channel.
• Calling a user who is set to "Do Not Disturb" will not trigger a ring or call modal on their end, but they will see the message in the conversation.
• The microphone is enabled by default when the call is accepted, but not the camera.
• View the users of the meeting (who accepted, declined, or missed it) using the avatars in the kChat message.
• Once the call has started, an emoji appears in your kChat status to indicate that you are busy with the conversation.
• A message sent from the video (kMeet) will also be visible in the kChat conversation (and vice versa).
• Indications regarding the start and end of the meeting automatically appear in the relevant kChat conversation thread.

Specifics for calls in channels

• The call will not ring for the recipients, but they will see a message in kChat as well as a notification.
• A warning message will appear if you want to start a call in a channel with more than 7 users.

Refer to this other guide if you are looking for information about kMeet.

This guide explains how to interact in kChat with a conversational agent or bot powered by artificial intelligence. Familiarize yourself with this other guide about the possibilities offered by AI in kChat.

Introduction

• The bot can help you perform all sorts of calculations, translations, provide information on various topics and answer your questions.
• Familiarize yourself with 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 kChat.bot.

Add the bot to kChat contacts

The bots currently available on kChat are already part of your contacts.

If you do not see them yet, click in the left sidebar of kChat…

1. … on the channel search (the bots also appear as a channel)
2. … or on the + icon next to Direct Messages to search for the bot
   ‍
3. Add the bots indicated as such with the label [bot] or search for the term bot or chat.
   ‍

Do not create a group conversation between the bots and yourself as it will not work. You must create a private discussion channel between each bot individually and yourself.

It is then sufficient to write to it as if you were chatting with an acquaintance:

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

Manage desktop app icon notifications

You can, for example, decide to animate the desktop app icon when there is a new message:

1. Open the desktop app kChat (desktop application for macOS / Windows / Linux).
2. Left-click on the desktop app icon in your computer's notification area (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 kChat notifications

To manage kChat notifications, and thus be notified, for example, when a new message is directly addressed 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 kchat.infomaniak.com) or open the kChat mobile app (application for iOS/Android smartphone or tablet) or the kChat desktop app (desktop application for macOS / Windows / Linux).
2. Click on the Settings icon ‍ in the top right corner of the interface.
3. Click on Notifications:
   
4. Set how you want to be notified (computer/mobile, present/absent, etc.) and in which cases (all messages or only messages with a mention, followed messages, etc.).
5. Choose to receive regular email notifications:
   • This email is sent either every day or once a week, between 6 and 8 in the morning and indicates to the user the messages they would not have read.
   • The user receives an email for each kChat product they have access to.
6. Set a keyword to be notified about when a new message is published:
   

To be notified of the progress of a discussion

To be notified of a new message in any discussion even if you are not directly participating, you need to activate Follow:

• … or by hovering over the action menu to the right of a user in a discussion:
  
• … or by clicking on Follow at the top of the discussion:
  

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

Run 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. Click 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 to be an external user (he 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 the name of your kChat organization.
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 perform*, 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 a script or an external 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.