Knowledge base

Please choose Infomaniak and kChat as a 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, kChatis kSuite instant messaging that allows you to exchange, share and coordinate your teams safely since...
  • ... your web browser
  • ... your iOS / Android device
  • ... your mobile tablet or MacOS / Windows / Linux computer
• Download kChat app On your devices!
  • It is not possible to change the location of the folder kchat-desktop on your hard drive.
  • The content of the discussions, photos, videos, is stored online on Infomaniak's secure servers.

What do you want to do?

• Set kChat
• Manage users
• Manage a channel
• Managing a conversation
• Respond to messages
• Manage kChat notifications
• Format messages and insert images
• Send a voice message and its automatic transcription
• Translate message content to the kChat Infomaniak app

A question or feedback?

• In case of problem, please consult the knowledge base before contact support.
• Click here in order to share a review or suggestion on a Infomaniak product.

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

Introduction

• A webhook is a method that allows an application to be immediately notified when a particular event occurs in another application, rather than constantly asking that application if something new has happened (which is called "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 within 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 to be an external user (they will not see the menu Integrations).

To set up 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 for macOS / Windows / Linux).
2. Click on the New icon ‍ next to the name of your kChat organization.
3. Click on Integrations.
4. Access the categories:
   

Example of integration

• Infomaniak calendar event reminder on kChat

Create a simple incoming webhook

To do this:

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

Using the webhook

On the application that needs to post on 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 with curl (to test from a Terminal application (command line interface, CLI) 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 is not defined, the body of the request must be preceded by TRANSLATION_ERROR like this:

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

Settings

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 during the creation of 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 cause this message to be displayed in the channel kchatemp 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 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 the members of your discussion service kChat.

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

Prerequisites

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

See the members of a channel

To see users with access to the selected channel:

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. Click on the character icon below the channel title.
3. The participants are displayed in column on the right of kChat:
   

Invite or remove a member on a private channel

To manage users with access to a private channel:

1. Click on the character icon below the channel title.
2. Current participants are displayed in column on the right of kChat.
3. The blue button Add allows to invite a user kChat or a Task Force Complete, not yet having access to this channel:
   
4. The button Manage allows to remove a member from this channel or to appoint him Administrator of the channel so that in its turn it can manage the members:
   

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 concerns Infomaniak products which integrate the use of artificial intelligence, in particular kChat, kDrive, Mail, Site Creator…

Responsibilities of the parties

Data provided to AI

• The Infomaniak AI is currently based by default on mixtral8x22b.
  • GPT4 turbo is a voluntary option left to the user's choice kChat / Mail; DeepSeek-R1-distilled-qwen-32B is also proposed on the site and API.
  • Audio messages are transcribed with Whisper.
  • Llama 3 is available for API AI Tools.
• Using an editorial assistant, messages and requests addressed to the AI are handled exclusively in Switzerland by the Infomaniak infrastructure.
• No data is processed or shared with a third party.

Data provided by AI

• The language model generates text based on the data it has assimilated when learning, without conscience, 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 seen as an indisputable source of information.
• He must exercise his critical discernment and check the information provided by the assistant from reliable sources where necessary.
  • For example, if a person uses the template for critical tasks such as medical, legal or financial advice, he or she must take additional precautions to confirm the information from the template.
• In case of improper or dangerous use of this assistant, the responsibility lies with the user who takes 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 conversations kChat, organized within the Channels of discussion private and public, and direct discussions between users.

Start a conversation

To write to a user in your organization, click on the + right of the Direct Messages to select it:

Send your message; if necessary attach files up to 100 MB. You can also usereactions”.

Mention another user

To solicit one of the members of the organization (or a whole Task Force) via a message, type the arobase @ to display the persons or channels to be mentioned. Attention, depending on the type of channel concerned, the mention of a user displays a message allowing you to add it to the discussion otherwise it will not see the mention.

Asking for a read accused

So that users can acknowledge receipt of your message and thus report having read the message, activate a read acknowledgment before sending the message on the channel, by clicking on the icon (!) then by activating the toggle switch:

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

 

Edit or Remove Message

To edit a message (which will then include an edited message mention), 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 in all users:

Organize conversations in kChat

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

Imagine opening kChat after several days of absence, unread conversations will appear under each other. After reading these, you may want to find information read among one of them, so a sorting by recent activity e.g. (see below for other possibilities) allows you to find the last conversations that concern you.

This selection of sort type is available for all elements: chat channels, categories, direct messages, etc.

Search for a conversation

The search for elements (word, participant, file) can be found at the top of the window:

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

Thread

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

A thread will open on your right allowing each channel user to bring his comments into this specific wire without disturbing any new topics of the current channel:

These threads are then centralized to be read and read in the discussion thread part of the left sidebar.

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.