¡Gracias por elegir Infomaniak y kChat como solución de chat entre usted, sus seres queridos o su empresa! Estas guías le ayudarán a organizar sus canales, usuarios, conversaciones y mucho más!

Prólogo

• Multiplataforma, kChat es el mensajero instantáneo de kSuite que permite intercambiar, compartir y coordinar a sus equipos de manera segura desde…
  • … su navegador web
  • … su dispositivo iOS / Android
  • … su tableta móvil o su computadora macOS / Windows / Linux
• Descargue la app kChat en sus dispositivos!
  • No es posible modificar la ubicación de la carpeta kchat-desktop en su disco duro.
  • El contenido de las conversaciones, fotos, videos, se almacena en línea en los servidores seguros de Infomaniak.

¿Qué desea hacer?

• Configurar kChat
• Gestionar los usuarios
• Gestionar un canal
• Gestionar una conversación
• Reaccionar a los mensajes
• Gestionar las notificaciones kChat
• Formatear los mensajes e insertar imágenes
• Enviar un mensaje de voz y su transcripción automática
• Traducir el contenido de un mensaje en la app kChat Infomaniak

¿Tiene alguna pregunta o comentario?

• En caso de problema, consulte la base de conocimientos antes de contactar con el soporte.
• Haga clic aquí para compartir una opinión o sugerencia sobre un producto Infomaniak.

Esta guía le permite gestionar aplicaciones externas con kChat utilizando webhooks.

Prólogo

• Un webhook es un método que permite a una aplicación ser informada inmediatamente cuando ocurre un evento particular en otra aplicación, en lugar de preguntar constantemente a esa aplicación si ha ocurrido algo nuevo (lo que se conoce como "polling").
  • Webhook saliente: kChat comunica información a otras aplicaciones cuando ocurre un evento en kChat.
  • Webhook entrante: kChat recibe información de otras apps para desencadenar acciones en kChat.
• No es posible importar el historial de conversaciones desde otra aplicación (Slack, Teams, Jabber, etc.) o desde otra Organización.

Acceder a la interfaz de webhooks de kChat

Requisitos previos

• No ser un usuario externo (este no verá el menú Integraciones).

Para configurar un webhook, encontrar aplicaciones e integraciones autoalojadas o de terceros:

1. Haga clic aquí‍ para acceder a la app Web kChat (servicio en línea kchat.infomaniak.com) o abra la app de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el icono Nuevo ‍ junto al nombre de su organización kChat.
3. Haga clic en Integraciones.
4. Accede a las categorías:
   

Ejemplo de integración

• Recordatorio de evento de calendario Infomaniak en kChat

Crear un simple webhook entrante

Para ello:

1. Haga clic en la categoría Webhooks entrantes.
2. Haga clic en el botón azul Agregar webhooks entrantes:
   
3. Añada un nombre y una descripción (máx. 500 caracteres) para el webhook.
4. Seleccione el canal que recibirá los mensajes
5. Guarde para obtener la URL (no la divulgue públicamente); ejemplo “https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx”.

Uso del webhook

En la aplicación que debe publicar en kChat:

1. Ajuste el código a continuación según la URL obtenida:

   POST /hooks/xxx-key-generated-xxx HTTP/1.1
   Host: your-server-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   {
       "text": "Hello, text1
   Text2."
   }

2. Opcionalmente, utilice la misma solicitud pero en curl (para probar desde una aplicación de tipo Terminal (interfaz de línea de comandos, CLI /Command Line Interface) en su dispositivo):
   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, text1 Text2."}' https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx

Si no se define ninguna cabecera Tipo de contenido no está definido, el cuerpo de la solicitud debe preceder de carga= así:

payload={"text": "Hello, text1 Text2."}

Una solicitud exitosa recibirá la siguiente respuesta:

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	
}

Si desea tener el mismo formato de respuesta que 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

debes agregar ?slack_return_format=true a la URL del webhook.

Parámetros

Además del campo text, aquí está la lista completa de los parámetros soportados:

Ejemplo de código con parámetros

Aquí está cómo generar un mensaje más completo con parámetros, algunos de los cuales pueden reemplazar parámetros ya establecidos durante la creación del webhook (nombre de usuario, canal preferido, avatar...) como se indica en la tabla anterior:

