Knowledge base
1000 FAQs, 500 tutorials and explanatory videos. Here, there are only solutions!
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.
- It is not possible to change the location of the
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.
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:
- 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).
- Click on the New icon ‍ next to the name of your kChat organization.
- Click on Integrations.
- Access the categories:
Example of integration
Create a simple incoming webhook
To do this:
- Click on the Incoming Webhooks category.
- Click on the blue button Add incoming webhooks:
- Add a name and a description (max 500 characters) for the webhook.
- Select the channel that will receive the messages
- 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:
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." }
- Optionally, use the same request but with
curl
(to test from aTerminal
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:
Parameter | Description | Required |
---|---|---|
text | Message in Markdown format to display in the post. To trigger notifications, use “@<username>”, “@channel” and “@here” as you would in other kChat messages. | If attachments is not defined, yes |
channel | Replaces the channel in which the message is posted. Use the channel name, not the display name, for example “town-square”, not “Place de la ville”. Use "@" followed by a username to send a direct message. By default, uses the channel set during webhook creation. The webhook can post in any public or private channel where the webhook creator is present. Posts in direct messages will appear in the direct message between the targeted user and the webhook creator. | No |
username | Replaces the username under which the message is posted. By default, uses the username set during webhook creation; if no username was set during creation, use webhook .The configuration parameter Allow integrations to replace usernames must be enabled for the username replacement to take effect. | No |
icon_url | Replaces the profile picture with which the message is posted. By default, uses the URL defined during webhook creation; if no icon was defined during creation, the standard webhook icon (‍) is displayed. The configuration parameter Allow integrations to replace profile picture icons must be enabled for the icon replacement to take effect. | No |
icon_emoji | Replaces the profile picture and the parameter icon_url .By default, nothing is set upon webhook creation. The expected value is the name of an emoji as it is typed in a message, with or without colons ( : ).The configuration parameter Allow integrations to replace profile picture icons must be enabled for the replacement to take effect. | No |
attachments | Message attachments used for richer formatting options. | If text is not defined, yes |
type | Sets the type for publishing, mainly for use by plugins.If it is not empty, it must start with custom_ ". | No |
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:
- 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).
- View the message to be translated.
- Click on the action menu ••• located at the top right of the relevant item:
- Click on Translate:
- 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:
- Click here to access the Web app Calendar (online service calendar.infomaniak.com).
- Click on the Settings icon ‍ at the top right.
- Click on Integrations in the left sidebar.
- Click the Add a webhook button:
- Set up:
- A name to easily identify the webhook when you add reminders.
- The webhook URL (obtained from your chat system - examples are presented further down in the FAQ).
- 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.
- 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:
- Click here to access the Web app Calendar (online service calendar.infomaniak.com).
- Create a new event.
- Click at the bottom right to display additional fields:
- Add a reminder:
- In the dropdown menu, select the configured webhook.
- Confirm the changes.
You will now receive a reminder in the chat corresponding to the webhook.
Examples for obtaining a webhook
kChat
- 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).
- Go to the Integrations section.
- Click on Incoming Webhooks:
- Click at the top right on Add.
- Fill in the required information to create the "bot" that will post reminder messages in kChat in your chosen channel:
- Save to get the webhook URL:
- Create the custom notification in Calendar (read above if necessary):
- Select your custom notification when adding a reminder to your event:
Slack
- Click here to access Slack WebHooks.
- Choose the conversation thread where your reminders will appear (e.g. @slackbot or #general):
- 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:
- 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).
- Click on the person icon below the channel title.
- 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:
- Click on the person icon below the channel title.
- The current participants are displayed in a column on the right side of kChat.
- 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:
- 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 the products that integrate the use of artificial intelligence, notably kChat, kDrive, Mail, Site Creator…
Responsibilities of the parties
Data provided to the AI
- Infomaniak's AI is currently based by default on
mixtral8x22b
.GPT4 turbo
is an optional choice left to the user of kChat / Mail;DeepSeek-R1-distilled-qwen-32B
is also offered on the site and the API.- Audio messages are transcribed with
Whisper
. Llama 3
is available for the API AI Tools.
- When using a writing assistant, 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 be 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 additional 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:
- Hover over the message and select the AI actions icon at the top right.
- Click on Summarize the conversation thread:
‍
- 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 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.