Base de conocimientos
1000 FAQ, 500 tutoriales y vídeos explicativos. ¡Aquí sólo hay soluciones!
¡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 acceder a la gestión de aplicaciones externas para kChat.
Requisitos previos
- No ser un usuario externo (este no verá el menú Integraciones)
Acceso a la interfaz
Para configurar un webhook, encontrar aplicaciones e integraciones autohospedadas o de terceros:
- abrir la aplicación kChat (en su dispositivo o desde un navegador en la URL kchat.infomaniak.com)
- hacer clic en la flecha a la derecha del nombre de su organización kChat
- hacer clic en Integraciones
- acceder a las categorías:
Ejemplo de integración
Crear un simple webhook entrante
Para ello:
- hacer clic en la categoría Webhooks entrantes
- hacer clic en el botón azul Añadir webhooks entrantes
- añadir un nombre y una descripción (máx. 500 caracteres) para el webhook
- seleccionar el canal que recibirá los mensajes
- guardar para obtener la URL (no divulgar públicamente) del tipo:
https://your-kchat-server.xyz/hooks/xxx-clave-generada-xxx
Uso del webhook
En la aplicación que debe publicar en kChat:
- ajustar el código a continuación según la URL obtenida:
POST /hooks/xxx-clave-generada-xxx HTTP/1.1
Host: your-kchat-server.xyz
Content-Type: application/json
Content-Length: 63
{
"text": "Hola, este es un texto\nEste es otro texto."
} - usar posiblemente la misma solicitud pero en curl (para probar desde una Terminal en macOS p. ej.):
curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Hola, este es un texto\nEste es otro texto."}' https://your-kchat-server.xyz/hooks/xxx-clave-generada-xxx
Si no se define ningún encabezado Content-Type, el cuerpo de la solicitud debe ir precedido de payload= de esta 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 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
, aquí está la lista completa de parámetros admitidos:
Parámetro | Descripción | Requerido |
---|---|---|
text | Mensaje en formato Markdown para mostrar en la publicación. Para activar notificaciones, use @<nombre de usuario> , @channel y @here como lo haría en otros mensajes de kChat. | Si attachments no está definido, sí |
channel | Reemplaza el canal en el que se publica el mensaje. Utilice el nombre del canal, no el nombre para mostrar, use p. ej. town-square , no Plaza de la Ciudad .Use "@" seguido de un nombre de usuario para enviar un mensaje directo. De forma predeterminada, utiliza el canal definido al crear el webhook. El webhook puede publicar en cualquier canal público y privado donde esté presente el creador del webhook. Las publicaciones en mensajes directos aparecerán en el mensaje directo entre el usuario objetivo y el creador del webhook. | No |
username | Reemplaza el nombre de usuario bajo el cual se publica el mensaje. De forma predeterminada, utiliza el nombre de usuario definido al crear el webhook; si no se define ningún nombre de usuario al crearlo, utiliza webhook .El parámetro de configuración Permitir a las integraciones reemplazar los nombres de usuario debe estar activado para que el reemplazo del nombre de usuario tenga efecto. | No |
icon_url | Reemplaza la imagen de perfil con la que se publica el mensaje. De forma predeterminada, utiliza la URL definida al crear el webhook; si no se define ningún icono al crearlo, se mostrará el icono de webhook estándar (). El parámetro de configuración Permitir a las integraciones reemplazar los iconos de foto de perfil debe estar activado para que el reemplazo del icono tenga efecto. | No |
icon_emoji | Reemplaza la imagen de perfil y el parámetro icon_url .De forma predeterminada, no se define nada al crear el webhook. El valor esperado es el nombre de un emoji tal como se escribe en un mensaje, con o sin dos puntos ( : ).El parámetro de configuración Permitir a las integraciones reemplazar los iconos de foto de perfil debe estar activado para que el reemplazo tenga efecto. | No |
attachments | Adjuntos al mensaje utilizados para opciones de formato más ricas. | Si text no está definido, sí |
type | Define el tipo de publicación, principalmente para uso por plugins.Si no está vacío, debe comenzar con " custom_ ". | No |
Ejemplo de código con parámetros
Así es como se genera 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:
POST /hooks/xxx-clave-generada-xxx HTTP/1.1
Host: your-kchat-server.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 revisen 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 resultará en la visualización de este mensaje 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:
- Inicie sesión en Calendar (calendar.infomaniak.com), la parte de calendarios de Infomaniak Mail, desde un navegador web como Brave o Firefox.
- Haga clic en el icono
- Haga clic en el botón Agregar un Webhook (en la sección de Notificaciones personalizadas)
- 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.
- 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:
- Inicie sesión en Calendar (calendar.infomaniak.com) desde un navegador web como Brave o Firefox.
- Cree un nuevo evento.
- Haga clic en la esquina inferior derecha para mostrar los campos adicionales
- Agregue un recordatorio
- En el menú desplegable, elija el Webhook configurado.
- 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
- Abra la aplicación kChat.
- Vaya a la sección de Integraciones.
- Haga clic en Webhooks entrantes:
- Haga clic en la esquina superior derecha en Agregar.
- Complete la información requerida para crear el "bot" que enviará mensajes de recordatorio en kChat en el canal de su elección:
- Guárdelo para obtener la URL del Webhook:
- Configure la notificación personalizada en Calendar (lea arriba si es necesario):
- Seleccione su notificación personalizada al agregar un recordatorio a su evento:
Slack
- Abra esta página de Slack y autentifíquese con sus credenciales de Slack.
- Elija el canal en el que se mostrarán sus recordatorios (por ejemplo, @slackbot o #general)
- 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 usuarios en kChat.
Ver Miembros de un Canal
Para ver los usuarios que tienen acceso al canal seleccionado:
- Haz clic en el icono de personaje debajo del título del canal
- Los participantes aparecerán en una columna en el lado derecho de kChat
Agregar o Eliminar un Usuario
Para agregar un usuario a kChat, deben ser parte de la misma organización:
- Inicia sesión en el Manager de Infomaniak (manager.infomaniak.com) desde un navegador web como Brave o Firefox
- Haz clic en Usuarios y Perfil en el menú lateral izquierdo
- Haz clic en Usuarios
- Haz clic en Agregar un Usuario en la parte superior derecha
También puedes invitar a un usuario externo a chatear contigo en kChat. También puedes invitar a un equipo de trabajo completo desde kChat.
En el mismo lugar, puedes eliminar los derechos de kChat de un usuario al eliminarlo de la organización:
Invitar o Eliminar un Miembro de un Canal Privado
Para gestionar los usuarios que tienen acceso a un canal privado:
- Haz clic en el icono de personaje debajo del título del canal
- Los participantes actuales aparecerán en una columna en el lado derecho de kChat
- El botón azul Agregar invita a un usuario de kChat de la organización que aún no tiene acceso a este canal privado
- El botón azul Gestionar te permite eliminar 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 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
kChat evita el spam y el phishing , responsables de la mayoría de los problemas de seguridad y fugas de datos en las empresas. Usando kChat para comunicarse:
- 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 explica cómo insertar texto formateado e imágenes en sus mensajes en kChat.
Formato del Texto del Mensaje
Aquí están los símbolos para agregar antes y después de su texto para formatearlo en el estilo deseado:
Símbolos | Resultado | Ejemplo |
---|---|---|
* | cursiva | *Esto será en cursiva* |
** | negrita | **Esto será en negrita** |
*** | cursiva+negrita | ***Esto será en cursiva+negrita*** |
~~ | ~~Esto será tachado~~ | |
``` | línea de código | ```Esto es código``` |
También puedes insertar esto:
Símbolos | Resultado | Ejemplo |
---|---|---|
*** | (separador / línea horizontal) | 1ª parte *** 2ª parte |
Insertar una Imagen en el Mensaje
desde una URL
Inserte el siguiente código en su mensaje reemplazando el texto alternativo y la dirección de la imagen (URL) con el enlace de la imagen (debe ser accesible y visible en la web):
![texto-alt](https://www.domain.xyz/xyz/imagen.png)<br>
Ejemplo
Mensaje con sintaxis de inserción de imagen:
Vista previa antes de enviar:
Haga clic en la imagen después de enviar:
desde el disco duro o kDrive
Haga clic en el icono de la chincheta para insertar una imagen existente desde su disco duro o kDrive:
La imagen se insertará en el mensaje que luego puede enviar directamente en la conversación sin necesidad de agregar texto adicional.
Esta guía detalla el uso y la gestión de los canales en kChat.
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, chatear en tiempo real y organizar videoconferencias.
Canal General
Cada organización en kChat tiene automáticamente un canal General al que todos los usuarios son invitados automáticamente.
Puedes usar este canal para compartir información que concierne a toda tu organización, como actualizaciones corporativas o buenas noticias motivadoras.
Por supuesto, también puedes iniciar un nuevo hilo de conversación dentro del canal General.
Canal Adicional
Para agregar un nuevo canal de discusión:
- Haz clic en el botón + en la barra lateral izquierda de kChat
- Haz clic en Crear un nuevo canal
Información del Canal
Cuando creas un nuevo canal, puedes elegir:
1. su nombre
Se puede modificar más adelante.
2. su URL
Por defecto, toma el nombre del canal, pero puedes modificarlo utilizando letras minúsculas, números, puntos, guiones y guiones bajos, también modificables más adelante.
3. su estado Privado
o Público
Se puede modificar más adelante (ver abajo).
4. su descripción
La descripción ayuda a especificar cómo se debería utilizar este canal. Este texto aparece en la lista de canales en el menú "Más..." y da una indicación a los usuarios sobre si deben unirse al canal o no.
Una vez creado el canal, aún puedes definir:
5. un encabezado
Diferencias entre canal Privado
y Público
Los canales públicos
aumentan la transparencia. Todos los usuarios pueden ver y unirse a un canal público, lo que garantiza 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 tu elección. Solo un miembro existente puede invitar a otro usuario a un canal privado. También existen diferencias en la gestión de la archivación/eliminación (ver abajo).
Los canales privados están limitados a 20 (50 con kSuite Pro y 1000 con la oferta Enterprise).
Convertir un canal público en un canal privado
Para convertir un canal público en un canal privado:
- Haz clic en el canal público en el menú lateral izquierdo
- Luego, haz clic en el título del canal en la parte superior de la discusión
- Elige Convertir
El historial y la pertenencia de los miembros 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?
La inversa (convertir un canal privado en un canal público) también es posible, pero solo un usuario administrador de kChat puede hacerlo; el historial de mensajes se conserva.
Salir de un canal
Además del canal principal titulado General, puedes salir de un canal en cualquier momento:
- Haz clic en el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda)
- Haz clic en Salir del canal
Si sales de un canal privado, ya no lo encontrarás en la búsqueda, solo a través de su URL si la tienes o siendo invitado nuevamente por un miembro del canal.
Si sales de un canal público, lo abandonas de inmediato, pero puedes volver a unirte en cualquier momento simplemente encontrándolo con su nombre en la búsqueda, incluso si ha sido archivado.
Archivar/Eliminar un canal
Además del canal principal titulado General, puedes archivar un canal en cualquier momento, lo que impide el envío de nuevos mensajes y no lo cuenta más en tu cuota de canales disponibles:
- Haz clic en el canal en el menú lateral izquierdo
- Luego, haz clic en el título del canal en la parte superior de la discusión
- Haz clic en Archivar el canal
Si creas un canal y luego lo archivas, puedes volver a unirte en cualquier momento simplemente encontrándolo con su nombre en la búsqueda:
Luego puedes desarchivarlo:
o cerrarlo para que no lo veas más en tu interfaz:
Favorito
Para marcar como favorito cualquier canal, simplemente:
- Haz clic en la estrella en la parte superior de un canal
- Aparecerá un nuevo menú Favoritos en la barra lateral izquierda que agrupa todos los elementos que hayas marcado como favoritos (válido solo para tu usuario)
Silenciar un canal
Puedes ocultar las notificaciones de un canal:
- Haz clic en el menú de acción ⋮ a la derecha del canal correspondiente (en la barra lateral izquierda)
- Elige Silenciar
Organizar por categorías
Haciendo clic en el botón + en la barra lateral izquierda de kChat, puedes agregar una o varias categorías que te permitan colocar elementos (canal, contacto, etc.) dentro de ellas. Luego, arrastra el canal deseado a la categoría creada (válido solo para tu usuario):
Canal de Chat de Usuario a Usuario
Los mensajes personales son conversaciones directas entre dos o más personas que ocurren fuera de los canales.
Cada usuario dentro de una organización puede crear libremente mensajes personales cuyo contenido solo será visible para las personas involucradas.