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

Preamble

• Multiplatform, kChat is the instant messaging of my 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 modify the location of the kchat-desktop folder on your hard drive.
  • The content of conversations, photos, videos, is stored online on Infomaniak's secure servers.

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 on the kChat Infomaniak 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 on an 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 ("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:

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

Translate the text as you read it

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

1. Click here to access the kChat web app by Infomaniak (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 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 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 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 (online service ksuite.infomaniak.com/kchat) or open the kChat desktop app (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 that does 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 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 to any message at any time that 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 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 at your disposal (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 such as '# :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 of your Organization thanks to the unique name you have assigned to it:

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 subjects, and answer your questions.
• Be aware of 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.
• Be aware of this other guide regarding the possibilities of discussing with the AI in kChat.

Automatically summarize a kChat message

To get the summary of a kChat message:

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

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 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 list of members 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”.

Scheduled sending: schedule a message

⚠ Available with:

* without custom 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 (application for iOS/Android smartphone or tablet), press 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's 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 be able 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 (!) 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 a mention of edited message), 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 initial 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 channel's 'Pinned Messages' option.
• To remove a pinned message, hover over it again and select 'Unpin'.

Organize conversations in kChat

The type of sorting 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 below the other. After reading them, you may want to find a piece of information read among them, so a sort by recent activity for example (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

Searching 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

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.

A discussion thread will open on your right allowing each user of the channel to contribute their comments in this specific thread without disrupting any potential new topics in the current channel.

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

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 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 times to contact you, including 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 night 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 by Euria on kChat:

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

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

Preamble

• A kChat channel is a communication space dedicated to a project, a topic, 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, hyphens, 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 …

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

Difference between PRIVATE or PUBLIC channel

PUBLIC channels increase transparency. All users can see and join a public channel, which ensures that all people 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

To transform a Public channel into a Private channel:

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

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

And the reverse?

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 preserved; the channel will become accessible to all users of the other public channels of the Organization except external users who will have to be manually invited:

1. Click on the chevron ‍ on the channel title at the top of the discussion on the Private channel.
2. Click on the settings of the channel.
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 join it whenever you want simply by finding it with its name (2) in the search (1), even 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 message 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 simply by finding it with its name (2) in the search (1):

You will then be able to 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 in question.
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 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 allowing 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. 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 discussion 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 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 counting 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 must 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 basic 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 and clicks on the Accept the invitation button:
   
2. They specify their contact details as well as the email/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 new participant's arrival 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, not access to kSuite management!

It is important to distinguish 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 links 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 without any connection to the kSuite to which they have been invited.

Infomaniak tools, such as the Infomaniak Mail web app (online service ksuite.infomaniak.com/mail) or the Calendar, Contacts, kSuite interfaces... can be displayed in light mode or dark mode ("dark mode"), including based on the settings of your current operating system.

Enable manual mode

To manually choose a dark or light display, without relying on a possible different display on the operating system side:

1. Click here or on the badge with your initials / avatar in the top right of the Infomaniak Manager) to "Manage my account":
   
   
    
2. Then click on Appearance in the left sidebar.
3. Click on Light to apply the light mode:
   
4. Click on Dark to enable the "dark mode".

Enable automatic mode

The automatic mode is based on the parameters of your operating system (macOS / Windows...):

1. Click here or on the badge with your initials / avatar in the top right of the Infomaniak Manager) to "Manage my account":
2. Click on Appearance in the left sidebar.
3. Click on the Automatic mode:
   

Then if you want to modify the light or dark theme of your computer, so that the Manager's automatic mode takes into account your preferences...

... 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 preferences, thus providing a consistent visual experience between mobile applications and login / account creation.

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 start an audio or video conversation between one or more users kChat, with Infomaniak's ethical free video conferencing 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 within 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 trigger a call to all members of a channel if you start the meeting from the channel.
• Calling a user who is on “Do Not Disturb” will not trigger a ringtone or call modal for them, 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 will appear 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 related to the start and end of the meeting will 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 message (warning) 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 on kMeet.

This guide allows you to quickly discover the essential functions of Euria, the artificial intelligence at your disposal within kSuite, particularly powerful as a conversational agent on the app kChat.

Preamble

• Euria can help you perform all kinds of calculations, translations, provide information on various subjects, 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 AI summaries on kChat.

Add Euria to kChat contacts

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

If you don't see them yet, click in the left sidebar of kChat…

1. … on the channel search (bots also appear as channels)
2. … or on the + icon next to Direct Messages to search for the bot
   ​
3. Add the bots labeled as such with the tag [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 need to create a private discussion channel between each bot individually and yourself.

Then simply write to them as if you were conversing with an acquaintance:

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