Grazie per aver scelto Infomaniak e kChat come soluzione di discussione tra voi, i vostri cari o la vostra azienda! Queste guide vi aiuteranno a organizzare i vostri canali, gli utenti, le discussioni e molto altro!

Premessa

• Multipiattaforma, kChat è la messaggistica istantanea di kSuite che permette di scambiare, condividere e coordinare le tue squadre in tutta sicurezza da…
  • … il tuo browser Web
  • … il tuo dispositivo iOS / Android
  • … il tuo tablet o il tuo computer macOS / Windows / Linux
• Scarica l'app kChat sui tuoi dispositivi!
  • Non è possibile modificare la posizione della cartella kchat-desktop sul tuo disco rigido.
  • Il contenuto delle discussioni, foto, video, è memorizzato online sui server sicuri di Infomaniak.

Che cosa desideri fare?

• Configurare kChat
• Gestire gli utenti
• Gestire un canale
• Gestire una conversazione
• Rispondere ai messaggi
• Gestire le notifiche kChat
• Formattare i messaggi e inserire immagini
• Inviare un messaggio vocale e la sua trascrizione automatica
• Tradurre il contenuto di un messaggio sull'app kChat Infomaniak

Una domanda o un feedback?

• In caso di problemi, consultare la base di conoscenze prima di contattare il supporto.
• Clicca qui per condividere un'opinione o una suggerimento su un prodotto Infomaniak.

Questa guida ti permette di gestire applicazioni esterne con kChat utilizzando webhook.

Premessa

• Un webhook è un metodo che permette a un'applicazione di essere informata immediatamente quando si verifica un evento particolare in un'altra applicazione, piuttosto che chiedere costantemente a quest'ultima se è successo qualcosa di nuovo (cosa che si chiama "polling").
  • Webhook in uscita: kChat invia informazioni ad altre app quando si verifica un evento in kChat.
  • Webhook in entrata: kChat riceve informazioni da altre app per attivare azioni in kChat.
• Non è possibile importare la cronologia delle conversazioni da un'altra applicazione (Slack, Teams, Jabber, ecc.) o da un'altra Organizzazione.

Accedere all'interfaccia webhook di kChat

Prerequisiti

• Non essere un utente esterno (questo non vedrà il menu Integrazioni).

Per configurare un webhook, trovare applicazioni e integrazioni auto-hosted o di terze parti:

1. Clicca qui‍ per accedere all'app Web kChat (servizio online kchat.infomaniak.com) o apri l'app desktop kChat (applicazione desktop su macOS / Windows / Linux).
2. Clicca sull'icona Nuovo ‍ accanto al nome della tua organizzazione kChat.
3. Fai clic su Integrazioni.
4. Accedi alle categorie:
   

Esempio di integrazione

• Promemoria evento calendario Infomaniak su kChat

Creare un semplice webhook in entrata

Per fare questo:

1. Fai clic sulla categoria Webhook in entrata.
2. Fai clic sul pulsante blu Aggiungi webhook entranti:
   
3. Aggiungi un nome e una descrizione (max 500 caratteri) per il webhook.
4. Seleziona il canale che riceverà i messaggi
5. Salva per ottenere l'URL (da non divulgare pubblicamente); esempio “https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx”.

Utilizzo del webhook

Sull'applicazione che deve pubblicare su kChat:

1. Modifica il codice seguente in base all'URL ottenuta:

   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. Utilizzare eventualmente la stessa richiesta ma in curl (per testare da un'applicazione di tipo Terminal (interfaccia a riga di comando, CLI /Command Line Interface) sul tuo 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

Se non è specificato alcun header Tipo di contenuto non è definito, il corpo della richiesta deve essere preceduto da TRANSLATION_ERROR così:

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

Una richiesta riuscita riceverà la seguente risposta:

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	
}

Se desideri ottenere lo stesso formato di risposta di 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

devi aggiungere ?slack_return_format=true all'URL del webhook.

Parametri

Oltre al campo text, ecco l'elenco completo dei parametri supportati:

Esempio di codice con parametri

Ecco come generare un messaggio più completo con dei parametri, alcuni dei quali possono sostituire i parametri già stabiliti durante la creazione del webhook (nome utente, canale preferito, avatar...) come indicato nella tabella sopra:

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) |"
}

Questo farà apparire il messaggio nel canale kchatemp dell'organizzazione :

Questa guida descrive il servizio di traduzione automatica integrato nell'app kChat Infomaniak.

Tradurre il testo durante la lettura

