¡Gracias por elegir Infomaniak y kChat como solución de mensajería para usted, su entorno o su empresa!

Estas guías le ayudarán a organizar sus canales, usuarios, conversaciones ¡y mucho más!

Para empezar

Multiplataforma, kChat es el servicio de mensajería instantánea de kSuite que le permite intercambiar, compartir y coordinar a sus equipos de forma segura desde su navegador web, dispositivo iOS/Android, tableta móvil o computadora macOS/Windows/Linux.

¡Descargue la app de kChat en sus dispositivos!

¿Qué desea hacer?

• Gestionar usuarios
• Gestionar un canal
• Gestionar una conversación
• Reaccionar a los mensajes
• Gestionar las notificaciones de kChat
• Formatear los mensajes e insertar imágenes
• Enviar un mensaje de voz y su transcripción automática

¿Tiene alguna pregunta o comentario?

• El soporte de Infomaniak está a su disposición
• ver todas las FAQ de kChat
• haga clic aquí para compartir una opinión o sugerencia sobre un producto de Infomaniak

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

Preámbulo

• 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 estar preguntando constantemente a esa aplicación si ha llegado algo nuevo (lo que se llama "polling")
• no es posible importar el historial de discusiones desde otra aplicación (Slack, Teams, Jabber, etc.) o desde otra organización
• webhook saliente: kChat comunica información a otras aplicaciones cuando ocurre un evento en kChat
• webhook entrante: kChat recibe información de otras aplicaciones para desencadenar acciones en kChat

Acceder a la interfaz de webhooks de kChat

Requisitos previos

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

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

1. abrir la aplicación kChat (en su dispositivo o desde un navegador en la URL kchat.infomaniak.com)
2. hacer clic en la flecha hacia abajo ‍ a la derecha del nombre de su organización en kChat
3. hacer clic en Integraciones
   
    
4. acceder a las categorías:
   

Ejemplo de integración

• Recordatorio de evento del calendario de Infomaniak en kChat

Crear un webhook entrante simple

Para ello:

1. hacer clic en la categoría Webhooks entrantes
2. hacer clic en el botón azul Agregar webhooks entrantes
   
3. agregar un nombre y una descripción (máx. 500 caracteres) para el webhook
4. seleccionar el canal que recibirá los mensajes
5. guardar para obtener la URL (no divulgar públicamente) de tipo:
   https://su-servidor-kchat.xyz/hooks/xxx-clave-generada-xxx

Uso del webhook

En la aplicación que debe publicar en kChat:

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

   POST /hooks/xxx-clave-generada-xxx HTTP/1.1
   Host: su-servidor-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   
   {
       "text": "Hola, este es un texto\nEste es otro texto."
   }

2. opcionalmente, puede usar la misma solicitud, pero en curl (para probar desde una Terminal en macOS, por ejemplo):
   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hola, este es un texto\nEste es otro texto."}' https://su-servidor-kchat.xyz/hooks/xxx-clave-generada-xxx

Si no se establece un encabezado Content-Type, el cuerpo de la solicitud debe precederse con payload= de la siguiente manera:

payload={"text": "Hola, este es un texto\nEste es otro texto."}

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 deseas 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 al final de la URL del webhook.

Parámetros

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

Ejemplo de código con parámetros

Así es como puedes generar un mensaje más completo con parámetros, algunos de los cuales pueden sobrescribir parámetros que ya se han establecido al crear el webhook (nombre de usuario, canal preferido, avatar...), como se indica en la tabla anterior:

POST /hooks/xxx-clave-generada-xxx HTTP/1.1
Host: su-servidor-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": "#### Resultados de las pruebas para el 27 de julio de 2023\n@channel por favor revise las pruebas fallidas.\n\n| Componente  | Pruebas realizadas   | Pruebas fallidas                                   |\n|:-----------|:-----------:|:-----------------------------------------------|\n| Servidor     | 948         |  0                           |\n| Cliente Web | 123         |  2 [(Ver detalles)](https://linktologs) |\n| Cliente iOS | 78          |  3 [(Ver detalles)](https://linktologs) |"
}

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

Esta guía explica cómo recibir recordatorios de eventos de Infomaniak Calendar en un sistema de chat como kChat o Slack.

Esta función le permitirá ser notificado en el hilo de chat de su elección cuando se acerque un evento.

¿Qué es un Webhook?

El sistema de Webhook es un método mediante el cual una aplicación o servicio envía información a otra aplicación o servicio en tiempo real de manera segura y autenticada.

Configurar el Webhook en Calendar

Para agregar el Webhook de su sistema de chat a Calendar:

1. Inicie sesión en Calendar (calendar.infomaniak.com), la parte de calendarios de Infomaniak Mail, desde un navegador web como Brave o Firefox.
2. Haga clic en el icono
3. Haga clic en el botón Agregar un Webhook (en la sección de Notificaciones personalizadas)
   
4. Configure:
   
   • (A) Un nombre para identificar fácilmente el Webhook cuando agregue recordatorios.
   • (B) La URL del Webhook (obtenida de su sistema de chat; se presentan ejemplos más abajo en la FAQ).
   • (C) Los elementos (tomados automáticamente de su evento y/o agregados manualmente aquí) y su disposición en el mensaje que se enviará:
     • Incluya %subject% para agregar el asunto del evento.
     • Incluya %date% para agregar la fecha del evento.
     • Incluya %description% para agregar la descripción del evento.
     • Incluya %location% para agregar la ubicación del evento, si la hay.
5. Haga clic en Guardar.

Crear un evento con recordatorio de chat

Ahora que Calendar está vinculado a su cuenta de sistema de chat, puede elegir recibir notificaciones en un chat cuando agregue un recordatorio a un evento:

1. Inicie sesión en Calendar (calendar.infomaniak.com) desde un navegador web como Brave o Firefox.
2. Cree un nuevo evento.
3. Haga clic en la esquina inferior derecha para mostrar los campos adicionales
   
4. Agregue un recordatorio
   
5. En el menú desplegable, elija el Webhook configurado.
6. Haga clic en Guardar para guardar los cambios.

A partir de ahora, recibirá un recordatorio en el chat asociado al Webhook.

Ejemplos para obtener un Webhook

kChat

1. Abra la aplicación kChat.
2. Vaya a la sección de 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 enviará mensajes de recordatorio en kChat en el canal de su elección:
   
6. Guárdelo para obtener la URL del Webhook:
   
7. Configure la notificación personalizada en Calendar (lea arriba si es necesario):
   
8. Seleccione su notificación personalizada al agregar un recordatorio a su evento:
   

Slack

