Esta guía se refiere a la instalación de kChat, la solución de mensajería instantánea de kSuite. 

Obtener kChat

kChat está disponible con kSuite, con capacidades adaptadas a cada versión.

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

• Acceda a la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat)
• … o haga clic aquí para descargar la aplicación móvil (aplicación para smartphone o tableta iOS / Android) y la aplicación de escritorio (aplicación de escritorio en macOS / Windows / Linux).

Consulte también la guía de inicio.

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 tenga acceso en kChat, simplemente pase el ratón sobre el mensaje y seleccione…

• ya sea el emoticono de la selección
• o sobre el emoticono con el pequeño +:
  
• Si ya hay reacciones (mostradas debajo de los mensajes), puede agregar una en el mismo lugar:
  
   

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

Expresarse con un emoticono o un GIF

Agregar un emoji dentro del mensaje que está redactando es muy sencillo:

• Solo tiene que hacer clic en el icono de la cara sonriente en la barra de formato de su mensaje:
  
• Puede elegir un emoji o insertar cortos GIF animados en lugar de un emoticono gracias a la pestaña situada en la parte superior del recuadro que se muestra cuando hace clic en la cara sonriente:
  
   
• Si conoce el nombre del símbolo a insertar, también puede escribir : (dos puntos) seguido de al menos los dos primeros caracteres:
  

Consejo: si agrega #, ## o ### como primer carácter de una nueva línea que contiene un emoticono, podrá usar un emoticono más grande. Para probar, envíe un mensaje como  '# :smile:' (tenga en cuenta que sus configuraciones personalizadas pueden "desactivar" esta funcionalidad de visualización en su interfaz).

Para definir el tono de los emojis humanos por defecto, haga clic en este símbolo del panel de emojis:

Emoticonos personalizados

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

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

Especifique un archivo .gif, .png o .jpg para su emoticono. 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 emoticono podrá ser utilizado posteriormente por todos los usuarios de kChat de su Organización gracias al nombre único que le ha asignado:

Esta guía explica cómo insertar texto enriquecido e imágenes dentro de sus mensajes en kChat.

Formatear el texto del mensaje (markdown)

Aquí están los símbolos que debe agregar antes y después de su texto para formatearlo en el estilo deseado:

ligne de code

También puede insertar esto:

Insertar una imagen en el mensaje…

… a partir de una URL

Inserta el siguiente código en tu mensaje reemplazando el texto alternativo y la dirección (URL) de la imagen por el enlace de la imagen (esta última debe ser accesible y visible en la web):

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

Ejemplo

Mensaje con la sintaxis de inserción de imagen:

y si la URL de la imagen está en el portapapeles, basta con pegar el enlace en una conversación y la imagen se agregará a tu mensaje.

… a partir del disco duro o de kDrive

Haga clic en el ícono del clip para insertar una imagen existente en su disco duro o en kDrive:

La imagen se insertará en el mensaje que puede enviar directamente en la conversación sin necesariamente agregar texto adicional.

Esta guía explica cómo invitar a kChat a un usuario aún externo a su Organización, pero que será contabilizado como un usuario de my kSuite.

Preámbulo

• Tome conocimiento de esta otra guía para dar acceso a uno o varios canales de kChat a un usuario externo que así podrá interactuar con su equipo sin contar como un usuario de my kSuite y sin tener derechos particulares en la Organización (de la cual no formará parte).
• También puede invitar a un equipo de trabajo completo desde kChat.
• Tome conocimiento de esta otra guía si desea gestionar los canales a los que deberán pertenecer automáticamente los nuevos miembros.

Invitar a usar my kSuite

Requisitos previos

•  Ser administrador de la Organización en la que se encuentra my kSuite con derechos completos otorgados para kChat.
   

Una vez invitado, el usuario podrá confirmar su adhesión y accederá a kChat con los permisos limitados que le haya otorgado:

1. Haga clic aquí para acceder a la gestión de kChat en el Administrador de Infomaniak (¿necesita ayuda?).
2. Haga clic en Agregar un usuario:
   
3. Haga clic en Crear un usuario de my kSuite.
4. Haga clic en Siguiente:
   
5. Ingrese el nombre y apellido del usuario, y defina su rol como usuario simple:
   • Representante legal
     • Responsabilidad legal de la organización
     • Puede gestionar todos los productos y usuarios
     • Puede gestionar la contabilidad y las órdenes de nuevos productos
   • Administrador
     • Puede gestionar todos los productos y usuarios
     • Puede gestionar la contabilidad y las órdenes de nuevos productos
   • Usuario​
     • Puede gestionar los productos que autorice​
     • Puede gestionar la contabilidad si lo autoriza​
6. No cree una dirección de correo electrónico para el usuario e indique su dirección de correo electrónico existente a la que enviar la invitación:
   • Puede obligar a este futuro usuario a conectarse con esta dirección de correo electrónico o autorizarle a especificar otra dirección de correo electrónico (útil, en particular, si ya tiene una cuenta de usuario con Infomaniak con otro identificador de conexión).
   • Agregar el usuario a su my kSuite con el botón de alternancia (toggle switch).
