This guide covers the installation of kChat, the instant messaging solution of my kSuite. Also refer to the getting started guide.

Get kChat

kChat is offered with my kSuite, with capabilities adapted to each version of my kSuite.

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

Install kChat

macOS

• kChat requests access to the macOS Keychain for “Chromium Safe Storage”, which is used to store your access token.
• This request is normal and necessary for kChat to function properly; no additional sensitive data is requested and nothing is sent outside.

Linux

• On Linux, kChat is distributed in AppImage format, so depending on your system configuration, it may be necessary to disable sandboxing for the application to work correctly:
  • If kChat does not start, run it from a terminal with the following command: ./kchat.AppImage --no-sandbox
  • You can also create a launcher or a script including this parameter to avoid having to enter it each time you use it.

Este guia detalha o uso de emojis e outros emoticons para reagir e interagir nas discussões do serviço kChat.

Adicionar uma reação a uma mensagem

Para reagir a qualquer mensagem à qual você tenha acesso no kChat, basta passar o mouse sobre a mensagem e selecionar…

• o emoticon na seleção;
• ou o emoji com o pequeno +:
  
• Se já houver reações (exibidas abaixo das mensagens), você pode adicionar uma no mesmo local:
  
   

Isso abrirá o painel com centenas de emojis disponíveis (e até mesmo emojis personalizados – leia mais abaixo).

Expresse-se com um emoji ou GIF

Adicionar um emoji dentro da mensagem que você está escrevendo é muito simples:

• Basta clicar no ícone de rosto sorridente na barra de formatação da sua mensagem:
  
• Você pode então escolher um emoji ou inserir GIFs animados curtos em vez de um emoji, usando a aba localizada na parte superior do painel que aparece quando você clica no rosto sorridente:
  
   
• Se você souber o nome do símbolo a ser inserido, também pode digitar : (dois pontos) seguido das 2 primeiras letras, no mínimo:
  

Dica: se você adicionar #, ## ou ### como o primeiro caractere de uma nova linha contendo um emoji, poderá usar um emoji maior. Para testar, envie uma mensagem como '# :smile:' (atenção, suas configurações personalizadas podem "desativar" essa funcionalidade de exibição na sua interface).

Para definir o tom padrão dos emojis de pessoas, clique neste símbolo no painel de emojis:

Emojis personalizados

Para gerenciar emojis adicionais, clique neste botão no painel de emojis:

Especifique um nome com até 64 caracteres. Ele pode conter letras minúsculas, números e os caracteres “-”, “+” e “_”.

Especifique um arquivo .gif, .png ou .jpg para o seu emoji. O arquivo pode ter até 1 MB. O tamanho é redimensionado automaticamente para 128 x 128 pixels, mantendo a proporção.

O emoji poderá então ser usado por todos os usuários do kChat da sua organização, usando o nome exclusivo que você atribuiu a ele:

This guide explains how to insert rich text and images into your messages on kChat.

Formatting message text (markdown)

Here are the symbols to add before and after your text to format it in the desired style:

line of code

You can also insert the following:

Inserting an image into the message…

… from a URL

Insert the following code into your message, replacing the alt text and the image address (URL) with the image link (the latter must be accessible and visible on the Web):

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

Example

Message with the image insertion syntax:

And if the URL to the image is in your clipboard, simply paste the link into a conversation and the image will be added to your message.

… from your hard drive or kDrive

Click on the paperclip icon to insert an existing image from your hard drive or from kDrive:

The image will be inserted into the message, which you can then send directly in the conversation without necessarily adding additional text.

This guide explains how to invite a user to kChat who is not yet part of your Organization but will be counted as a kSuite user.

Introduction

• Refer to this other guide to grant access to one or more kChat channels to an external user, who can then interact with your team without being counted as a kSuite user and without having any specific rights within the Organization (of which they will not be a part).
• You can also invite an entire Group from kChat.
• Refer to this other guide if you want to manage the channels to which new members will automatically belong.

Invite to use kSuite

Prerequisites

• Be a kChat administrator:
  
  • The role within the Organization is irrelevant; being an Organization administrator in the Organization that has the kSuite (and therefore kChat) is not required, and is not sufficient in any case:
    
     

Then, invite the user using the procedure below. 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 kChat management section in the Infomaniak Manager (need help?).
2. Click on Add a user:
   
3. Click on Create a kSuite user.
4. Click on Next:
   
