Knowledge base

Thank you for choosing Infomaniak and kChat as your discussion solution for you, your network, or your company!

These guides will help you organize your channels, users, discussions, and more!

Getting Started

Cross-platform, kChat is the instant messaging service of kSuite that allows you to exchange, share, and coordinate with your teams securely from your web browser, iOS/Android device, mobile tablet, or macOS/Windows/Linux computer.

Download the kChat app for your devices!

What would you like to do?

• 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

Have a question or feedback?

• Infomaniak support is here to help
• see all kChat FAQs
• click here to share a review or suggestion about an Infomaniak product

This guide allows you to manage external applications with kChat with the help of webhook.

Preamble

• A webhook is a method that allows an application to be informed immediately when a particular event occurs in another application, rather than constantly asking this application if something new has happened (what is called "polling").
  • Outbound Webhook: kChat communicates information to other apps when an event occurs in kChat.
  • Incoming Webhook: kChat receives information from other apps to trigger actions in kChat.
• It is not possible to import the history of the discussions from another application (Slack, Teams, Jabber, etc.) or from another Organization.

Access the webhooks kChat interface

Prerequisites

• Don't be an external user (this one won't see the menu Integrations).

To configure a webhook, to find applications and integrations Self-hospitalized or third parties:

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

Example of integration

• Infomaniak Calendar Event Reminder on kChat

Create a simple incoming webhook

To this end:

1. Click on the category Incoming Webhooks.
2. Click the blue button Add incoming webhooks:
   
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 (not to be publicly disclosed) of type:
   https://votre-serveur-kchat.xyz/hooks/xxx-clé-générée-xxx

Using the webhook

On the application that must post on kChat:

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

   POST /hooks/xxx-clé-générée-xxx HTTP/1.1
   Host: votre-serveur-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   
   {
       "text": "Bonjour, ceci est un texte
   Ceci est un autre texte."
   }

2. Use the same query, but in curl (to test from a Terminal on macOS e.g.):
   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Bonjour, ceci est un texte Ceci est un autre texte."}' https://votre-serveur-kchat.xyz/hooks/xxx-clé-générée-xxx

If no header Content-Type is defined, the body of the request must be preceded by payload= Like this:

payload={"text": "Bonjour, ceci est un texte Ceci est un autre texte."}

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 need to add ?slack_return_format=true to the URL of the webhook.

Parameters

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

Example code with parameters

Here's how to generate a more complete message with parameters, some of which can replace parameters already established when creating the webhook (user name, 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 channel kchatemp of the organization:

This guide explains how to get web app event reminders Calendar Infomaniak (online service) calendar.infomaniak.com) on a discussion system as kChat Or Slack.

Preamble

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

Advertise the webhook in Calendar

To add the webhook of your Calendar chat system:

1. Click here to access the web app Calendar (online service) calendar.infomaniak.com).
2. Click on the icon Parameters ‍ Top right.
3. Click on Integrations in the left side menu.
4. Click on the button Add a webhook:
   
    
5. Define:
   
   1. A name to easily identify the Webhook when adding reminders.
   2. The URL of the webhook (obtained from your chat system - examples are presented below in the FAQ).
   3. The elements (automatically removed from your event and/or manually added here) and their layout in the message that will 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 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 on the bottom right for show additional fields:
   
4. Add a reminder:
   
5. In the drop-down menu, choose the webhook Configured.
6. Validate changes.

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

Examples for getting a webhook

kChat

1. Click here‍ in order to gain access to web app kChat (online service) kchat.infomaniak.com) or open kChat desktop app (desktop application on macOS / Windows / Linux).
2. See you in the game Integrations.
3. Click on Incoming Webhooks :
   
4. Click on the top right on Add.
5. Complete the required information in order to create the "bot" that will post the restart messages in kChat in the channel of your choice:
   