7. Haga clic en el botón Invitar:
   
   • La invitación está en espera hasta el registro definitivo del usuario invitado (leer más abajo). La tabla de control de usuarios de la Organización indica bien este estado:
     

Aceptar la invitación

Para acceder a la Organización que tiene kChat:

1. El usuario invitado recibe la invitación en su dirección de correo electrónico y hace clic en el botón Aceptar la invitación:
   
2. Especifica sus datos así como la dirección de correo electrónico / contraseña que desea usar y termina el registro:
   
3. Una vez completado el registro, el nuevo usuario puede conectarse a su Manager y acceder a kChat al que ha sido invitado.
4. Los usuarios existentes son notificados automáticamente de la llegada del nuevo participante y pueden conversar con él; tan pronto como se añade, el nuevo usuario recibe un mensaje de Euria (Bot IA de Infomaniak) dándole la bienvenida:
   

Acceso a kSuite, ¡pero no acceso a la gestión de kSuite!

Es importante diferenciar el uso de la aplicación kChat (dentro de kSuite) y la gestión de kSuite en sí.

En el ejemplo de invitación anterior, el nuevo usuario ha sido invitado a unirse a kChat, por lo tanto, ahora cuenta como un usuario de la kSuite cuando un administrador accede a la gestión de usuarios de kChat:

Lo mismo, obviamente, en la gestión de usuarios de kSuite:

Sin embargo, este nuevo usuario no podrá gestionar directamente la kSuite a la que ha sido invitado, ya que su rol (definido en el primer punto 5 anterior) no le autoriza a hacerlo:

1. Por esta razón, este usuario no verá ningún enlace activo en la sección Herramientas Colaborativas → kSuite de su Manager Infomaniak.
2. Deberá cambiar a las aplicaciones Infomaniak a través del menú ‍ en la esquina superior derecha:
   

Tenga en cuenta que, si lo desea, este usuario podrá comprar su propia kSuite sin relación con la kSuite a la que ha sido invitado.

Esta guía detalla los elementos importantes para no perderse ninguna discusión kChat que le concierne.

Prólogo

• Si las notificaciones están correctamente configuradas para funcionar en la app móvil kChat, también funcionarán en los relojes inteligentes (smartwatch) tipo Garmin o Apple Watch.

Administrar las notificaciones del icono de la app de escritorio

Por ejemplo, puede decidir animar el icono de la app de escritorio cuando haya un nuevo mensaje:

1. Abra la app de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic izquierdo en el icono de la app de escritorio en la zona de notificaciones de su ordenador (arriba a la derecha en macOS, abajo a la derecha en Windows y un doble clic izquierdo en la barra de tareas en Linux).
3. Haga clic en Preferencias...
4. En Opciones de la aplicación, ajuste las preferencias de notificación del sistema operativo:
   

Administrar las notificaciones de las discusiones y eventos

Para administrar las notificaciones de kChat, y así ser notificado, por ejemplo, cuando se le envía un nuevo mensaje directamente o cuando sigue un mensaje específico, incluso según ciertas palabras clave:

1. Haga clic aquí‍ para acceder a la app Web kChat (servicio en línea ksuite.infomaniak.com/kchat) o abra la app móvil kChat (aplicación para smartphone o tableta iOS / Android) o incluso la app de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el icono Configuración ‍ en la parte superior derecha de la interfaz.
3. Haga clic en Notificaciones.
4. Defina la manera de ser notificado (ordenador/móvil, presente/ausente, etc.) y en qué caso (todo mensaje o solo mensaje con mención, mensaje seguido, etc.).
5. Elija recibir regularmente notificaciones por correo electrónico:
   • Este correo electrónico se envía todos los días o 1 vez por semana, entre las 6 y las 8 de la mañana y le indica al usuario los mensajes que no habría leído.
   • El usuario recibe un correo electrónico por producto kChat al que tiene acceso.
6. Defina una palabra clave para ser notificado cuando se publique un nuevo mensaje:
   

Administrar las notificaciones de un canal específico

En el canal de discusión correspondiente:

1. Haga clic en la flecha ‍ a la derecha del nombre del canal correspondiente.
2. Haga clic en Preferencias de notificación (o directamente en el icono dedicado en la parte superior del canal):
   
3. Navegue y active las diferentes notificaciones deseadas.
4. Una de las opciones propuestas permite ser notificado automáticamente tan pronto como un hilo de discusión (thread) se compromete después de un mensaje publicado en el canal correspondiente.
5. Guarde sus elecciones haciendo clic en el botón en la parte inferior:
   

Administrar las notificaciones de una discusión específica

Para ser notificado de un nuevo mensaje en un hilo de discusión (thread) específico, incluso si no es un participante directo, debe activar el Seguimiento:

• ya sea pasando el cursor sobre el menú de acción ••• a la derecha de un usuario en una discusión:
  1. y haciendo clic en Más…:
     
  2. luego Seguir el mensaje:
     
• o en un hilo de discusión (respuesta a un mensaje):
  1. haga clic en Seguir en la parte superior de la discusión (automáticamente sigue la discusión a partir del momento en que publica un mensaje, y luego podrá Dejar de seguir los intercambios de este hilo de discusión): 
     

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

Traducir el texto al leerlo

Para traducir automáticamente a su idioma un mensaje recibido redactado en un idioma extranjero:

1. Haga clic aquí para acceder a la aplicación web kChat de Infomaniak (servicio en línea ksuite.infomaniak.com/kchat) o abra la aplicación móvil (aplicación para smartphone o tableta iOS / Android) o la aplicación 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 ••• situado en la parte superior derecha del elemento en cuestión.
4. Haga clic en Traducir:
   
5. El mensaje traducido se muestra después del último mensaje de su conversación y solo es visible para usted:
   

Traducir el texto con Euria al redactarlo

Puede pedirle a Euria que traduzca el texto que está redactando:

1. Haga clic en el icono de Euria.
2. Indique sus instrucciones:
   
3. El texto se mostrará entonces en el idioma deseado y podrá enviarlo así:
   

Esta guía explica cómo obtener automáticamente cada mañana en su bandeja de entrada de Mail y/o kChat el resumen de sus actividades inscritas en Calendar de Infomaniak.

Prólogo

• Esta funcionalidad está desactivada por defecto en todos los calendarios.
• Este resumen se envía a su dirección de correo electrónico (aquella que se utiliza para la conexión a su cuenta Infomaniak).
• Contiene la lista de todos los eventos del día con la información más importante (enlace kMeet eventual, ubicación, horarios, etc.).
  • Incluso puede imaginar transmitir este horario diario a su equipo o a su asistente para que sepan en qué momento es preferible contactarlo, incluso haciendo una regla de transmisión automática basada en los criterios correspondientes al correo electrónico recibido.

Obtener un horario de manera automática y diaria

Requisitos previos

• El envío de un resumen en kChat requiere poseer kChat dentro de su Organización.

Para comenzar el día consultando un mensaje en su bandeja de entrada de Infomaniak que contiene el horario basado en su agenda de Infomaniak:

1. Haga clic aquí para conectarse a los parámetros unificados de sus aplicaciones web de Infomaniak y, más específicamente, a los ajustes del recordatorio diario de la aplicación Calendar.
2. Verifique o seleccione la Organización correspondiente en el menú desplegable del menú lateral izquierdo.
   1. Si la modifica, vuelva a los ajustes haciendo clic en el elemento de recordatorio diario para acceder a los ajustes:
      
3. Haga clic en el botón para agregar un recordatorio diario y configurarlo:
   

Para personalizar su recordatorio según sus necesidades:

1. Seleccione el calendario correspondiente.
2. Elija el modo de recepción (Mail, kChat o ambos).
3. Elija el momento en el que desea recibir el recordatorio (la noche anterior o temprano el mismo día).
4. Elija incluir o no los eventos recurrentes.
5. Elija los días durante los cuales se enviará el recordatorio diario.
6. Valide sus elecciones al final de la página:
   

Desactivar el recordatorio diario

Para detener el envío del resumen diario por correo electrónico o por Euria en kChat:

1. Haga clic en el enlace ubicado al final de la notificación recibida:
   
2. Haga clic en el recordatorio a eliminar:
   
3. Elimine el recordatorio desde la página de edición:
   

Esta guía explica cómo obtener una notificación que le permita revisar un mensaje kChat específico a una hora determinada/personalizable (según las ofertas, lea a continuación) por intervalos de 30 minutos.

⚠ Disponible con:

* sin personalización del horario

Recordar un mensaje kChat a una hora fija

Para revisar un mensaje mediante una notificación en el futuro:

1. Pase el ratón sobre el mensaje que desea recordar y seleccione el icono de acciones adicionales ••• en la esquina superior derecha.
2. Haga clic en Recordatorio.
3. Elija el momento deseado para ser notificado:
   
4. Una notificación en el canal (visible solo para usted) indica el próximo recordatorio del mensaje:
   
5. Recibirá en el momento elegido una notificación del canal Euria en el menú lateral izquierdo, que le llevará al recordatorio que contiene una cita del mensaje, así como la información necesaria para consultar el mensaje, programar un recordatorio más tarde, cancelar los posibles otros recordatorios, etc.
    

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 su Organización, haga clic en su nombre en la lista de miembros a la izquierda de su interfaz kChat:

También puede hacer clic en el + a la derecha de los 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 usar "reacciones".

Envío diferido: programar un mensaje

✘ NO DISPONIBLE✘ con
my kSuite / my kSuite+ (ik.me, etik.com, ikmail.com)

kSuite gratuito no permite la personalización del horario al programar.