5. Enter the user's first name and last name, and define their role as a standard user:
   • Legal representative
     • Legal responsibility for the organization
     • Can manage all products and users
     • Can manage accounting and new product orders
   • Administrator
     • Can manage all products and users
     • Can manage accounting and new product orders
   • User
     • Can manage the products you authorize
     • Can manage accounting if you authorize it
6. Do not create a mail address for the user and instead indicate their existing mail address to which the invitation should be sent:
   • You can require this future user to log in with this mail address or allow them to specify a different mail address (this is particularly useful if they already have a user account with Infomaniak with a different login ID).
   • Add the user to your kSuite using the toggle switch.
7. Click the Invite button:
   
   • The invitation is pending until the invited user completes the registration (see below). The organization's user dashboard clearly indicates this status:
     

Accept the invitation

To access the organization that owns kChat:

1. The invited user receives the invitation at their mail address and clicks the Accept invitation button:
   
2. They specify their contact details as well as the mail address/password they wish to use and complete the registration:
   
3. Once the registration is complete, the newly registered user can log in to their Manager and access the kChat to which they were invited.
4. Existing users are automatically notified of the new participant's arrival and can now chat with them. As soon as they are added, the new user receives a welcome message from Euria (Infomaniak's AI Bot):
   

Access to kSuite, not access to kSuite management!

It is important to differentiate between using the kChat app (within kSuite) and managing kSuite itself.

In the invitation example above, the new user was invited to join kChat, so they are now counted as a kSuite user when an administrator accesses the kChat user management section:

The same applies to kSuite user management:

However, this new user will not be able to directly manage the kSuite to which they were invited, since their role (defined in point 5 above) does not authorize them to do so:

1. This is why this user will not see any 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 ‍ in the top right corner:
   

Note that, if desired, this user can order their own kSuite, independent of the kSuite to which they were invited.

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 details the automatic translation service integrated into the kChat app by Infomaniak.

Translate text while reading

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

1. Click here to access the Infomaniak Web app kChat (online service ksuite.infomaniak.com/kchat) or open the mobile app (application for iOS/Android smartphones or tablets) or the desktop app (desktop application on macOS/Windows/Linux).
2. Go to the message to be translated.
3. Click on the action menu ••• located in the upper right corner of the item in question.
4. Click on Translate:
   
5. The translated message will be displayed after the last message in your conversation and will only be visible to you:
   

Translate text with Euria while writing

You can ask Euria to translate the text you are writing:

1. Click on the Euria icon.
2. Enter your instructions:
   
3. The text will then be displayed in the desired language, and you can send it as is:
   

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 time to contact you, even by 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 evening 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 via Euria on kChat:

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

This guide explains how to obtain a notification to review a specific kChat message at a determined / customizable time (depending on the offers, read below) in 30-minute increments.

✘ UNAVAILABLE with
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

Free kSuite does not allow customization of the schedule when planning.

Remind a kChat message at a fixed time

To review a message with a future notification:

1. Hover over the message to remind and select the additional actions icon ••• in the top right.
2. Click on Remind.
3. Choose the desired time to be notified:
   
4. A notification in the channel (visible only to you) indicates the next reminder of the message:
   
5. You will thus receive at the chosen time a notification from the Euria channel in the left sidebar, leading to the reminder containing a quote of the message, as well as the necessary information to view the message, restart a reminder later, cancel any other potential reminders, etc.

Este guia detalha o princípio das conversas kChat, organizadas em Canais de discussão privados e públicos, e de discussões diretas entre utilizadores.

Iniciar uma conversa

Para escrever para um utilizador da sua Organização, clique no nome dele na lista de membros à esquerda da sua interface kChat:

Também pode clicar no + à direita de Mensagens pessoais para selecionar até 7 membros e, assim, criar uma conversa em grupo:

Escreva e envie a sua mensagem premindo o botão de envio:

Se necessário, pode anexar ficheiros até 100 MB. Também pode usar as “reações”.

Envio agendado: programar uma mensagem

✘ INDISPONÍVEL‍ com
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

kSuite gratuito não permite a personalização do horário ao programar.

Para programar um envio para uma data/hora posterior, basta clicar na seta para a direita do botão de envio e, em seguida, escolher o momento em que a mensagem deve ser enviada:

No aplicativo móvel kChat (aplicativo para smartphone ou tablet iOS/Android), pressione o botão de envio por alguns segundos e um menu para agendar a mensagem será exibido.