6. Save to get the URL of the webhook:
   
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 hereto access WebHooks Slack.
2. Choose the thread in which your reminders will appear (e.g. @slackbot or #general):
   
3. Save to get the URL of the webhook.

Create other webhooks to set reminders in other threads.

Customize Slack Reminder Recoverys

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

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 in 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 see the users with access to the selected channel:

1. click on the person icon below the channel title
2. participants will appear in a column on the right side of kChat
   

Invite or remove a member from a private channel

To manage users who have access to a private channel:

1. click on the person icon below the channel title
2. current participants will appear 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 they can manage members as well:
   

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

 

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

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

Expressing with an Emoji or GIF

Adding an emoji within the message you are composing is very simple. Just click on the smiling face icon in the formatting toolbar 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 panel that appears when you click on the smiling face icon:

 

If you know the name of the symbol to insert, you can also type: (2 colons) followed by at least the first 2 characters:

Tip: If you add #, ##, or ### as the first character on a new line containing an emoji, you can use a larger emoji. To try it out, send a message like '# :smile:' (Note: your custom settings may "disable" this display feature on your interface).
 

To set the default color, click on this symbol in the emoji panel:
 

Custom Emojis
 

To manage additional emojis, click on this button in 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 MB. The size is automatically resized to 128 x 128 pixels while maintaining the aspect ratio.

The emoji can then be used by all kChat users in your organization based on the name you assigned.

This guide pertains to Infomaniak products that integrate artificial intelligence, including kChat, kDrive, Mail, Site Creator, and more.

Responsibilities of the Parties

Data Provided to AI

• Infomaniak's AI is currently based by default on mixtral8x22b
  • GPT4 turbo is an optional choice for kChat / Mail users
  • Audio messages are transcribed with Whisper
  • Llama 3 is available for the AI Tools API
• When using a writing assistant, messages and requests addressed to the AI are exclusively processed in Switzerland by Infomaniak's infrastructure
• No data is processed or shared with third parties

Data Provided by AI

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

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

Automatically sum up a kChat message

To get a summary of a message kChat:

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

Be aware of this other guide about the conversational agents of kChat.

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

Starting a Conversation

To message a user within your organization, click on the + to the right of Direct Messages to select them:

Send your message; if needed, attach files up to 100 MB. You can also use “reactions”.

Mentoring Another User

To tag one of the members of the organization (or an entire work team) via a message, type the at symbol @ to display people or channels to mention. Be aware that depending on the type of channel, mentioning a user will prompt a message allowing you to add them to the discussion; otherwise, they won’t see the mention.

Request a Read Receipt

To allow users to acknowledge receipt of your message and indicate they have read it, enable a read receipt before sending the message on the channel by clicking on the ⦅!⦆ icon and then toggling the button:

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

 

Edit or Delete a Message

To edit a message (which will then include 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 discussion for all users:

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 away; unread conversations will appear one after another. After reading them, you may want to find information read among them, so sorting by recent activity (see below for other options) helps locate the latest conversations that concerned you. 

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

Search for a Conversation

Searching for items (word, participant, file) is located at the top of the window:

Once results are found, they appear on the right side of the window.

Discussion Thread

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

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

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

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

Getting kChat

kChat is available withkContinued.

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

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

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

Also take note of the start guide.

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

Preamble

• A kChat channel is a communication space dedicated to a project, theme or team in which members can exchange documents, write live and organize video conferences.
• Private channels (and public channels, as well as guests) are limited in number according to the offer kSuite acquired; read the comparative table on the sales page for more information.

General Canal

Each organization on kChat automatically has a channel General in which all users are automatically invited.

You can use this channel to share information about your entire organization, such as business outings or good motivational news.

You can of course start a new Conversation thread inside the channel General.

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 on a channel

When you create a new channel, you can choose:

 

A. his name

It will be editable later.

B. its URL

By default it takes the name of the channel but you can edit it using tiny letters, numbers, dots, dashes and underscores - which can then also be modified.

C. its status Privé or Public

It will then be editable (read below).

D. its description

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

Once the channel is created, you can still define:

E. a header

Differences between channels Privé and Public

Channels publics increase transparency. All users can see and reach a public channel, making sure that everyone involved in a project, theme or team has access to the same information.

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

Convert a public channel to a private channel

To transform a public channel into a private channel:

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

The history and membership of the members are kept; publicly shared files remain accessible to anyone with the link; the change is Permanent and cannot be cancelled.

And the other way around?

The reverse ( changing a private channel into a public channel) is also possible but only one admin user kChat can do so; the message history and members already having access to the channel will be kept; the channel will become accessible to all users of other public channels of the Organization except those external users who will have to be invited manually.

To perform conversion from managing kChat on the Manager:

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click on drop-down menuto display private channels.
3. Click on the action menu 的located to the right of the element concerned.
4. Click on Convert to public channel:
   

Exit a channel

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

1. From the Web app kChat (online service) kchat.infomaniak.com), click on the appropriate Public channel in the left side menu.
2. Then click on the chevron ‍ on the title of the channel at the top of the discussion.
3. Click on Exit 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 invited by a member of the channel.

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

 

Archive/Remove Channel

Apart from the main channel entitled 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 has been feasible since 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 side menu.
2. Then click on the chevron ‍ on the title of the channel at the top of the discussion.
3. Click on Archive channel:
   

If you create a channel and then you archive it you can join it when you want it simply by finding it with its 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 channel in the left side menu.
2. Then click on the chevron ‍ on the title of the channel at the top of the discussion.
3. Click on Unarchiving the channel:
   

or close it to not see it again on your interface:

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

1. Click here in order to access the management of your product on the Manager Infomaniak (Need help?).
2. Click on the action menu ⋮located to the right of the element concerned.
3. Click on Remove
   
    

Put as a favourite

To put any channel as a favorite:

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

Putting a channel in a deafened state

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 channel concerned (in the left sidebar).
2. Choose Deaf:
   
   
   
    

Organize by categories

Clicking on the button + located in the left sidebar of kChat, you can add one or more categories allowing you to place elements (channel, contact, etc.) within them. Then slide 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 in outside channels.

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