Para programar un envío a 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 el mensaje debe ser enviado:

En la aplicación móvil kChat (aplicación para smartphone o tableta iOS / Android), debe presionar algunos segundos el botón de envío, y un menú para programar el mensaje se mostrará.

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 lectura

Para que los usuarios puedan acusar recibo de su mensaje y así indicar que han leído el mensaje, active un acuse de lectura antes de enviar el mensaje en el canal, haciendo clic en el ícono (!) y luego activando el botón de alternancia (toggle switch):

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

Editar / eliminar un mensaje, o fijarlo

Para editar un mensaje (que entonces tendrá 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á entonces de la discusión en todos los usuarios:

Una indicación sobre la eliminación aparecerá en todos los otros usuarios del canal en el lugar inicial del mensaje.

En el mismo lugar, puede fijar un mensaje:

• Los mensajes fijados son visibles para todos los miembros del canal, ya sea público o privado.
• Los mensajes fijados en un canal privado solo son accesibles para los miembros de ese canal.
• Puede consultar la lista de todos los mensajes fijados a través de la opción « Mensajes fijados » del canal.
• Para quitar un mensaje fijado, vuelva a pasar el ratón sobre él y seleccione « Desfijar ».

Organizar las conversaciones en kChat

El tipo de clasificació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, tal vez desee encontrar una información leída entre ellas, por lo que una clasificación por actividad reciente, por ejemplo (consulte a continuación para otras posibilidades), le permite encontrar las últimas conversaciones que le 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 en el lado derecho de la ventana:

Hilo de discusión (thread)

1. Independientemente del canal o del chat privado con otro usuario, puede iniciar un hilo de discusión a partir de otro simplemente eligiendo Responder en el mensaje deseado.
2. Un hilo de discusión se abrirá en un panel lateral derecho, permitiendo a cada usuario del canal aportar sus comentarios en este hilo específico sin perturbar los posibles nuevos temas del canal en curso (este hilo puede ser entonces seguido o ignorado para no recibir más notificaciones cuando haya un nuevo mensaje — el seguimiento se gestiona en la parte superior del panel lateral).
3. 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 detalla la gestión de los miembros de su servicio de chat kChat.

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 aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat) o abra la aplicación de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el icono de personaje a la derecha del título del canal o vaya al menú Miembros.
3. Los participantes se muestran a la derecha de kChat:
   

Invitar o eliminar un miembro de un canal privado

Cuando haya abierto el panel de miembros de un canal:

1. Los participantes actuales se muestran a la derecha de kChat.
2. El botón Gestionar permite eliminar a un miembro de este canal o nombrarlo Administrador del canal para que, a su vez, pueda gestionar los miembros:
   
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:
   
   • Consulte esta otra guía sobre los agregados de invitados, los miembros que no utilizarán una licencia my kSuite para chatear con usted en kChat.

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

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 esta aplicación si ha ocurrido algo nuevo ("polling").
  • 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.
• No es posible importar el historial de conversaciones desde otra aplicación (Slack, Teams, Jabber, etc.) o desde otra Organización.

⚠ Número máximo de Webhook entrante/saliente:

Acceder a la interfaz webhooks kChat

Requisitos previos

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

Para configurar un webhook, encontrar aplicaciones e integraciones auto-hospedadas o de terceros:

1. Haga clic aquí‍‍ para acceder a la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat) o abra la aplicación 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. Acceda a las categorías:
   

Guías específicas

Ejemplos de integración en kChat:

• Calendar Infomaniak: mostrar un recordatorio de evento en kChat
• aplicación n8n: disparar el envío de un mensaje en kChat

Guías para cualquier otro uso

Para crear un webhook entrante (para mostrar un evento externo en kChat):

1. Haga clic en la categoría Webhooks entrantes.
2. Haga clic en el botón azul Agregar webhooks entrantes:
   
3. Agregue un nombre y una descripción para el webhook.
4. Seleccione el canal que recibirá los mensajes.
5. Haga clic en el botón para Guardar:
   
6. La URL a conservar para sus desarrollos se muestra (no divulgar públicamente); ejemplo “https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx”:
   

Uso del webhook

Ejemplo rápido

1. Se ingresa un comando curl específico (detallado más abajo) en un terminal.
2. El comando contiene la URL obtenida en el punto 6 anterior.
3. El comando tendrá como resultado publicar un mensaje en el canal especificado en el punto 4 anterior:
   

Detalles

En la aplicación que debe publicar en kChat:

1. Ajuste el código a continuación según la URL obtenida en 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. Utilice eventualmente 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) como en el ejemplo de imagen anterior: 

   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hello, text1\nText2."}' https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx

Si no se define ninguna cabecera Content-Type, el cuerpo de la solicitud debe ir precedido de payload= de la siguiente manera:

payload={"text": "Hello, text1\nText2."}

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

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

Parámetros

Además del campo text, a continuación se muestra la lista completa de los parámetros admitidos:

Ejemplo de código con parámetros

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

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

