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.

Este guia detalha os elementos importantes para não perder nenhuma das discussões no kChat que lhe interessam.

Introdução

• Se as notificações estiverem configuradas corretamente para funcionar no aplicativo móvel kChat, também funcionarão nos relógios inteligentes (smartwatch), como os modelos Garmin ou Apple Watch.

Gerenciar as notificações a partir do ícone do aplicativo na área de trabalho

Por exemplo, pode optar por animar o ícone da aplicação de ambiente de trabalho quando receber uma nova mensagem:

1. Abra a aplicação de ambiente de trabalho kChat (aplicação para macOS / Windows / Linux).
2. Clique com o botão esquerdo do rato no ícone do aplicativo para desktop na área de notificação do seu computador (no canto superior direito no macOS, no canto inferior direito no Windows e clique duas vezes na barra de tarefas no Linux).
3. Clique em Preferências...
4. Em Opções do aplicativo, defina as preferências de notificação do sistema operacional:
   

Gerenciar as notificações de conversas e eventos

Para gerir as notificações do kChat e, assim, ser notificado, por exemplo, quando uma nova mensagem lhe for enviada diretamente ou quando estiver a acompanhar uma mensagem específica, incluindo com base em determinadas palavras-chave:

1. Clique aqui para aceder à aplicação web kChat (serviço online ksuite.infomaniak.com/kchat) ou abra a aplicação móvel kChat (aplicação para smartphone ou tablet iOS/Android) ou ainda a aplicação de ambiente de trabalho kChat (aplicação para computador macOS/Windows/Linux).
2. Clique no ícone Configurações ‍ no canto superior direito da interface.
3. Clique em Notificações.
4. Defina a forma como deseja ser notificado (computador/celular, presente/ausente, etc.) e em que casos (todas as mensagens ou apenas mensagens com menção, mensagens acompanhadas, etc.).
5. Escolha receber notificações regulares por e-mail:
   • Este e-mail é enviado diariamente ou uma vez por semana, entre as 6 e as 8 horas da manhã, e informa o usuário sobre as mensagens que ele não leu.
   • O usuário recebe um e-mail por produto kChat ao qual ele tem acesso.
6. Defina uma palavra-chave para receber notificações quando uma nova mensagem for publicada:
   

Gerenciar as notificações de um canal específico

No canal de discussão em questão:

1. Clique na seta para baixo ‍ à direita do nome do canal em questão.
2. Clique em Preferências de notificação (ou diretamente no ícone dedicado na parte superior do canal):
   
3. Navegue e ative as diferentes notificações desejadas.
4. Uma das opções permite ser notificado automaticamente assim que um tópico de discussão (thread) for iniciado após uma mensagem ser publicada no canal correspondente.
5. Salve suas configurações clicando no botão na parte inferior:
   

Gerenciar as notificações de uma discussão específica

Para ser notificado sobre uma nova mensagem em um tópico de discussão (thread) específico, mesmo que você não seja um participante direto, é necessário ativar o Acompanhamento:

• ao passar o cursor sobre o menu de ações ••• à direita de um utilizador numa conversa:
  1. e clicar em Mais…:
     
  2. e, em seguida, em Seguir mensagem:
     
• numa conversa (resposta a uma mensagem):
  1. clique em Seguir na parte superior da conversa (irá automaticamente seguir a conversa a partir do momento em que enviar uma mensagem e poderá, então, deixar de Seguir as trocas de mensagens nesta conversa):
     

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:
   

Este guia explica como configurar uma notificação para revisar uma mensagem específica do kChat em um horário determinado/personalizável (dependendo das ofertas, veja abaixo) em intervalos de 30 minutos.

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

Agendar um lembrete para uma mensagem do kChat

Para revisar uma mensagem no futuro por meio de uma notificação:

1. Passe o mouse sobre a mensagem que deseja agendar e selecione o ícone de ações adicionais ••• no canto superior direito.
2. Clique em Lembrete.
3. Escolha o horário desejado para receber a notificação:
   
4. Uma notificação no canal (visível apenas para você) indica o próximo lembrete da mensagem:
   
5. Assim, no horário escolhido, você receberá uma notificação do canal Euria no menu lateral esquerdo, que o levará ao lembrete contendo uma citação da mensagem, bem como as informações necessárias para consultar a mensagem, agendar um novo lembrete para mais tarde, cancelar quaisquer outros lembretes, 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.

Este guia trata das mensagens que começam com / no kChat, interpretadas como comandos slash.

Executar um comando slash no kChat

Para aceder aos comandos slash no kChat:

1. Clique no campo de redação dentro de um canal.
2. Insira um sinal / (slash ou barra) e o comando associado.
3. Valide para enviar o comando.

Se digitar apenas o sinal /, uma janela será exibida com os comandos que podem ser executados, como, por exemplo, definir o status como "ausente".

A seguir, uma tabela com os principais comandos:

Criar um comando slash personalizado

Pré-requisitos

• Não ser um utilizador externo (não verá o menu Integrações).

Para criar um comando slash personalizado:

1. Clique aqui para acessar o aplicativo Web kChat (serviço online ksuite.infomaniak.com/kchat) ou abra o aplicativo desktop kChat (aplicativo para macOS / Windows / Linux).
2. Clique no ícone Novo ao lado do nome da sua organização kChat.
3. Clique em Integrações:
   
4. Clique em Comando slash:
   
5. Clique no botão azul para Adicionar um comando:
   
6. Configure o comando slash (nome, gatilho (sem o /), tipo de conteúdo esperado, ação a ser executada*, etc., incluindo se o comando deve ser exibido na janela de ajuda mencionada no capítulo acima).
   • * Isso pode incluir a chamada a uma API externa, a execução de um script, a exibição de uma resposta específica, etc. Para isso, você geralmente precisará de um script ou aplicativo externo que responderá aos comandos. Você também pode definir parâmetros adicionais para o comando, como opções suspensas, caixas de seleção, etc., dependendo de suas necessidades.
7. Salve o comando.
8. Certifique-se de testar o comando para garantir que ele funcione conforme o esperado.

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%

Este guia explica como configurar uma ação no n8n para que uma mensagem seja enviada no kChat quando as condições forem cumpridas.

Pré-requisitos

• Instalar n8n em uma hospedagem Infomaniak.
• Criar um webhook no aplicativo kChat Infomaniak.

Criar a ação no n8n

Na sua sessão n8n:

1. Clique para começar do zero:
   
2. Clique para adicionar a primeira ação.
3. Escolha um gatilho manual:
   
4. Clique para adicionar uma ação a ser acionada.
5. Pesquise e ative uma ação do tipo “Requisição HTTP”:
   
6. Escolha o método POST.
7. Insira a URL do seu webhook kChat.
8. A autenticação não é necessária (já está aplicada na URL).
9. Ative o botão de alternância (toggle switch) “Enviar corpo” para poder especificar um conteúdo:
   
10. No campo “Nome”, insira o termo exato “text”, conforme esperado pelo kChat.
11. No campo “Valor”, insira as informações que deseja exibir no kChat.
12. Clique no botão para testar e aplicar seu comando manual:
    
13. A mensagem especificada no n8n será então exibida no kChat:
    

Agora que esta base está funcionando, você pode imaginar substituir o texto fixo por dados provenientes de outras fontes. Por exemplo, adicione um nó "Imap" ou "RSS Feed" antes do nó HTTP Request. Assim, em vez de digitar o texto manualmente, clique no pequeno ícone de engrenagem ao lado de Value > Expression para indicar: "Enviar no kChat o título do último e-mail recebido"…

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:
   

Este guia detalha o uso e a gestão dos canais no kChat.

Introdução

• Um canal kChat é um espaço de comunicação dedicado a um projeto, um tema ou uma equipe, no qual os membros podem trocar documentos, comunicar em tempo real e organizar videoconferências.
• Os canais privados (e públicos, assim como os convidados) têm um número limitado, dependendo do plano kSuite adquirido; consulte a tabela comparativa na página de vendas para obter mais informações.

⚠ Histórico armazenado visível (em dias):

Canal Geral

Cada Organização no kChat possui automaticamente um canal Geral no qual todos os utilizadores são automaticamente convidados:

Pode usar este canal para partilhar informações relevantes para toda a sua organização, como eventos da empresa ou notícias motivadoras.

Pode, naturalmente, iniciar uma nova conversa dentro do canal Geral.

Canal adicional

Para adicionar um novo canal de discussão:

1. Clique no botão ‍ Novo localizado na barra lateral esquerda do aplicativo web kChat (serviço online ksuite.infomaniak.com/kchat).
2. Clique em Criar um novo canal.
3. Você também pode clicar em ‍Adicionar canais abaixo da lista de canais:
   

Informações sobre um canal

Ao criar um novo canal, pode escolher:

A. o nome

Poderá ser modificado posteriormente.

B. o seu URL

Por padrão, o nome do canal é utilizado, mas você pode alterá-lo usando letras minúsculas, números, pontos, hífens e sublinhados – podendo ser modificado posteriormente.

C. seu status PRIVADO ou PÚBLICO

Poderá ser modificado posteriormente (veja abaixo).

D. a sua descrição

A descrição permite especificar a forma como este canal deve ser utilizado. Este texto aparece na lista de canais no menu «Mais...» e fornece uma indicação aos utilizadores para que saibam se devem aderir ao canal ou não.

Após a criação do canal, ainda pode definir:

E. um cabeçalho

e você pode clicar em Informações (F)…

… para encontrar as informações e poder editar algumas delas:

Diferenças entre canal PRIVADO ou PÚBLICO

Os canais PÚBLICOS aumentam a transparência. Todos os utilizadores podem ver e aderir a um canal público, o que garante que todas as pessoas envolvidas num projeto, tema ou equipa têm acesso à mesma informação.

Os canais PRIVADOS permitem restringir o conteúdo sensível aos utilizadores que escolher. Apenas um membro existente pode convidar outro utilizador para um canal privado. Existem também diferenças na gestão da arquivação/eliminação (consulte abaixo).

⚠ Número máximo de canais PRIVADOS / PÚBLICOS:

Converter um canal público em canal privado, ou vice-versa

Pré-requisitos

• Ser administrador do kChat:
  
  • Não importa o cargo na Organização; ser administrador da Organização na qual existe o kSuite (e, portanto, o kChat) não é obrigatório e, de qualquer forma, não é suficiente:
    
  • Ser administrador do canal também não é suficiente.

É possível alterar um canal Público para um canal Privado ou vice-versa, tornando um canal privado em público. O histórico das mensagens e os membros que já têm acesso ao canal serão mantidos.

Para bloquear um canal que era público (os arquivos compartilhados publicamente permanecem acessíveis a qualquer pessoa que tenha o link; a alteração é permanente e não pode ser desfeita):

1. Clique na seta para baixo ‍ no título do canal, na parte superior da conversa no canal Público.
2. Clique em Configurações do canal.
3. Escolha Converter:
   

Para tornar acessível um canal que antes era privado (o canal ficará acessível a todos os utilizadores dos outros canais públicos da Organização, exceto os utilizadores externos, que terão de ser convidados manualmente):

1. Clique na seta para baixo no título do canal, na parte superior da conversa no canal Privado.
2. Clique em Configurações do canal.
3. Escolha Converter:
   

Também pode efetuar a conversão a partir da gestão do kChat no Painel de controlo:

1. Clique aqui para aceder à gestão do seu kChat no Painel de controlo Infomaniak (precisa de ajuda?).
2. Clique no menu suspenso para exibir os canais privados.
3. Clique no menu de ações ⋮ localizado à direita do item correspondente.
4. Clique em Converter em canal público:
   

Sair de um canal

Além do canal principal, intitulado Geral, você pode sair de um canal a qualquer momento:

1. Clique na seta para baixo ‍ no título do canal, na parte superior da conversa.
2. Clique em Sair do canal:
   

Se sair de um canal privado, não o encontrará mais nas pesquisas, apenas através do seu URL, caso o possua, ou sendo convidado novamente por um membro do canal.

Se sair de um canal público, você o deixará imediatamente, mas poderá voltar a ele quando quiser, simplesmente encontrando-o novamente pelo nome (2) na pesquisa (1), mesmo que ele tenha sido arquivado:

Arquivar / excluir um canal

Além do canal principal, intitulado Geral, você pode arquivar um canal a qualquer momento, o que impede o envio de novas mensagens e não o incluirá mais na cota dos seus canais disponíveis. A operação pode ser realizada no Painel de Controle ou diretamente na interface kChat:

1. Clique na seta para baixo ‍ no título do canal, na parte superior da conversa.
2. Clique em Arquivar canal:
   

Se criar um canal e, em seguida, o arquivar, poderá voltar a entrar nele quando quiser, simplesmente encontrando-o pelo nome (2) na pesquisa (1):

Em seguida, poderá desativar o arquivo:

1. Clique na seta para baixo ‍ no título do canal, na parte superior da conversa.
2. Clique em Desarquivar o canal:
   
3. … ou feche-o para que não apareça mais na sua interface:
   

Você também pode excluir um canal e, nesse caso, todos os dados associados serão excluídos permanentemente:

1. Clique aqui para acessar o gerenciamento do seu kChat no Painel de Controle Infomaniak (precisa de ajuda?).
2. Clique no menu de ação ⋮, localizado à direita do elemento em questão.
3. Clique em Excluir:
   

Adicionar aos favoritos

Para adicionar qualquer canal (ou utilizador) aos favoritos:

1. No aplicativo web kChat (serviço online ksuite.infomaniak.com/kchat), clique no ícone estrela localizado na parte superior de um canal ou de um usuário.
2. Um novo menu Favoritos aparecerá na barra lateral esquerda, agrupando todos os elementos que você adicionou aos favoritos (visível apenas para o seu usuário):
   

Silenciar um canal

Você pode ocultar as notificações de um canal para não receber mais notificações quando uma nova mensagem for publicada:

1. No aplicativo web kChat (serviço online ksuite.infomaniak.com/kchat), clique no menu de ação ⋮ à direita do canal desejado (na barra lateral esquerda).
2. Escolha Silenciar: 
   

Organizar por categorias

⚠ Número máximo de categorias (por utilizador):

Pode adicionar uma ou mais categorias para organizar os seus elementos (canal, contacto, etc.) dentro destas:

1. Clique no botão ‍ Novo localizado na barra lateral esquerda do aplicativo web kChat (serviço online ksuite.infomaniak.com/kchat).
2. Clique em Criar uma nova categoria:
   
3. Arraste, em seguida, o canal desejado para a categoria criada (válido apenas para o seu utilizador):
   
4. Também pode utilizar o menu de ação ⋮ à direita do canal em questão (na barra lateral esquerda) para realizar estas operações:
   

Canal de discussão entre utilizadores

As mensagens pessoais são conversas diretas entre duas ou mais pessoas que ocorrem fora dos canais.

Cada utilizador de uma Organização pode criar livremente mensagens pessoais cujo conteúdo será visível apenas para as pessoas envolvidas:

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