Mencionar outro usuário

Para solicitar a atenção de um dos membros da Organização (ou de um Grupo) por meio de uma mensagem, digite o símbolo "@" para exibir as pessoas ou os canais que podem ser mencionados:

Solicitar confirmação de leitura

Para que os usuários possam confirmar o recebimento da sua mensagem e indicar que a leram, ative a confirmação de leitura antes de enviar a mensagem no canal, clicando no ícone (!) e, em seguida, ativando o botão de alternância:

Depois que a mensagem for enviada, o resultado será o seguinte:

Editar/excluir uma mensagem ou fixá-la

Para editar uma mensagem (que exibirá uma indicação de mensagem editada), clique no menu de ação à direita da mensagem a ser editada. No mesmo local, você também pode excluir sua mensagem, que desaparecerá da discussão para todos os usuários:

Uma indicação sobre a exclusão aparecerá para todos os outros usuários do canal no local original da mensagem.

No mesmo local, você pode fixar uma mensagem:

• As mensagens fixadas são visíveis por todos os membros do canal, seja ele público ou privado.
• As mensagens fixadas em um canal privado são acessíveis apenas aos membros desse canal.
• Você pode consultar a lista de todas as mensagens fixadas através da opção «Mensagens fixadas» do canal.
• Para remover uma mensagem fixada, passe o mouse sobre ela novamente e selecione «Remover fixação».

Organizar as conversas no kChat

O tipo de ordenação para os elementos que você gerencia no lado esquerdo da tela é muito importante.

Imagine abrir o kChat após vários dias de ausência; as conversas não lidas serão exibidas umas abaixo das outras. Após ler essas conversas, você pode querer encontrar uma informação lida em uma delas. Assim, uma ordenação por atividade recente, por exemplo (veja abaixo outras possibilidades), permite encontrar as últimas conversas que são relevantes para você.

Essa escolha do tipo de ordenação está disponível para todos os elementos: canais de discussão, categorias, mensagens diretas, etc. 

Pesquisar uma conversa

A pesquisa de elementos (palavra, participante, arquivo) está localizada na parte superior da janela. Uma vez encontrados resultados, eles aparecem no lado direito da janela:

Fio de discussão (thread)

1. Seja qual for o canal ou o chat privado com outro usuário, você pode iniciar um fio de discussão a partir de outro, simplesmente escolhendo Responder na mensagem desejada.
2. Um tópico de discussão será aberto em um painel lateral à direita, permitindo que cada usuário do canal contribua com seus comentários neste tópico específico sem interromper os possíveis novos tópicos do canal em andamento (este tópico pode então ser seguido ou ignorado para não receber mais notificações quando houver novas mensagens — o acompanhamento é gerenciado na parte superior do painel lateral).
3. Esses tópicos de discussão são então centralizados para serem lidos e relidos na seção Tópicos de discussão da barra lateral esquerda.

This guide details how to manage the members of your kChat service.

Prerequisites

• Be a kChat administrator:
  
  • The role within the Organization is irrelevant; being an Organization administrator in the Organization that has the kSuite (and therefore kChat) is not required, and is not sufficient in any case:
    
• Invite a user to join kChat.

View the 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 person icon to the right of the channel title or go through the Members menu.
3. The participants are displayed on the right side of kChat:
   

Invite or remove a member from a private channel

When you have opened the members panel of a channel:

1. The current participants are displayed on the right side of kChat.
2. The Manage button allows you to remove a member from this channel or designate them as the channel Administrator, so that they can, in turn, manage the members:
   
3. The blue Add button allows you to invite a kChat user or an entire Group who does not yet have access to this channel:
   
   • Refer to this other guide regarding adding guests, members who will not use a kSuite license to chat with you on kChat.

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:

Thank you for choosing Infomaniak and kChat as your discussion solution between you, your contacts, 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 change 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.
  • The available storage size is that of my kSuite.

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

Este guia explica como obter lembretes de eventos do aplicativo web Calendar da Infomaniak (serviço online ksuite.infomaniak.com/calendar) em um sistema de bate-papo como kChat, para ser notificado no canal de bate-papo de sua escolha quando um evento estiver próximo.

⚠ Disponível com:

* limitado a 1 webhook

Pré-requisitos

• Crie no aplicativo kChat um webhook de entrada, para obter uma URL do tipo https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx:
  

Vincular o webhook kChat ao Calendar

