Base de conocimientos

Gracias por elegir Infomaniak y kChat como solución de discusión entre usted, su entorno o su empresa! Estas guías le ayudarán a organizar sus canales, usuarios, charlas y más!

Preámbulo

• Multiplataformas, kChates la mensajería instantánea de kSuite que permite intercambiar, compartir y coordinar sus equipos de forma segura desde...
  • ... su navegador web
  • ... su dispositivo iOS / Android
  • ... su tableta móvil o su ordenador macOS / Windows / Linux
• Descargar la app kChat ¡En sus dispositivos!
  • No es posible cambiar la ubicación de la carpeta kchat-desktop En tu disco duro.
  • El contenido de las discusiones, fotos, videos, se almacena en línea en los servidores seguros de Infomaniak.

¿Qué quieres hacer?

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

¿Alguna pregunta o una respuesta?

• En caso de problema, por favor consulte la base de conocimientos antes de contactar con el soporte.
• Haga clic aquí para compartir una opinión o una 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. Selecciona 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) sobre un sistema de debate como kChat O Slack.

Preámbulo

• Esta función le permitirá ser notificado en el hilo de discusión de su elección cuando un evento está cerca.
• 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.

Anuncia el webhook a Calendar

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

1. Haga clic aquí para acceder a la aplicación web Calendar (servicio en línea) calendar.infomaniak.com).
2. Haga clic en el icono Parámetros ‍ Arriba a la derecha.
3. Haga clic en Integración en el menú lateral izquierdo.
4. Haga clic en el botón Añadir un webhook:
   
    
5. Define:
   
   1. Un nombre para identificar fácilmente el Webhook cuando se añaden recordatorios.
   2. La URL de la webhook (obtenida en su sistema de discusión - de ejemplos se presentan más abajo en la FAQ).
   3. Los elementos (reprendidos automáticamente de su evento y/o añadidos manualmente aquí) y su disposición en el mensaje que se enviará:
      • Insertar %subject%‍ para incluir el tema del evento.
      • Insertar %date%‍ para incluir la fecha del evento.
      • Insertar %descripción%‍ para incluir la descripción del evento.
      • Insertar %location%‍ para incluir la posible localización del evento.
6. Haga clic en Añade.

Cree un evento con recordatorio por gato

Ahora que Calendar está conectado a su cuenta del sistema de chat, usted puede optar por ser notificado en una discusión cuando se añade un recordatorio a un evento:

1. Haga clic aquí para acceder a la aplicación web Calendar (servicio en línea) calendar.infomaniak.com).
2. Cree un nuevo evento.
3. Haga clic en la parte inferior derecha para Mostrar campos adicionales:
   
4. Añade un recordatorio:
   
5. En el menú desplegable, Elija el webhook Configurado.
6. Validez las modificaciones.

Ahora recibirás un recordatorio en el chat correspondiente al webhook.

Ejemplos para obtener un webhook

kChat

1. Haga clic aquí‍ con el fin de acceder a la app web kChat (servicio en línea) kchat.infomaniak.com) Abra la app desktop kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Nos vemos en el juego. Integración.
3. Haga clic en Webhooks entrantes :
   
4. Haga clic en la parte superior derecha de Añadir.
5. Complete la información requerida para crear el "bot" que va a publicar los mensajes de recuperación en kChat en el canal de su elección:
   
6. Guarde para obtener la URL de la webhook:
   
7. Cree la notificación personalizada en Calendar (lea más arriba si es necesario):
   
8. Seleccione su notificación personalizada al añadir un recordatorio sobre su evento:
   

Slack
 

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

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

Personaliza los estímulos de un recordatorio de Slack

Usted puede utilizar libremente las opciones de formato de Slack en sus notificaciones. Ejemplo:

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.

Conozca esta otra guía si desea 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 con acceso al canal seleccionado:

1. Haga clic aquí‍ con el fin de acceder a la app web kChat (servicio en línea) kchat.infomaniak.com) Abra la app desktop kChat (aplicación de escritorio en macOS / Windows / Linux).
2. Haga clic en el icono del personaje debajo del título del canal.
3. Los participantes aparecen en columna a la derecha de kChat:
   