1. Abra esta página de Slack y autentifíquese con sus credenciales de Slack.
2. Elija el canal en el que se mostrarán sus recordatorios (por ejemplo, @slackbot o #general)
   
3. Haga clic en Guardar para obtener la URL del Webhook.

Cree más Webhooks para configurar recordatorios en otros hilos de chat.

Personalizar los mensajes de recordatorio de Slack

Puede utilizar libremente las opciones de formato de Slack en sus notificaciones. Por ejemplo:

No olvide incluir %subject% para el %date%.
Marque el día del evento: %description%.
Lugar del evento: %location%

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

Requisitos previos

• tener permisos suficientes para administrar el producto en cuestión
• invitar a un usuario a unirse a kChat

Ver miembros de un canal

Para ver los usuarios que tienen acceso al canal seleccionado:

1. haga clic en el ícono de persona debajo del título del canal
2. los participantes aparecerán en una columna a la derecha de kChat
   

Invitar o quitar un miembro de un canal privado

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

1. haga clic en el ícono de persona debajo del título del canal
2. los participantes actuales aparecerán en una columna a la derecha de kChat
3. el botón azul Añadir le permite invitar a un usuario de kChat o a un equipo completo de trabajo que aún no tiene acceso a este canal:
   
4. el botón Gestionar le permite quitar a un miembro de este canal o nombrarlo Administrador del canal para que pueda gestionar a los miembros a su vez:
   

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

Añadir 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 sobre el mensaje y selecciona uno de los emojis disponibles o el emoticono con el signo +:

 

Si ya hay reacciones, puedes añadir una en el mismo lugar:

Esto abrirá el panel con cientos de emojis disponibles (e incluso emojis personalizados, lee más abajo).
 

Expresarse con un emoji o GIF

Añadir 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:

 

Luego puedes elegir un emoji:

 

O insertar GIFs animados cortos en lugar de un emoji usando la pestaña en la parte superior del panel que aparece cuando haces clic en el icono de la cara sonriente:

 

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

Consejo: Si agregas #, ## o ### como primer carácter en una nueva línea que contenga un emoji, podrás usar un emoji más grande. Para probarlo, envía un mensaje como '# :smile:' (Nota: tu configuración personalizada puede "desactivar" esta función de visualización en tu interfaz).
 

Para establecer el color por defecto, haz clic en este símbolo en el panel de emojis:
 

Emojis personalizados
 

Para gestionar emojis adicionales, haz clic en este botón en el panel de emojis:

Especifica un nombre de hasta 64 caracteres. Puede contener letras minúsculas, números y los caracteres "-", "+", y "_".

Especifica un archivo .gif, .png o .jpg para tu emoji. El archivo puede tener hasta 1 MB de peso. El tamaño se redimensiona automáticamente a 128 x 128 píxeles manteniendo la proporción.

El emoji luego puede ser utilizado por todos los usuarios de kChat en tu organización basado en el nombre que le asignaste.

Esta guía se refiere a los productos de Infomaniak que integran el uso de inteligencia artificial, incluidos kChat, kDrive, Mail, Site Creator, entre otros.

Responsabilidades de las Partes

Datos Proporcionados a la IA

• La IA de Infomaniak actualmente se basa por defecto en mixtral8x22b
  • GPT4 turbo es una opción opcional para los usuarios de kChat / Mail
  • Los mensajes de audio se transcriben con Whisper
  • Llama 3 está disponible para la API AI Tools
• Cuando se utiliza un asistente de redacción, los mensajes y solicitudes dirigidos a la IA se procesan exclusivamente en Suiza a través de la infraestructura de Infomaniak
• No se procesan ni se comparten datos con terceros

Datos Proporcionados por la IA

• El modelo de lenguaje genera texto basado en los datos que ha asimilado durante su entrenamiento, careciendo de consciencia, intenciones o responsabilidades morales
• Es crucial que el usuario sea consciente de que la información generada por el modelo no siempre es precisa y no debe considerarse una fuente infalible de información
• El usuario debe ejercer juicio crítico y verificar la información proporcionada por el asistente con fuentes confiables cuando sea necesario
  • p.ej., si una persona usa el modelo para tareas cruciales como consejos médicos, legales o financieros, debe tomar precauciones adicionales para confirmar la información del modelo
• En caso de uso inapropiado o peligroso de este asistente, la responsabilidad recae en el usuario que realiza estas acciones

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

Iniciar una conversación

Para enviar un mensaje a un usuario de su organización, haga clic en el + a la derecha de Mensajes directos para seleccionarlo:

Envíe su mensaje; si es necesario, adjunte archivos de hasta 100 MB. También puede usar “reacciones”.

Mencionar a otro usuario

Para mencionar a un miembro de la organización (o a todo un equipo de trabajo) a través de un mensaje, escriba el símbolo @ @ para mostrar las personas o los canales que se pueden mencionar. Tenga en cuenta que, según el tipo de canal, mencionar a un usuario mostrará un mensaje que le permitirá añadirlo a la conversación; de lo contrario, no verá la mención.

Solicitar acuse de recibo

Para permitir que los usuarios confirmen la recepción de su mensaje y así indicar que han leído el mensaje, active un acuse de recibo antes de enviar el mensaje en el canal, haciendo clic en el icono ⦅!⦆ y luego activando el botón de alternancia:

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

 

Editar o eliminar un mensaje

Para editar un mensaje (que tendrá una nota de mensaje editado), haga clic en el menú de acciones a la derecha del mensaje que desea 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 gestiona en el lado izquierdo de la pantalla es muy importante.

Imagine 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, es posible que desee encontrar información leída entre ellas, así que un orden por actividad reciente (lea a continuación para más opciones) permite encontrar las últimas conversaciones que le concernían. 

Esta opción de tipo de ordenació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, aparecerán en el lado derecho de la ventana.

Hilo de discusión

En cualquier canal o chat privado con otro usuario, puede iniciar un hilo de discusión a partir de otro mensaje simplemente seleccionando Responder en el mensaje deseado.

Se abrirá un hilo de discusión a su derecha, permitiendo que cada usuario del canal contribuya a este hilo específico sin perturbar 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 de Hilos de discusión en 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 equipos de manera segura desde su navegador web, móvil, tableta o computadora.

Obtener kChat

kChat está disponible con kSuite.

Una vez que haya configurado kSuite en su organización:

• Descargue la aplicación kChat para macOS / Windows / Linux o la aplicación móvil para iOS / Android

y/o

• Utilice kChat en línea en un navegador reciente, iniciando sesión en su cuenta de usuario en kchat.infomaniak.com o https://su-organización.kchat.infomaniak.com/

Lea la Guía de inicio (haga clic aquí).

Infomaniak es una empresa suiza certificada ISO 27001 e ISO 9001 que cumple con el RGPD. Nuestro principal objetivo es garantizar la seguridad y confidencialidad de los datos que nos confían. Existen muchas medidas para garantizar la protección de sus comunicaciones con kChat:

• Infomaniak Manager te permite comprobar si los usuarios de tu organización han activado la autenticación de dos factores
• los datos retenidos y en tránsito están encriptados, al igual que las copias de seguridad realizadas automáticamente por Infomaniak
• los datos están alojados en Suiza en centros de datos desarrollados y gestionados exclusivamente por Infomaniak

• solo recibes mensajes de tus colaboradores o usuarios externos que hayas aprobado
• puede crear canales privados para restringir la información confidencial a personas específicas
• usted controla permanentemente los derechos de acceso de los usuarios que pueden acceder a kChat

Esta guía detalla el uso y gestión de los canales en kChat.

Un canal de kChat es un espacio de comunicación dedicado a un proyecto, tema o equipo donde los miembros pueden intercambiar documentos, chatear en tiempo real y organizar videoconferencias.

Canal General

Cada organización en kChat tiene automáticamente un canal General en el que todos los usuarios están automáticamente invitados.

Puede usar este canal para compartir información relevante para toda su organización, como salidas de la empresa o buenas noticias motivacionales.

Por supuesto, puede iniciar un nuevo hilo de conversación dentro del canal General.

Canal adicional

Para agregar un nuevo canal de discusión:

1. Haga clic en el botón ‍ en la barra lateral izquierda de kChat
2. Haga clic en Crear un nuevo canal
   

Información del canal

Cuando crea un nuevo canal, puede elegir:

 

1. Su nombre

Se podrá modificar posteriormente.

2. Su URL

Por defecto toma el nombre del canal, pero puede cambiarlo utilizando letras minúsculas, números, puntos, guiones y guiones bajos - también modificable posteriormente.

3. Su estado Privado o Público

Se podrá modificar posteriormente (leer más abajo).

4. Su descripción

La descripción explica cómo se debe usar este canal. Este texto aparece en la lista de canales en el menú "Más..." y proporciona una guía a los usuarios sobre si deben unirse al canal.

Una vez creado el canal, también puede configurar:

5. Un encabezado

Diferencias entre canales Privados y Públicos

Los canales Públicos aumentan la transparencia. Todos los usuarios pueden ver y unirse a un canal público, lo que asegura que todas las personas interesadas en un proyecto, tema o equipo tengan acceso a la misma información.

Los canales Privados le permiten restringir el contenido sensible a usuarios seleccionados. Solo un miembro existente puede invitar a otro usuario a un canal privado. También hay diferencias en la gestión de archivado/eliminación (leer más abajo).

Convertir un canal público en un canal privado

Para transformar un canal Público en un canal Privado:

1. Haga clic en el canal Público en la barra lateral izquierda
2. Luego haga clic en el título del canal en la parte superior del chat
3. Seleccione Convertir
   

El historial y la membresía se conservan; los archivos compartidos públicamente siguen siendo accesibles para cualquier persona con el enlace; el cambio es permanente y no se puede deshacer.

¿Y al revés?

Lo contrario (cambiar un canal privado a un canal público) también es posible, pero solo un administrador de kChat puede hacerlo; el historial de mensajes se conserva.

Dejar un canal

Excepto el canal principal titulado General, puede dejar un canal en cualquier momento:

1. Haga clic en el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda)
2. Haga clic en Dejar el canal
   
    