Para adicionar o webhook do seu sistema de bate-papo ao aplicativo Calendar:

1. Clique aqui para acessar o aplicativo web Calendar da Infomaniak (serviço online ksuite.infomaniak.com/calendar).
2. Clique no ícone Configurações ‍ no canto superior direito.
3. Clique em Integrações no menu lateral esquerdo.
4. Clique no botão Adicionar um webhook:
   
5. Defina:
   
   1. Um nome para identificar facilmente o webhook ao adicionar lembretes.
   2. A URL do webhook (obtida do seu sistema de mensagens).
   3. Os elementos (recolhidos automaticamente do seu evento e/ou adicionados manualmente aqui) e a sua disposição na mensagem que será enviada:
      • Insira %subject%‍ para incluir o assunto do evento.
      • Insira %date%‍ para incluir a data do evento.
      • Insira %description%‍ para incluir a descrição do evento.
      • Insira %location%‍ para incluir a localização do evento, caso exista.
6. Clique no botão para Adicionar o elemento configurado e vê-lo agora criado:
   

Crie um evento com lembrete por chat

Agora que o Calendar está ligado à sua conta do sistema de mensagens, pode optar por ser notificado numa conversa quando adicionar um lembrete a um evento:

1. Clique aqui para acessar o aplicativo web Calendar da Infomaniak (serviço online ksuite.infomaniak.com/calendar).
2. Clique no botão ‍ Criar no canto superior esquerdo.
3. Clique em Evento:
   
   • Você também pode clicar em um evento existente no calendário para editá-lo.
4. Insira os detalhes do evento.
5. Clique em Adicionar lembrete para configurá-lo:
   
6. No menu suspenso dos tipos de lembrete, escolha o webhook configurado (de acordo com o nome dado no ponto 5a acima).
7. Salve o evento na parte inferior da página:
   
8. Quando o momento do lembrete chegar, uma mensagem (no formato configurado no ponto 5c acima) será enviada (aqui no kChat) sobre o evento, no canal configurado no webhook (consulte os pré-requisitos):
   

E em outros sistemas de bate-papo?

Slack