Per tradurre automaticamente nella tua lingua un messaggio ricevuto scritto in una lingua straniera:

1. Clicca qui per accedere all'app Web kChat Infomaniak (servizio online kchat.infomaniak.com) o apri l'app mobile (applicazione per smartphone o tablet iOS / Android) o l'app desktop (applicazione desktop su macOS / Windows / Linux).
2. Consulta il messaggio da tradurre.
3. Clicca su il menu delle azioni ••• situato in alto a destra dell'elemento interessato:
   
4. Clicca su Traduci:
   
5. Il messaggio tradotto appare sotto la tua conversazione e è visibile solo a te.

Questa guida spiega come ottenere promemoria degli eventi dell'app Web Calendar Infomaniak (servizio online calendar.infomaniak.com) su un sistema di chat come kChat o Slack.

Premessa

• Questa funzionalità ti permetterà di essere notificato nel thread di discussione di tua scelta quando un evento è imminente.
• Il sistema di webhook è un metodo per cui un'applicazione o un servizio invia informazioni a un'altra applicazione o servizio in tempo reale, in modo sicuro e autenticato.

Annuncia il webhook a Calendar

Per aggiungere il webhook del tuo sistema di discussione su Calendar:

1. Clicca qui per accedere all'app Web Calendar (servizio online calendar.infomaniak.com).
2. Clicca sull'icona Impostazioni ‍ in alto a destra.
3. Clicca su Integrazioni nel menu laterale sinistro.
4. Clicca sul pulsante Aggiungi un webhook:
   
    
5. Imposta:
   
   1. Un nome per identificare facilmente il webhook quando aggiungi promemoria.
   2. L'URL del webhook (ottenuta dal tuo sistema di discussione - alcuni esempi sono presentati più avanti nella FAQ).
   3. Gli elementi (ripresi automaticamente dal tuo evento e/o aggiunti manualmente qui) e la loro disposizione nel messaggio che verrà inviato:
      • Inserisci %subject%‍ per includere l'argomento dell'evento.
      • Inserisci %date%‍ per includere la data dell'evento.
      • Inserisci %description%‍ per includere la descrizione dell'evento.
      • Inserisci %location%‍ per includere l'eventuale localizzazione dell'evento.
6. Clicca su Aggiungi.

Crea un evento con promemoria chat

Ora che Calendar è collegato al tuo account del sistema di discussione, puoi scegliere di essere notificato in una discussione quando aggiungi un promemoria a un evento:

1. Clicca qui per accedere all'app Web Calendar (servizio online calendar.infomaniak.com).
2. Crea un nuovo evento.
3. Clicca in basso a destra per visualizzare i campi aggiuntivi:
   
4. Aggiungi un promemoria:
   
5. Nel menu a discesa, seleziona il webhook configurato.
6. Convalida le modifiche.

Riceverai ora un promemoria nella chat corrispondente al webhook.

Esempi per ottenere un webhook

kChat

1. Clicca qui‍ per accedere all'app Web kChat (servizio online kchat.infomaniak.com) o apri l'app desktop kChat (applicazione desktop su macOS / Windows / Linux).
2. Vai alla sezione Integrazioni.
3. Clicca su Webhook in entrata :
   
4. Clicca in alto a destra su Aggiungi.
5. Completa le informazioni richieste per creare il "bot" che invierà i messaggi di sollecito in kChat nel canale di tua scelta:
   
6. Registra per ottenere l'URL del webhook:
   
7. Crea la notifica personalizzata in Calendar (leggi sopra se necessario):
   
8. Seleziona la tua notifica personalizzata quando aggiungi un promemoria al tuo evento:
   

Slack
 