Si deja un canal privado, ya no lo encontrará en la búsqueda, solo a través de su URL si la tiene o siendo reinvitado por un miembro del canal.

Si deja un canal público, lo dejará inmediatamente pero podrá unirse a él cuando desee simplemente encontrándolo por su nombre en la búsqueda, incluso si ha sido archivado.

 

Archivar/eliminar un canal

Excepto el canal principal titulado General, puede archivar un canal en cualquier momento, lo que impide nuevos mensajes y ya no lo cuenta en su cuota de canales disponibles:

1. Haga clic en el canal en la barra lateral izquierda
2. Luego haga clic en el título del canal en la parte superior del chat
3. Haga clic en Archivar el canal
   

Si crea un canal y luego lo archiva, puede unirse a él cuando desee simplemente encontrándolo por su nombre en la búsqueda: 

Luego puede desarchivarlo:

o cerrarlo para no verlo más en su interfaz:

Favoritos

Para marcar como favorito cualquier canal, simplemente haga lo siguiente:

1. Haga clic en la estrella en la parte superior de un canal
2. Un nuevo menú Favoritos aparecerá en la barra lateral izquierda, agrupando todos los elementos que haya marcado como favoritos (válido solo para su usuario)
   

Silenciar un canal

Puede ocultar las notificaciones de un canal:

1. Haga clic en el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda)
2. Seleccione Silenciar
   
   
   
    

Organizar por categorías

Haciendo clic en el botón + en la barra lateral izquierda de kChat, puede agregar una o más categorías que le permitirán colocar elementos (canal, contacto, etc.) dentro de ellas. Luego, arrastre el canal deseado a la categoría creada (válido solo para su usuario):

Canal de chat de usuario a usuario

Los mensajes personales son conversaciones directas entre dos o más personas que tienen lugar fuera de los canales.

Cada usuario de una organización puede crear libremente mensajes personales cuyo contenido será visible solo para las personas involucradas.