Invitar o retirar a un miembro a un canal privado

Para gestionar los usuarios con acceso a un canal privado:

1. Haga clic en el icono del personaje debajo del título del canal.
2. Los participantes actuales aparecen en columna a la derecha de kChat.
3. El botón azul Añadir permite invitar a un usuario kChat o una Grupo de trabajo completa, que aún no tengan acceso a este canal:
   
4. El botón Gestionar permite retirar a un miembro de este canal o nombrarlo Administrador del canal para que, a su vez, pueda gestionar los miembros:
   

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 Infomaniak que integran el uso de la inteligencia artificial, en particular kChat, kDrive, Mail, Sitio Creator…

Responsabilidades de las partes

Datos proporcionados a la IA

• En la actualidad, la IA de Infomaniak se basa por defecto en mixtral8x22b.
  • GPT4 turbo es una opción voluntaria dejada a elección del usuario kChat / Mail; DeepSeek-R1-distilled-qwen-32B se propone también 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 I.A.I.A. son tratados exclusivamente en Suiza por la infraestructura de Infomaniak.
• No se procesan ni comparten datos con terceros.

Datos de la IA

• El modelo de lenguaje genera texto basándose en los datos que ha asimilado durante su aprendizaje, sin conciencia, intenciones o responsabilidades morales.
• Es crucial que el usuario sea consciente de que la información generada por el modelo no siempre es exacta y no debe considerarse como una fuente de información indiscutible.
• Debe ejercer su discernimiento crítico y verificar la información facilitada por el asistente de fuentes fiables cuando sea necesario.
  • P.ex si una persona utiliza el modelo para tareas cruciales como asesoramiento médico, jurídico o financiero, debe tomar precauciones adicionales para confirmar la información del modelo.
• En caso de uso inapropiado o peligroso de este asistente, la responsabilidad recaerá en el usuario que tome 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. Volar sobre el mensaje y seleccionar el icono de las acciones de IA en la parte superior derecha.
2. Haga clic en Resuelve el hilo de discusión:
   ‍
3. Obtenga el resumen generado por IA y enviado por kChat Bot al panel lateral derecho:
   

Conozca esta otra guía sobre los agentes de conversación de KChat.

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

Iniciar una conversación

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

Enviar su mensaje; si es necesario adjuntar archivos de hasta 100 MB. También puedes usar ¡Despertad!reacciones”.

Mencione a otro usuario

Para solicitar a uno de los miembros de la organización (o a toda una Grupo de trabajo) a través de un mensaje, escribir la arobase @ para mostrar las personas o canales a mencionar. Atención, dependiendo del tipo de canal en cuestión, la mención de un usuario muestra un mensaje que le permite añadirlo a la discusión sin la cual no verá la mención.

Solicitar un acusado de lectura

Para que los usuarios puedan acusar recibo de su mensaje y así informar de haber leído el mensaje, activar un acuse de lectura antes de enviar el mensaje al canal, haciendo clic en el icono (!) A continuación, activando el botón de cambio (toggle switch):

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

 

Editar o eliminar un mensaje

Para editar un mensaje (que a continuación incluirá 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 discusión en todos los usuarios:

Organizar conversaciones en kChat

El tipo de clasificación para los elementos que gestiona a la izquierda 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 entre ellas. Después de leerlas, tal vez desee encontrar una información leída entre una de ellas, así que una clasificación por actividad reciente p.ex (lea más abajo para otras posibilidades) permite encontrar las últimas conversaciones que le conciernen.

Esta selección del 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.

Filo de discusión (thread)

Cualquier canal o chat privado con otro usuario, puede iniciar un hilo de discusión de otro simplemente eligiendo Responder sobre el mensaje deseado.

A la derecha se abrirá un hilo de discusión que permitirá a cada usuario del canal traer sus palabras en este hilo específico sin perturbar los posibles nuevos temas del canal actual:

Estos hilos de discusión se centralizan para ser leídos y releídos en la parte del hilo 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 o computadora.

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.