POST /hooks/xxx-clé-générée-xxx HTTP/1.1
Host: votre-serveur-kchat.xyz
Content-Type: application/json
Content-Length: 630
{
  "channel": "kchatemp",
  "username": "test-automation",
  "icon_url": "https://domain.xyz/wp-content/uploads/2023/06/icon.png",
  "text": "#### Résultats des tests pour le 27 juillet 2023
@channel veuillez vérifier les tests échoués.

| Composant  | Tests effectués   | Tests échoués                                   |
|:-----------|:-----------:|:-----------------------------------------------|
| Serveur     | 948         |  0                           |
| Client Web | 123         |  2 [(voir détails)](https://linktologs) |
| Client iOS | 78          |  3 [(voir détails)](https://linktologs) |"
}

Esto hará que se muestre este mensaje en el canal kchatemp de la organización :

Esta guía detalla el servicio de traducción automática integrado en la app kChat Infomaniak.

Traducir el texto al leerlo

Para traducir automáticamente a tu idioma un mensaje recibido escrito en un idioma extranjero:

1. Haga clic aquí para acceder a la app web kChat Infomaniak (servicio en línea kchat.infomaniak.com) o abra la app móvil (aplicación para smartphone o tableta iOS / Android) o la app de escritorio (aplicación de escritorio en macOS / Windows / Linux).
2. Consulte el mensaje a traducir.
3. Haga clic en el menú de acción ••• ubicado en la parte superior derecha del elemento en cuestión:
   
4. Haga clic en Traduce:
   
5. El mensaje traducido se muestra debajo de tu conversación y solo es visible para ti.

Esta guía explica cómo obtener recordatorios de eventos de la aplicación web Calendar Infomaniak (servicio en línea calendar.infomaniak.com) en un sistema de chat como kChat o Slack.

Prólogo

• Esta funcionalidad le permitirá recibir una notificación en el hilo de conversación de su elección cuando un evento esté próximo.
• El sistema de webhook es un método para que una aplicación o servicio envíe información a otra aplicación o servicio en tiempo real, de manera segura y autenticada.

Anuncie el webhook a Calendar

Para agregar el webhook de su sistema de discusión a Calendar:

1. Haga clic aquí para acceder a la app Web Calendar (servicio en línea calendar.infomaniak.com).
2. Haga clic en el icono Configuración ‍ en la esquina superior derecha.
3. Haga clic en Integraciones en el menú lateral izquierdo.
4. Haga clic en el botón Agregar un webhook:
   
    
5. Configura:
   
   1. Un nombre para identificar fácilmente el Webhook cuando agregues recordatorios.
   2. La URL del webhook (obtenida de tu sistema de chat - se presentan ejemplos más abajo en la FAQ).
   3. Los elementos (tomados automáticamente de tu evento y/o añadidos manualmente aquí) y su disposición en el mensaje que se enviará:
      • Inserta %subject%‍ para incluir el asunto del evento.
      • Inserta %date%‍ para incluir la fecha del evento.
      • Inserta %description%‍ para incluir la descripción del evento.
      • Inserta %location%‍ para incluir la posible ubicación del evento.
6. Haga clic en Añadir.

Crea un evento con recordatorio por chat

Ahora que Calendar está vinculado a su cuenta de sistema de discusión, puede elegir ser notificado en una discusión cuando agrega un recordatorio a un evento:

1. Haga clic aquí para acceder a la app Web Calendar (servicio en línea calendar.infomaniak.com).
2. Crea un nuevo evento.
3. Haga clic en la esquina inferior derecha para mostrar los campos adicionales:
   
4. Añade un recordatorio:
   
5. En el menú desplegable, elige el webhook configurado.
6. Confirme los cambios.

Ahora recibirá una notificación en el chat correspondiente al webhook.

Ejemplos para obtener un webhook

kChat

1. Haga clic aquí‍ para acceder a la app Web kChat (servicio en línea kchat.infomaniak.com) o abra la app de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Diríjase a la sección Integraciones.
3. Haga clic en Webhooks entrantes:
   
4. Haga clic en la esquina superior derecha en Agregar.
5. Complete la información requerida para crear el "bot" que va a publicar los mensajes de recordatorio en kChat en el canal de tu elección:
   
6. Guarde para obtener la URL del webhook:
   
7. Cree la notificación personalizada en Calendar (leer más arriba si es necesario):
   
8. Seleccione su notificación personalizada al agregar un recordatorio a su evento:
   

Slack
 

1. Haga clic aquí para acceder a los WebHooks Slack.
2. Seleccione el canal en el que se mostrarán sus recordatorios (p. ej. @slackbot o #general):
   
3. Guarde para obtener la URL del webhook.

Crea otros webhooks para definir recordatorios en otros hilos de conversación.

Personaliza los recordatorios de un recordatorio de Slack

Puede utilizar libremente las opciones de formato de Slack en sus notificaciones. Ejemplo en francés:

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

Esta guía detalla la gestión de los miembros de su servicio de chat kChat.

Consulte este otro guía si deseas gestionar los canales a los que deberán pertenecer automáticamente los nuevos miembros.

Requisitos previos

• Tener permisos suficientes para administrar el producto en cuestión.
• Invitar a un usuario a unirse a kChat.

Ver los miembros de un canal

Para ver los usuarios que tienen acceso al canal seleccionado:

1. Haga clic aquí‍ para acceder a la app Web kChat (servicio en línea kchat.infomaniak.com) o abra la app de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el ícono de personaje debajo del título del canal.
3. Los participantes se muestran en una columna a la derecha de kChat:
   

Invitar o eliminar a un miembro de un canal privado

Para gestionar los usuarios que tienen acceso a un canal privado:

1. Haga clic en el ícono de personaje debajo del título del canal.
2. Los participantes actuales se muestran en una columna a la derecha de kChat.
3. El botón azul Agregar permite invitar a un usuario de kChat o a un equipo de trabajo completo que aún no tenga acceso a este canal:
   
4. El botón Gestionar permite eliminar a un miembro de este canal o nombrarlo Administrador del canal para que a su vez pueda gestionar a los miembros:
   

Esta guía detalla el uso de emoticonos y otros emojis para reaccionar e interactuar en las discusiones del servicio kChat.

Agregar una reacción a un mensaje

Para reaccionar en cualquier momento a cualquier mensaje al que tengas acceso en kChat, simplemente pasa el ratón por encima del mensaje y selecciona una emoticón de la selección o el emoticono con el pequeño +:

 

Si ya reacciones, puedes agregar una en el mismo lugar:

Así se abrirá el panel con cientos de emoticones disponibles (e incluso emojis personalizados - leer más abajo).

Expresarse con una emoticón o un GIF

Agregar un emoji dentro del mensaje que estás redactando es muy sencillo. Solo tienes que hacer clic en el icono de la cara sonriente en la barra de formato de tu mensaje:

Entonces puedes elegir un emoji:

o insertar cortos GIF animados en lugar de una emoticona gracias a la pestaña situada en la parte superior del recuadro que se muestra cuando haces clic en el rostro sonriente:

 

Si conoces el nombre del símbolo que deseas insertar, también puedes escribir : (dos puntos) seguido de al menos los dos primeros caracteres:

Consejo: si agregas #, ## o ### como primer carácter de una nueva línea que contiene una emoticón, podrás usar una emoticón más grande. Para probar, envía un mensaje como '# :smile:' (ten en cuenta que tus ajustes personalizados pueden "desactivar" esta funcionalidad de visualización en tu interfaz).
 

Para definir el tono predeterminado, haga clic en este símbolo del panel de emojis:
 

Emoticonos personalizados

Para gestionar emoticones adicionales, haga clic en este botón del panel de emojis:

Especifique un nombre de hasta 64 caracteres. Puede contener letras minusculas, numeros y los caracteres « - », « + » y « _ ».

Especificar un archivo .gif, .png o .jpg para su emoticón. El archivo puede pesar hasta 1 Mo. El tamaño se redimensiona automáticamente a 128 por 128 píxeles, manteniendo la relación de aspecto.

El emoticón podrá ser utilizado por todos los usuarios de kChat de su Organización gracias al nombre que le ha asignado.

Esta guía se refiere a los productos de Infomaniak que integran el uso de inteligencia artificial, en particular kChat, kDrive, Mail, Site Creator…

Responsabilidades de las partes

Datos proporcionados a la IA

• La IA de Infomaniak se basa actualmente por defecto en mixtral8x22b.
  • GPT4 turbo es una opción voluntaria dejada al criterio del usuario de kChat / Mail; DeepSeek-R1-distilled-qwen-32B también se ofrece en el sitio y la API.
  • Los mensajes de audio se transcriben con Whisper.
  • Llama 3 está disponible para la API AI Tools.
• Al utilizar un asistente de redacción, los mensajes y las solicitudes dirigidas a la IA se procesan exclusivamente en Suiza mediante la infraestructura de Infomaniak.
• No se trata ni se comparte ningún dato con terceros.

Datos aportados por la IA

• El modelo de lenguaje genera texto basado en los datos que ha asimilado durante su aprendizaje, sin conciencia, intenciones o responsabilidades morales.
• Es crucial que el usuario sea consciente de que las informaciones generadas por el modelo no siempre son precisas y no deben ser consideradas como una fuente de información infalible.
• Debe ejercer su criterio crítico y verificar la información proporcionada por el asistente con fuentes confiables cuando sea necesario.
  • Por ejemplo, si una persona utiliza el modelo para tareas cruciales como consejos médicos, legales o financieros, debe tomar precauciones adicionales para confirmar la información proporcionada por el modelo.
• En caso de uso inapropiado o peligroso de esta asistente, la responsabilidad recae en el usuario que realiza estas acciones.

Esta guía explica cómo obtener automáticamente el resumen del contenido de un mensaje kChat.

Resumir automáticamente un mensaje kChat

Para obtener el resumen de un mensaje kChat:

1. Pase el ratón por el mensaje y seleccione el icono de acciones de IA en la esquina superior derecha.
2. Haga clic en Resumir el hilo de la conversación:
   ‍
3. Obtenga el resumen, generado por IA y enviado por kChat Bot en el panel lateral derecho:
   

Consulta esta otra guía sobre los agentes conversacionales de kChat.

Esta guía detalla el principio de las conversaciones kChat, organizadas dentro de Canales de discusión privados y públicos, y de discusiones directas entre usuarios.

Iniciar una conversación

Para escribir a un usuario de tu Organización, haz clic en su nombre en la lista de miembros a la izquierda de tu interfaz kChat:

También puede hacer clic en el + a la derecha de Mensajes personales para seleccionar hasta 7 miembros y así crear una conversación de grupo:

Redacte y envíe su mensaje presionando el botón de envío:

Si es necesario, puede adjuntar archivos de hasta 100 Mo. También puede utilizar “reacciones”.

Programar un envío

Para programar un envío para una fecha/hora posterior, simplemente haga clic en la flecha a la derecha del botón de envío y luego elija el momento en que se debe enviar el mensaje:

Mencionar a otro usuario

Para solicitar a uno de los miembros de la Organización (o a todo un equipo de trabajo) a través de un mensaje, escriba la arroba @ para mostrar las personas o los canales a mencionar:

Solicitar un acuse de recibo

Para que los usuarios puedan confirmar la recepción de su mensaje y así indicar que han leído el mensaje, active una confirmación de lectura antes de enviar el mensaje en el canal, haciendo clic en el icono (!) y luego activando el botón de alternancia (toggle switch):

Una vez enviado el mensaje, el resultado será el siguiente:

Editar o eliminar un mensaje

Para editar un mensaje (que luego mostrará una mención de mensaje editado), haga clic en el menú de acción a la derecha del mensaje a editar. En el mismo lugar, también puede eliminar su mensaje, que desaparecerá de la conversación para todos los usuarios:

Organizar las conversaciones en kChat

El tipo de ordenación para los elementos que gestionas en el lado izquierdo de la pantalla es muy importante.

Imagina abrir kChat después de varios días de ausencia, las conversaciones no leídas se mostrarán una debajo de la otra. Después de leerlas, quizás quieras encontrar una información leída entre ellas, por lo que una ordenación por actividad reciente, por ejemplo (lee a continuación para otras posibilidades), te permite encontrar las últimas conversaciones que te concernían. 

Esta opción de tipo de clasificación está disponible para todos los elementos: canales de discusión, categorías, mensajes directos, etc.

Buscar una conversación

La búsqueda de elementos (palabra, participante, archivo) se encuentra en la parte superior de la ventana:

Una vez encontrados los resultados, aparecen a la derecha de la ventana.

Hilo de discusión (thread)

Sea cual sea el canal o el chat privado con otro usuario, puedes iniciar un hilo de discusión a partir de otro simplemente eligiendo Responder en el mensaje deseado.

Se abrirá un hilo de conversación a su derecha, permitiendo a cada usuario del canal aportar sus comentarios en este hilo específico sin interrumpir los posibles nuevos temas del canal en curso:

Estos hilos de discusión se centralizan luego para ser leídos y releídos en la sección Hilos de discusión de la barra lateral izquierda.

Esta guía trata sobre kChat, el servicio de mensajería instantánea de Infomaniak que permite intercambiar, compartir y coordinar a sus equipos de manera segura desde su navegador web, móvil, tableta u ordenador.

Obtener kChat

kChat está disponible con kSuite.

Una vez que haya implementado kSuite en su Organización, descargue…

• … la app móvil kChat (aplicación para smartphone o tableta iOS / Android)
• … la app de escritorio kChat (aplicación de escritorio para macOS / Windows / Linux).

y/o haga clic aquí para acceder a la app Web kChat (servicio en línea kchat.infomaniak.com).

Tenga también en cuenta la guía de inicio.