1. Clique aqui para acessar os WebHooks do Slack.
2. Escolha o canal de discussão onde seus lembretes serão exibidos (por exemplo, @slackbot ou #general):
   
3. Salve para obter a URL do webhook.

Crie outros webhooks para definir lembretes em outros canais de discussão.

Você pode usar livremente as opções de formatação do Slack em suas notificações. Exemplo em francês:

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

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”…

Este guia permite que você descubra rapidamente as funções essenciais de Euria, a inteligência artificial à sua disposição dentro de kSuite, que é especialmente eficaz para resumir discussões no aplicativo kChat.

Introdução

• Euria pode ajudá-lo a realizar todo tipo de cálculos, traduções, fornecer informações sobre diferentes tópicos e responder às suas perguntas.
• Leia este outro guia sobre o modelo utilizado e as responsabilidades de cada um.
• Assim que um novo usuário é adicionado, ele recebe uma mensagem de Euria dando-lhe as boas-vindas.
• Leia este outro guia sobre as possibilidades de discussão com a IA no kChat.

Resumir automaticamente uma mensagem do kChat

Para obter o resumo de uma mensagem do kChat:

1. Passe o mouse sobre a mensagem e selecione o ícone de ações da Euria no canto superior direito.
2. Clique em Resumir o tópico de discussão:
   ‍
3. Obtenha o resumo, gerado pela Euria no painel lateral direito:
   

This guide explains how to respond to an email visible on the Web app Mail Infomaniak (online service ksuite.infomaniak.com/mail) by sending the response directly in the Web app kChat (online service ksuite.infomaniak.com/kchat) or the desktop app, in the form of a private message to the email sender.

Preamble

• This feature allows you to respond to an email directly in kChat, with a reminder of the original message to facilitate understanding.
• It aims to streamline collaboration by allowing you to react quickly to an email without leaving the kSuite environment.
• It reduces the back and forth between classic messaging and the collaborative workspace.

Send a response to an email via kChat

Prerequisites

• The button providing access to the feature will only appear in the case of an email received from a sender attached to the kSuite, and this within the same Organization as the user who wishes to respond.
• To display a shortcut to this feature as in the first point 3 below, refer to this other guide.

When you have received an email from a colleague and you want to respond to them directly on kChat:

1. Click here to access the Web app Mail Infomaniak (online service ksuite.infomaniak.com/mail).
2. Open the message to be replied to by kChat.
3. Click on the kChat icon in the email toolbar:
   
   • It is also possible to click on a button below the message:
     
4. Write your kChat message, format it if necessary and click on the Send button at the bottom right:
   
5. Your correspondent receives the message on kChat accompanied by a box representing the original email (date & time, subject):
   

You can access this message on kChat (in the thread of private messages exchanged with your correspondent as above) but also:

1. in an information banner on the email conversation,
2. in the send confirmation message:
   

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

Preamble

• A kChat channel is a communication space dedicated to a project, a theme, 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, dashes, 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 (F)…

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

Differences between PRIVATE and PUBLIC channel

PUBLIC channels increase transparency. All users can see and join a public channel, ensuring that all individuals involved in a project, topic, or team have access to the same information.

PRIVATE channels allow you to restrict sensitive content to users of your choice. Only an existing member can invite another user to a private channel. There are also differences in the management of archiving/deletion (read more below).

⚠ Maximum number of PRIVATE/PUBLIC channels:

Convert a public channel to a private channel, or vice versa

Prerequisites

• Be a kChat administrator user (being an administrator of the channel is not sufficient).

It is possible to modify a Public channel to a Private channel or vice versa, make a private channel public. The message history and members who already have access to the channel will be preserved.

To lock a previously public channel (publicly shared files remain accessible to anyone with the link; the change is permanent and cannot be undone):

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

To make accessible a previously private channel (the channel will be accessible to all users of the other public channels of the Organization except external users who will need to be manually invited):

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

You can then 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 concerned.
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 concerned (in the left sidebar).
2. Choose Mute:
   

Organize by categories

⚠ Maximum number of categories (per user):

You can add one or more categories that allow 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. Then 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 chat 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 details the different elements that can be configured and customized on kChat to best suit your usage preferences.

Change the kChat interface language

The kChat web app displays in the language chosen for the Manager and, just like your avatar/profile photo, these settings are managed within your Infomaniak profile.

The desktop app is configured to use the language of the operating system; you can manage this in the app's settings:

Set up kChat on the Manager

To access kChat preferences on the Infomaniak Manager:

1. Click here to access kChat management on the Infomaniak Manager (need help?).
2. Access the different types of channels.
3. Archive or delete channels from the bottom section.
4. Click on Settings in the left sidebar:
   
5. Add the channels (one or more channels possible) to which new users (excluding external users) will be automatically added in addition to belonging to the channel General.
6. Choose whether everyone can post in the General channel:
   
7. Save your changes at the bottom of the page.

Customize the general display of kChat

To access kChat app settings:

1. Click here to access the kChat web app (online service ksuite.infomaniak.com/kchat) or open the kChat mobile app (app for iOS/Android smartphone or tablet) or the kChat desktop app (desktop app on macOS/Windows/Linux).
2. Click on the icon in the top right of the interface:
   
3. You can choose:
   
   1. a display density, and possible color display in compact density
   2. whether or not to display previews in your conversations
   3. the size of a channel (width)
   4. the starting position when you return to an unread channel
   5. the number of personal messages to display
4. The Notifications tab allows you to customize kChat notifications:
   
5. The Shortcuts tab indicates the list of keyboard shortcuts available to work faster with kChat:
   

Resolve a display zoom issue

To zoom in or out of the display that has become unreadable, you need to use the following keyboard shortcuts:

• as in a browser, CTRL/CMD and - to zoom out
• CTRL/CMD and + to zoom in
• CTRL/CMD and 0 to reapply the default size

Dark Mode / Light Mode

The light or dark theme of the Web app is configured globally (refer to this other guide). However, the desktop app can be configured independently of the rest; this is set from the icon at the top right of the interface:

Customize a discussion, a channel, etc.

Next to each element of the left sidebar is an action menu ⋮ allowing you to define the sort order (alphabetical, by recent activity, manual):

Set a status

To enhance your profile and its display in kChat discussions as well as on the various kSuite pages and tools, you can set a status in the form of text and/or emoticons, with an optional expiration date:

1. Click on your avatar or initials at the top right of the interface.
2. Click on Choose a custom status:
   
3. Enter a custom status or choose one from the suggestions.
4. Enter an expiration date if necessary:
   
5. Click on the smiley icon if you want to choose an emoji next to your name.
6. Confirm with the Set status button.

⚠ Max. number of custom emoticons:

Use kChat with your domain and brand