Resultado de un ejemplo similar en imagen:

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

Prólogo

• Multiplataforma, kChat es el mensajería instantánea de my kSuite que permite intercambiar, compartir y coordinar a sus equipos de manera segura desde…
  • … su navegador web
  • … su dispositivo iOS / Android
  • … 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.
  • El tamaño de almacenamiento es el de my kSuite.

¿Qué desea hacer?

• Configurar kChat
• Gestionar usuarios
• Gestionar un canal
• Gestionar una conversación
• Reaccionar a los mensajes
• Gestionar las notificaciones de kChat
• Formatear 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 problemas, consulte la base de conocimientos antes de contactar al soporte.
• Haga clic aquí para compartir una opinión o sugerencia sobre un producto Infomaniak.

Esta guía se refiere a los mensajes que comienzan con / en kChat interpretados como comandos slash.

Ejecutar un comando slash en kChat

Para acceder a los comandos slash en kChat:

1. Haga clic en el campo de redacción dentro de un canal.
2. Ingrese un signo / (slash o barra inclinada) y el comando adjunto.
3. Valide para enviar el comando.

Si solo escribe el signo / aparece un modal con los comandos que se pueden ejecutar, como ponerse fuera de línea, por ejemplo.

Aquí hay una tabla de los comandos principales:

Crear un comando slash personalizado

Requisitos previos

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

Para crear un comando slash personalizado:

1. Haga clic aquí‍ para acceder a la aplicación Web kChat (servicio en línea kchat.infomaniak.com) o abra la aplicación 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. Haga clic en Comando barra:
   
5. Haga clic en el botón azul para Agregar un comando:
   
6. Configure el comando barra (nombre, desencadenante (sin el /), tipo de contenido esperado, acción a ejecutar*, etc., incluyendo si el comando debe mostrarse en la ventana emergente de ayuda de la que habla el capítulo anterior).
   • * Esto puede incluir la llamada a una API externa, la ejecución de un script, la visualización de una respuesta específica, etc. Para ello, generalmente necesitará un script o una aplicación externa que responda a los comandos. También puede definir parámetros adicionales para el comando, como opciones desplegables, casillas de verificación, etc., según sus necesidades.
7. Guarde el comando.
8. Asegúrese de probar el comando para asegurarse de que funcione como se espera.

Esta guía explica cómo obtener recordatorios de eventos de la aplicación web Calendar de Infomaniak (servicio en línea ksuite.infomaniak.com/calendar) en un sistema de chat como kChat para ser notificado en el canal de chat de su elección cuando un evento se acerca.

⚠ Disponible con:

* limitado a 1 webhook

Requisitos previos

• Crear en la aplicación kChat un webhook entrante, para obtener una URL del tipo https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx:
  

Vincular el webhook de kChat a Calendar

Para agregar el webhook de su sistema de chat en la aplicación Calendar:

1. Haga clic aquí para acceder a la aplicación web Calendar de Infomaniak (servicio en línea ksuite.infomaniak.com/calendar).
2. Haga clic en el icono Configuración ​ en la parte superior derecha.
3. Haga clic en Integraciones en el menú lateral izquierdo.
4. Haga clic en el botón Agregar un webhook:
   