1. Clicca qui per accedere ai WebHooks Slack.
2. Scegliete il thread di conversazione in cui appariranno i vostri promemoria (ad esempio @slackbot o #general):
   
3. Registrati per ottenere l'URL del webhook.

Crea altri webhook per impostare promemoria in altre conversazioni.

Personalizza i promemoria di un promemoria Slack

Puoi utilizzare liberamente le opzioni di formattazione di Slack nelle tue notifiche. Esempio in francese:

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

Questa guida dettaglia la gestione dei membri del tuo servizio di chat kChat.

Consultate questa guida se desiderate gestire i canali a cui i nuovi membri dovranno appartenere automaticamente.

Prerequisiti

• Avere i permessi sufficienti per amministrare il prodotto in questione.
• Invitare un utente a unirsi a kChat.

Vedere i membri di un canale

Per vedere gli utenti che hanno accesso al canale selezionato:

1. Clicca qui‍ per accedere a l'app Web kChat (servizio online kchat.infomaniak.com) o apri l'app desktop kChat (applicazione desktop su macOS / Windows / Linux).
2. Fai clic sull'icona del personaggio sotto il titolo del canale.
3. I partecipanti vengono visualizzati in colonna a destra di kChat:
   

Invitare o rimuovere un membro da un canale privato

Per gestire gli utenti che hanno accesso a un canale privato:

1. Fai clic sull'icona del personaggio sotto il titolo del canale.
2. I partecipanti attuali vengono visualizzati in colonna a destra di kChat.
3. Il pulsante blu Aggiungi consente di invitare un utente kChat o un'intera squadra di lavoro che non ha ancora accesso a questo canale:
   
4. Il pulsante Gestisci consente di rimuovere un membro da questo canale o di nominarlo Amministratore del canale in modo che a sua volta possa gestire i membri:
   

Questa guida dettaglia l'uso di smiley ed emoji per reagire e interagire con le discussioni del servizio kChat.

Aggiungere una reazione a un messaggio

Per reagire in qualsiasi momento a qualsiasi messaggio a cui hai accesso in kChat, basta passare il mouse sul messaggio e selezionare un'emoticon dalla selezione o il sorriso con il piccolo +:

 

Se ci sono già delle reazioni, è possibile aggiungerne un'altra nello stesso punto:

In questo modo si aprirà il pannello con centinaia di emoticone a disposizione (e anche emoji personalizzati - leggere più avanti).

Esprimersi con un'emoticona o un GIF

Aggiungere un'emoji all'interno del messaggio che stai scrivendo è molto semplice. Basta cliccare sull'icona del viso sorridente nella barra di formattazione del tuo messaggio:

Puoi quindi scegliere un'emoji:

o inserire brevi GIF animati invece di un'emoticon grazie alla scheda situata in alto nel riquadro che appare quando si fa clic sul viso sorridente:

 

Se conosci il nome del simbolo da inserire, puoi anche digitare : (2 punti) seguito dai primi 2 caratteri minimi:

Suggerimento: se aggiungi #, ## o ### come primo carattere di una nuova riga contenente un'emoticona, potrai utilizzare un'emoticona più grande. Per provare, invia un messaggio come '# :smile:' (attenzione, le tue impostazioni personalizzate possono "disattivare" questa funzionalità di visualizzazione sulla tua interfaccia).
 

Per impostare la tonalità predefinita, clicca su questo simbolo del pannello degli emoji:
 

Emoticon personalizzati

Per gestire ulteriori emoticons, clicca su questo pulsante del pannello delle emoticons:

Specifica un nome fino a 64 caratteri. Può contenere lettere minuscole, numeri e i caratteri « - », « + » e « _ ».

Specificare un file .gif, .png o .jpg per la tua emoji. Il file può pesare fino a 1 Mo. La dimensione viene ridimensionata automaticamente a 128x128 pixel, mantenendo il rapporto di aspetto.

L'emoticon può essere utilizzato da tutti gli utenti kChat della tua Organizzazione grazie al nome che gli hai attribuito.

Questa guida riguarda i prodotti Infomaniak che integrano l'uso dell'intelligenza artificiale, tra cui kChat, kDrive, Mail, Site Creator…

Responsabilità delle parti

Dati forniti all'IA

• L'IA di Infomaniak è attualmente basata per impostazione predefinita su mixtral8x22b.
  • GPT4 turbo è un'opzione volontaria lasciata alla scelta dell'utente kChat / Mail; DeepSeek-R1-distilled-qwen-32B è anche proposto sul sito e l'API.
  • I messaggi audio sono trascritti con Whisper.
  • Llama 3 è disponibile per l'API AI Tools.
• Utilizzando un assistente di scrittura, i messaggi e le richieste inviate all'IA vengono esclusivamente elaborati in Svizzera dall'infrastruttura di Infomaniak.
• Nessun dato viene elaborato o condiviso con terzi.

Dati forniti dall'IA

• Il modello di linguaggio genera testo basandosi sui dati che ha assimilato durante l'apprendimento, privo di coscienza, intenzioni o responsabilità morali.
• È fondamentale che l'utente sia consapevole che le informazioni generate dal modello non sono sempre precise e non devono essere considerate una fonte di informazioni inconfutabile.
• Deve esercitare il suo giudizio critico e verificare le informazioni fornite dall'assistente presso fonti affidabili quando necessario.
  • Ad esempio, se una persona utilizza il modello per compiti cruciali come consigli medici, legali o finanziari, deve prendere precauzioni aggiuntive per confermare le informazioni provenienti dal modello.
• In caso di utilizzo inappropriato o pericoloso di questo assistente, la responsabilità ricade sull'utente che compie queste azioni.

Questa guida spiega come ottenere automaticamente il riassunto del contenuto di un messaggio kChat.

Riassumere automaticamente un messaggio kChat

Per ottenere il riassunto di un messaggio kChat:

1. Passate il mouse sul messaggio e selezionate l'icona delle azioni IA in alto a destra.
2. Clicca su Riassumi la conversazione:
   ‍
3. Ottieni il riassunto, generato dall'IA e inviato da kChat Bot nel pannello laterale destro:
   

Consulta questa altra guida riguardo agli agenti conversazionali di kChat.

Questa guida illustra il funzionamento delle conversazioni kChat, organizzate all'interno di Canali di discussione privati e pubblici, e di discussioni dirette tra utenti.

Iniziare una conversazione

Per scrivere a un utente della tua Organizzazione, clicca sul suo nome nell'elenco dei membri a sinistra della tua interfaccia kChat:

È possibile fare clic sul + a destra dei Messaggi personali per selezionare fino a 7 membri e creare così una conversazione di gruppo:

Scrivi e invia il tuo messaggio premendo il pulsante di invio:

Se necessario, è possibile allegare file fino a 100 Mo. È inoltre possibile utilizzare le “reazioni”.

Programmare un invio

Per programmare l'invio a una data/ora successiva, basta cliccare sulla freccia a destra del pulsante di invio e quindi scegliere il momento in cui il messaggio dovrà essere inviato:

Menzionare un altro utente

Per coinvolgere uno dei membri dell'Organizzazione (o un'intera squadra di lavoro) tramite un messaggio, digita l'arroba @ per visualizzare le persone o i canali da menzionare:

Richiedere una ricevuta di lettura

Per permettere agli utenti di confermare la ricezione del tuo messaggio e segnalare di averlo letto, attiva una ricevuta di lettura prima di inviare il messaggio sul canale, facendo clic sull'icona (!) e attivando l'interruttore:

Una volta inviato il messaggio, il risultato sarà il seguente:

Modificare o eliminare un messaggio

Per modificare un messaggio (che conterrà poi una menzione di messaggio modificato), clicca sul menu delle azioni a destra del messaggio da modificare. Nello stesso punto, puoi anche eliminare il tuo messaggio che scomparirà quindi dalla discussione per tutti gli utenti:

Organizzare le conversazioni in kChat

Il tipo di ordinamento per gli elementi che gestisci a sinistra dello schermo è molto importante.

Immagina di aprire kChat dopo diversi giorni di assenza, le conversazioni non lette appariranno una sotto l'altra. Dopo averle lette, potresti voler ritrovare un'informazione letta tra una di esse, quindi un ordinamento per attività recente, ad esempio (leggi sotto per altre possibilità), permette di ritrovare le ultime conversazioni che ti riguardavano. 

Questa scelta del tipo di ordinamento è disponibile per tutti gli elementi: canali di discussione, categorie, messaggi diretti, ecc.

Cercare una conversazione

La ricerca di elementi (parola, partecipante, file) si trova in alto nella finestra:

Una volta trovati i risultati, appaiono a destra della finestra.

Filo di discussione (thread)

Qualsiasi sia il canale o la chat privata con un altro utente, è possibile avviare una discussione a partire da un altro semplicemente selezionando Rispondi sul messaggio desiderato.

Si aprirà un thread di discussione sulla tua destra, permettendo a ogni utente del canale di apportare il proprio contributo in questo thread specifico senza disturbare eventuali nuovi argomenti del canale in corso:

Questi fili di discussione vengono poi centralizzati per essere letti e riletti nella sezione Filo di discussione della barra laterale sinistra.

Questa guida riguarda kChat, il servizio di messaggistica istantanea di Infomaniak che consente di scambiare, condividere e coordinare il lavoro delle tue squadre in modo sicuro dal tuo browser web, mobile, tablet o computer.

Ottieni kChat

kChat è disponibile con kSuite.

Una volta che avete configurato kSuite all'interno della vostra Organizzazione, scaricate…

• … l'app mobile kChat (applicazione per smartphone o tablet iOS/Android)
• … l'app desktop kChat (applicazione desktop per macOS / Windows / Linux).

e/o clicca qui per accedere a l'app Web kChat (servizio online kchat.infomaniak.com).

Prendete anche visione della guida introduttiva.