5. Defina:
   
   1. Un nombre para identificar fácilmente el Webhook cuando agregue recordatorios.
   2. La URL del webhook (obtenida de su sistema de chat).
   3. Los elementos (tomados automáticamente de su evento y/o agregados 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 ubicación del evento.
6. Haga clic en el botón para Agregar el elemento configurado y verlo creado:
   

Cree un evento con recordatorio por chat

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

1. Haga clic aquí para acceder a la aplicación web Calendar de Infomaniak (servicio en línea ksuite.infomaniak.com/calendar).
2. Haga clic en el botón Crear en la esquina superior izquierda.
3. Haga clic en Evento:
   
   1. También podría hacer clic en un evento existente en el calendario para modificarlo.
4. Ingrese los detalles del evento.
5. Muestra los campos adicionales:
   
6. Haga clic en Agregar un recordatorio para configurarlo:
   
7. En el menú desplegable de tipos de recordatorio, seleccione el webhook configurado (según el nombre dado en el punto 5a anterior).
8. Guarde el evento al final de la página:
   
9. Cuando llegue el momento del recordatorio, se envía un mensaje (en el formato configurado en el punto 5c anterior) en kChat sobre el evento, en el canal configurado en el webhook de kChat (consulte requisitos previos anteriores):
   

¿Y en otros sistemas de chat?

Slack

1. Haga clic aquí para acceder a los WebHooks de Slack.
2. Seleccione el hilo de conversación en el que se mostrarán sus recordatorios (por ejemplo, @slackbot o #general):
   
3. Guarde para obtener la URL del webhook.

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

Puede usar 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 explica cómo configurar una acción en n8n para que se envíe un mensaje a kChat cuando se cumplan las condiciones.

Requisitos previos

• Instalar n8n en un alojamiento de Infomaniak.
• Crear un webhook en la aplicación kChat de Infomaniak.

Crear la acción en n8n

En su sesión de n8n:

1. Haga clic para comenzar desde cero:
   
2. Haga clic para agregar una primera acción.
3. Elija un disparador manual:
   
4. Haga clic para agregar una acción a disparar.
5. Busque y active una acción de tipo “Solicitud HTTP”:
   
6. Elija el método POST.
7. Ingrese la URL de su webhook kChat.
8. La autenticación no es necesaria (ya aplicada en la URL).
9. Active el botón de alternancia (toggle switch) “Enviar cuerpo” para poder especificar un contenido:
   
10. En el campo “Nombre” ingrese el término exacto “texto” como se espera en kChat.
11. En el campo “Valor” ingrese las indicaciones que desea mostrar en kChat.
12. Haga clic en el botón para probar y aplicar su comando manual:
    
13. El mensaje especificado en n8n se muestra entonces en kChat:
    

Ahora que esta base funciona, podría imaginar reemplazar el texto fijo por datos provenientes de otro lugar. Por ejemplo, agregue un nodo “Imap” o “RSS Feed” antes del nodo Solicitud HTTP. Así, en lugar de escribir el texto a mano, haga clic en el pequeño engranaje junto a Valor > Expresión para decir: “Enviar a kChat el título del último correo electrónico recibido”…

Esta guía le permite descubrir rápidamente las funciones esenciales de Euria, la inteligencia artificial a su disposición dentro de kSuite, especialmente eficiente para resumir discusiones en la aplicación kChat.

Prólogo

• Euria puede ayudarle a realizar todo tipo de cálculos, traducciones, proporcionar indicaciones sobre diferentes temas y respuestas a sus preguntas.
• Tome conocimiento de esta otra guía sobre el modelo utilizado y las responsabilidades de cada uno.
• Tan pronto como se agregue un nuevo usuario, este último recibe un mensaje de Euria dándole la bienvenida.
• Tome conocimiento de esta otra guía sobre las posibilidades de discusión con la IA en kChat.

Resumir automáticamente un mensaje de kChat

Para obtener el resumen de un mensaje de kChat:

1. Pase el ratón sobre el mensaje y seleccione el icono de las acciones de Euria en la esquina superior derecha.
2. Haga clic en Resumir el hilo de discusión:
   ‍
3. Obtenga el resumen, generado por Euria en el panel lateral derecho:
   

Esta guía explica cómo responder a un correo electrónico visible en la aplicación web Mail Infomaniak (servicio en línea ksuite.infomaniak.com/mail) enviando la respuesta directamente en la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat) o la aplicación desktop, en forma de mensaje privado al remitente del correo electrónico.

Prólogo

• Esta funcionalidad permite responder a un correo electrónico directamente en kChat, con un recordatorio del mensaje original para facilitar la comprensión.
• Su objetivo es agilizar la colaboración permitiendo reaccionar rápidamente a un correo electrónico sin salir del entorno my kSuite.
• Reduce los viajes de ida y vuelta entre el correo electrónico clásico y el espacio de trabajo colaborativo.

Enviar una respuesta a un correo electrónico a través de kChat

Requisitos previos

• El botón que da acceso a la funcionalidad solo se mostrará en el caso de un correo electrónico recibido de un remitente vinculado a la my kSuite, y esto en la misma Organización que el usuario que desea responder.
• Para mostrar un acceso directo a esta funcionalidad como en el primer punto 3 a continuación, consulte esta otra guía.

Cuando haya recibido un correo electrónico de un colaborador y desee responderle directamente en kChat:

1. Haga clic aquí para acceder a la aplicación web Mail Infomaniak (servicio en línea ksuite.infomaniak.com/mail).
2. Abra el mensaje al que responder por kChat.
3. Haga clic en el icono kChat en la barra de herramientas del correo electrónico:
   
   • También es posible hacer clic en un botón debajo del mensaje:
     
4. Redacte su mensaje kChat, fórmelo si es necesario y haga clic en el botón Enviar en la parte inferior derecha:
   
5. Su interlocutor recibe el mensaje en kChat acompañado de un recuadro que representa el correo electrónico original (fecha y hora, asunto):
   

Puede acceder a este mensaje en kChat (en el hilo de los mensajes privados intercambiados con su interlocutor como arriba) pero también:

1. en una banda de información sobre la conversación de correo electrónico,
2. en el mensaje de confirmación de envío:
   

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

Preámbulo

• Un canal kChat es un espacio de comunicación dedicado a un proyecto, un tema o un equipo en el que los miembros pueden intercambiar documentos, escribir en directo y organizar videoconferencias.
• Los canales privados (y públicos, así como los invitados) están limitados en número según la oferta kSuite adquirida; consulte la tabla comparativa en la página de venta para obtener más información.

⚠ Histórico conservado visible (en días):

Canal General

Cada Organización en kChat posee automáticamente un canal General en el que todos los usuarios son invitados automáticamente:

Puede utilizar este canal para compartir información que afecta a toda su organización, como las salidas de empresa o buenas noticias motivadoras.

Por supuesto, puede iniciar una nueva conversación dentro del canal General.

Canal adicional

Para agregar un nuevo canal de discusión:

1. Haga clic en el botón Nuevo situado en la barra lateral izquierda de la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat).
2. Haga clic en Crear un nuevo canal.
3. También puede hacer clic en Agregar canales debajo de la lista de canales:
   

Información relativa a un canal

Cuando crea un nuevo canal, puede elegir:

A. su nombre

Será modificable más adelante.

B. su URL

Por defecto, toma el nombre del canal, pero puede modificarlo utilizando letras minúsculas, números, puntos, guiones y guiones bajos - también modificable más adelante.

C. su estado PRIVADO o PÚBLICO

Será modificable más adelante (leer más abajo).

D. su descripción

La descripción permite especificar cómo debe utilizarse este canal. Este texto aparece en la lista de canales en el menú «Más...» y proporciona una indicación a los usuarios sobre si deben unirse al canal o no.

Una vez creado el canal, aún puede definir:

E. un encabezado

y puede hacer clic en Información (F)…

… para encontrar la información y poder editar algunas:

Diferencias entre canal PRIVADO o PÚBLICO

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

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

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

Convertir un canal público en canal privado

Para convertir un canal PÚBLICO en canal PRIVADO:

1. Haga clic en la flecha en el título del canal en la parte superior de la discusión en el canal PÚBLICO.
2. Haga clic en la configuración del canal.
3. Elige Convertir:
   

El historial y la pertenencia de los miembros se conservan; los archivos compartidos públicamente siguen siendo accesibles para cualquier persona que disponga del 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 usuario de tipo administrador de kChat podrá hacerlo; el historial de mensajes y los miembros que ya tienen acceso al canal se conservarán; el canal será accesible para todos los usuarios de los otros canales públicos de la Organización, excepto los usuarios externos, que deberán ser invitados manualmente:

1. Haga clic en la flecha ‍ en el título del canal en la parte superior de la discusión en el canal Privado.
2. Haga clic en la configuración del canal.
3. Elige Convertir:
   

También puede realizar la conversión desde la gestión de kChat en el Manager:

1. Haga clic aquí para acceder a la gestión de su kChat en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic en el menú desplegable para mostrar los canales privados.
3. Haga clic en el menú de acción ⋮ situado a la derecha del elemento correspondiente.
4. Haga clic en Convertir a canal público:
   

Salir de un canal

Además del canal principal titulado General, puede salir de un canal en cualquier momento:

1. Haga clic en la flecha ‍ en el título del canal en la parte superior de la discusión.
2. Haga clic en Salir del canal:
   

Si sale de un canal privado, ya no lo encontrará en la búsqueda, sino únicamente a través de su URL si la posee o siendo re-invitado por un miembro del canal.

Si sale de un canal público, sale inmediatamente, pero puede unirse de nuevo cuando lo desee simplemente encontrándolo con su nombre (2) en la búsqueda (1), incluso si ha sido archivado:

Archivar / eliminar un canal

Además del canal principal titulado General, puede archivar un canal en cualquier momento, lo que impide cualquier nuevo mensaje y ya no se contará en el cupo de sus canales disponibles. La operación es realizable desde el Manager o directamente en la interfaz de kChat:

1. Haga clic en la flecha ‍ en el título del canal en la parte superior de la discusión.
2. Haga clic en Archivar el canal:
   

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

Luego podrá desarchivarlo:

1. Haga clic en la flecha ‍ en el título del canal en la parte superior de la discusión.
2. Haga clic en Desarchivar el canal:
   
3. … o cierralo para no verlo más en su interfaz:
   

También puede eliminar un canal y, en ese caso, todos los datos asociados se eliminarán permanentemente:

1. Haga clic aquí para acceder a la gestión de su kChat en el Manager Infomaniak (¿necesita ayuda?).
2. Haga clic en el menú de acción ⋮ situado a la derecha del elemento correspondiente.
3. Haga clic en Eliminar:
   
    

Agregar a favoritos

Para agregar cualquier canal (o usuario) a favoritos:

1. Desde la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat), haga clic en el ícono estrella situado en la parte superior de un canal o de un usuario.
2. Aparecerá un nuevo menú Favoritos en la barra lateral izquierda agrupando todos los elementos que haya agregado a favoritos (visible solo para su usuario):
   

Silenciar un canal

Puede ocultar las notificaciones de un canal para no recibir más cuando se publique un nuevo mensaje:

1. Desde la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat), haga clic en el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda).
2. Elija Silenciar:
   

Organizar por categorías

⚠ Número máximo de categorías (por usuario):

Puede agregar una o más categorías que le permitan colocar elementos (canal, contacto, etc.) dentro de estas últimas:

1. Haga clic en el botón Nuevo situado en la barra lateral izquierda de la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat).
2. Haga clic en Crear una nueva categoría:
   
3. Arrastre luego el canal deseado a la categoría creada (válido solo para su usuario):
   
4. También puede usar el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda) para realizar estas operaciones:
   

Canal de discusión 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 solo será visible para las personas involucradas:

Infomaniak es una empresa suiza certificada ISO 27001 e ISO 9001 que respeta el RGPD.

Su principal objetivo es garantizar la seguridad y la confidencialidad de los datos que se le confían.

Se han implementado numerosas medidas para asegurar la protección de sus comunicaciones con kChat:

• El Administrador de Infomaniak permite verificar si los usuarios de su Organización han activado la autenticación de dos factores.
• Los datos en espera y en tránsito están cifrados, al igual que las copias de seguridad realizadas automáticamente por Infomaniak.
• Los datos se alojan en Suiza en centros de datos desarrollados y gestionados exclusivamente por Infomaniak.

• … recibe únicamente mensajes de parte de sus colaboradores o de los usuarios externos que ha aprobado.
• … puede crear canales privados para restringir la información sensible a personas específicas.
• … controla permanentemente los derechos de acceso de los usuarios que pueden acceder a kChat.

Esta guía detalla los diferentes elementos que pueden configurarse y personalizarse en kChat para adaptarse mejor a sus preferencias de uso.

Cambiar el idioma de la interfaz de kChat

La aplicación web kChat se muestra en el idioma elegido para el Manager y, al igual que su avatar/foto de perfil, estos parámetros se gestionan en el perfil de Infomaniak.

La aplicación de escritorio está configurada para usar el idioma del sistema operativo; puede gestionar esto en la configuración de la aplicación:

Configurar kChat en el Manager

Para acceder a las preferencias de kChat en el Manager de Infomaniak:

1. Haga clic aquí para acceder a la gestión de kChat en el Manager de Infomaniak (¿Necesita ayuda?).
2. Acceda a los diferentes tipos de canales.
3. Archivar o eliminar canales desde la parte inferior.
4. Haga clic en Configuración en el menú lateral izquierdo:
   
5. Agregue los canales (uno o varios canales posibles) a los que se añadirán automáticamente los nuevos usuarios (excepto usuarios externos) además de pertenecer al canal General.
6. Elija si todo el mundo puede publicar en el canal General:
   
7. Guarde sus cambios al final de la página.

Personalizar la visualización general de kChat

Para acceder a la configuración de las aplicaciones de kChat:

1. Haga clic aquí para acceder a la aplicación web kChat (servicio en línea ksuite.infomaniak.com/kchat) o abra la aplicación móvil kChat (aplicación para smartphone o tableta iOS / Android) o la aplicación de escritorio kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el icono en la parte superior derecha de la interfaz:
   
3. Puede elegir:
   
   1. una densidad de visualización y una posible visualización en color en densidad compacta
   2. la visualización o no de los previsualizaciones en sus conversaciones
   3. la dimensión de un canal (ancho)
   4. la posición de inicio cuando vuelve a un canal no leído
   5. el número de mensajes personales a mostrar.
4. La pestaña Notificaciones le permite personalizar las notificaciones de kChat:
   
5. La pestaña Accesos directos indica la lista de accesos directos de teclado disponibles para trabajar más rápidamente con kChat:
   

Resolver un problema de zoom de la visualización

Para hacer zoom o deshacer zoom en la visualización que se haya vuelto ilegible, debe usar los siguientes accesos directos de teclado:

• como en el navegador, CTRL/CMD y - para deshacer zoom
• CTRL/CMD y + para hacer zoom
• CTRL/CMD y 0 para reestablecer el tamaño por defecto

Modo oscuro / Modo claro

El tema claro o oscuro de la aplicación web se configura de forma global (consulte esta otra guía). Sin embargo, la aplicación de escritorio puede configurarse de forma independiente al resto; esto se parametriza desde el icono ‍ en la parte superior derecha de la interfaz:

Personalizar una conversación, un canal, etc.

Al lado de cada elemento de la barra lateral izquierda hay un menú de acción ⋮ que le permite, entre otras cosas, definir el orden de clasificación (alfabético, por actividad reciente, manual):

Definir un estado

Para mejorar su perfil y su visualización, en las conversaciones de kChat, pero también en las diferentes páginas y herramientas de my kSuite, puede definir un estado en forma de texto y/o emoticón, con una fecha de caducidad eventual:

1. Haga clic en su avatar o iniciales en la parte superior derecha de la interfaz.
2. Haga clic en Elegir un estado personalizado:
   
3. Introduzca un estado personalizado o elija uno de las sugerencias.
4. Introduzca una fecha de caducidad si es necesario:
   
5. Haga clic en el icono del emoticono si desea elegir un emoji junto a su nombre.
6. Confirme con el botón Definir el estado.

⚠ Número máximo de emoticones personalizados:

Usar kChat con su dominio y marca