Grazie per aver scelto Infomaniak e kChat come soluzione di messaggistica per te, il tuo entourage o la tua azienda!

Questi guide ti aiuteranno a organizzare i tuoi canali, utenti, conversazioni e molto altro!

Per iniziare

Multiplatform, kChat è il servizio di messaggistica istantanea di kSuite che ti permette di scambiare, condividere e coordinare i tuoi team in modo sicuro dal tuo browser web, dispositivo iOS/Android, tablet mobile o computer macOS/Windows/Linux.

Scarica l'app kChat sui tuoi dispositivi!

Cosa desideri fare?

• Gestire gli utenti
• Gestire un canale
• Gestire una conversazione
• Reagire ai messaggi
• Gestire le notifiche di kChat
• Formattare i messaggi e inserire immagini
• Inviare un messaggio vocale e la sua trascrizione automatica

Hai domande o feedback?

• Il supporto di Infomaniak è a tua disposizione
• vedi tutte le FAQ di kChat
• clicca qui per condividere un'opinione o un suggerimento su un prodotto Infomaniak

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

Premessa

• un webhook è un metodo che consente a un'applicazione di essere informata immediatamente quando si verifica un particolare evento in un'altra applicazione, anziché chiedere costantemente a quell'applicazione se è arrivata qualcosa di nuovo (quello che viene chiamato "polling")
• non è possibile importare la cronologia delle discussioni da un'altra applicazione (Slack, Teams, Jabber, ecc.) o da un'altra organizzazione
• webhook in uscita: kChat comunica 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

Accedere all'interfaccia webhook di kChat

Requisiti

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

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

1. aprire l'app kChat (sul proprio dispositivo o tramite un browser all'URL kchat.infomaniak.com)
2. fare clic sulla freccia verso il basso ‍ a destra del nome della propria organizzazione kChat
3. fare clic su Integrazioni
   
    
4. accedere alle categorie:
   

Esempio di integrazione

• Promemoria evento calendario Infomaniak su kChat

Creare un semplice webhook in entrata

Per fare ciò:

1. fare clic sulla categoria Webhook in entrata
2. fare clic sul pulsante blu Aggiungi webhook in entrata
   
3. aggiungere un nome e una descrizione (max 500 caratteri) per il webhook
4. selezionare il canale che riceverà i messaggi
5. salvare per ottenere l'URL (da non divulgare pubblicamente) di tipo:
   https://il-tuo-server-kchat.xyz/hooks/xxx-chiave-generata-xxx

Utilizzo del webhook

Nell'app che deve pubblicare su kChat:

1. regolare il codice qui sotto in base all'URL ottenuto:

   POST /hooks/xxx-chiave-generata-xxx HTTP/1.1
   Host: il-tuo-server-kchat.xyz
   Content-Type: application/json
   Content-Length: 63
   
   {
       "text": "Ciao, questo è un testo\nQuesto è un altro testo."
   }

2. eventualmente utilizzare la stessa richiesta ma in curl (per testare da un Terminale su macOS, ad esempio):
   curl -i -X POST -H 'Content-Type: application/json' -d '{"text": "Ciao, questo è un testo\nQuesto è un altro testo."}' https://il-tuo-server-kchat.xyz/hooks/xxx-chiave-generata-xxx

Se non è impostato alcun header Content-Type, il corpo della richiesta deve essere preceduto da payload= nel seguente modo:

payload={"text": "Ciao, questo è un testo\nQuesto è un altro testo."}

Una richiesta riuscita restituirà 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 avere 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 alla fine dell'URL del webhook.

Parametri

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

Esempio di codice con parametri

Così puoi generare un messaggio più completo con parametri, alcuni dei quali possono sovrascrivere parametri già impostati durante la creazione del webhook (nome utente, canale preferito, avatar...), come indicato nella tabella precedente:

POST /hooks/xxx-chiave-generata-xxx HTTP/1.1
Host: il-tuo-server-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": "#### Risultati dei test per il 27 luglio 2023\n@channel per favore controlla i test falliti.\n\n| Componente  | Test eseguiti   | Test falliti                                   |\n|:-----------|:-----------:|:-----------------------------------------------|\n| Server     | 948         |  0                           |\n| Client Web | 123         |  2 [(Vedi dettagli)](https://linktologs) |\n| Client iOS | 78          |  3 [(Vedi dettagli)](https://linktologs) |"
}

Questo porterà a visualizzare questo messaggio nel canale kchatemp dell'organizzazione:

Questa guida spiega come ricevere promemoria di eventi da Infomaniak Calendar su un sistema di chat come kChat o Slack.

Questa funzione ti permetterà di essere notificato nella chat che preferisci quando un evento si avvicina.

Cosa è un Webhook?

Il sistema di Webhook è un metodo mediante il quale un'applicazione o un servizio invia informazioni a un'altra applicazione o servizio in tempo reale in modo sicuro e autenticato.

Configurare il Webhook in Calendar

Per aggiungere il Webhook del tuo sistema di chat a Calendar:

1. Accedi a Calendar (calendar.infomaniak.com), la parte dei calendari di Infomaniak Mail, da un browser come Brave o Firefox.
2. Fai clic sull'icona
3. Fai clic sul pulsante Aggiungi un Webhook (nella sezione Notifiche personalizzate)
   
4. Configura:
   
   • (A) Un nome per identificare facilmente il Webhook quando aggiungi promemoria.
   • (B) L'URL del Webhook (ottenuto dal tuo sistema di chat; sono presentati esempi più avanti nella FAQ).
   • (C) Gli elementi (presi automaticamente dal tuo evento o aggiunti manualmente qui) e la loro disposizione nel messaggio che verrà inviato:
     • Includi %subject% per aggiungere l'oggetto dell'evento.
     • Includi %date% per aggiungere la data dell'evento.
     • Includi %description% per aggiungere la descrizione dell'evento.
     • Includi %location% per aggiungere la posizione dell'evento, se presente.
5. Fai clic su Salva.

Creare un evento con promemoria in chat

Ora che Calendar è collegato al tuo account di sistema di chat, puoi scegliere di ricevere notifiche in una chat quando aggiungi un promemoria a un evento:

1. Accedi a Calendar (calendar.infomaniak.com) da un browser come Brave o Firefox.
2. Crea un nuovo evento.
3. Fai clic nell'angolo in basso a destra per mostrare i campi aggiuntivi
   
4. Aggiungi un promemoria
   
5. Nel menu a discesa, scegli il Webhook configurato.
6. Fai clic su Salva per salvare le modifiche.

Da ora in poi riceverai un promemoria nella chat associata al Webhook.

Esempi per ottenere un Webhook

kChat

1. Apri l'app kChat.
2. Vai alla sezione delle Integrazioni.
3. Fai clic su Webhook in arrivo:
   
4. Fai clic in alto a destra su Aggiungi.
5. Compila le informazioni richieste per creare il "bot" che invierà messaggi di promemoria in kChat nel canale di tua scelta:
   
6. Salvalo per ottenere l'URL del Webhook:
   
7. Configura la notifica personalizzata in Calendar (leggi sopra se necessario):
   
8. Scegli la tua notifica personalizzata quando aggiungi un promemoria al tuo evento:
   

Slack

1. Apri questa pagina di Slack e accedi con le tue credenziali di Slack.
2. Scegli il canale in cui verranno visualizzati i tuoi promemoria (ad esempio, @slackbot o #general)
   
3. Fai clic su Salva per ottenere l'URL del Webhook.

Crea altri Webhook per impostare promemoria in altre chat.

Personalizzare i promemoria di Slack

Puoi utilizzare liberamente le opzioni di formattazione di Slack nelle tue notifiche. Ad esempio:

Ricordati di includere %subject% per l'%date%.
Segna il giorno dell'evento: %description%.
Luogo dell'evento: %location%

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

Prerequisiti

• disporre di permessi sufficienti per amministrare il prodotto in questione
• invitare un utente a unirsi a kChat

Visualizzare i membri di un canale

Per vedere gli utenti che hanno accesso al canale selezionato:

1. cliccare sull'icona della persona sotto il titolo del canale
2. i partecipanti appariranno in una colonna sul lato destro di kChat
   

Invitare o rimuovere un membro da un canale privato

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

1. cliccare sull'icona della persona sotto il titolo del canale
2. i partecipanti attuali appariranno in una colonna sul lato destro di kChat
3. il pulsante blu Aggiungi consente di invitare un utente di kChat o un team di lavoro completo che non ha ancora accesso a questo canale:
   
4. il pulsante Gestisci consente di rimuovere un membro da questo canale o nominarlo Amministratore del canale affinché possa gestire i membri:
   

Questa guida dettaglia l'uso di smiley e altri emoji per reagire e interagire nelle discussioni del servizio kChat.
 

Aggiungere una reazione a un messaggio
 

Per reagire in qualsiasi momento a qualsiasi messaggio a cui hai accesso su kChat, basta passare il mouse sul messaggio e selezionare uno degli emoji disponibili o l'icona del sorriso con il segno +:

 

Se ci sono già delle reazioni, puoi aggiungerne una nello stesso punto:

In questo modo si aprirà il pannello con centinaia di emoji disponibili (e anche emoji personalizzati - leggi più sotto).
 

Esprimersi con un emoji o GIF

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

 

Poi puoi scegliere un emoji:

 

O inserire brevi GIF animate invece di un emoji utilizzando la scheda in alto nel riquadro che appare quando fai clic sull'icona del viso sorridente:

 

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

Suggerimento: se aggiungi #, ## o ### come primo carattere su una nuova riga contenente un emoji, puoi usare un emoji più grande. Per provarlo, invia un messaggio come '# :smile:' (Nota: le tue impostazioni personalizzate potrebbero "disattivare" questa funzione di visualizzazione sulla tua interfaccia).
 

Per impostare il colore predefinito, fai clic su questo simbolo nel pannello degli emoji:
 

Emoji personalizzati
 

Per gestire emoji aggiuntivi, fai clic su questo pulsante nel pannello degli emoji:

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

Specifica un file .gif, .png o .jpg per il tuo emoji. Il file può pesare fino a 1 MB. Le dimensioni vengono ridimensionate automaticamente a 128 x 128 pixel mantenendo il rapporto d'aspetto.

L'emoji potrà quindi essere utilizzato da tutti gli utenti di kChat nella tua organizzazione in base al nome che gli hai assegnato.

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

Responsabilità delle Parti

Dati Forniti all'IA

• L'IA di Infomaniak è attualmente basata per default su mixtral8x22b
  • GPT4 turbo è un'opzione facoltativa per gli utenti di kChat / Mail
  • 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 indirizzate all'IA sono elaborati esclusivamente in Svizzera tramite l'infrastruttura di Infomaniak
• Nessun dato viene elaborato o condiviso con terzi

Dati Forniti dall'IA

• Il modello linguistico genera testo basandosi sui dati assimilati durante il suo addestramento, privo di coscienza, intenzioni o responsabilità morali
• È cruciale che l'utente sia consapevole che le informazioni generate dal modello non sono sempre accurate e non devono essere considerate come una fonte infallibile di informazioni
• L'utente deve esercitare un giudizio critico e verificare le informazioni fornite dall'assistente con fonti affidabili quando necessario
  • e.g., se una persona utilizza il modello per compiti cruciali come consulenze mediche, legali o finanziarie, deve prendere precauzioni aggiuntive per confermare le informazioni del modello
• In caso di uso inappropriato o pericoloso di questo assistente, la responsabilità ricade sull'utente che intraprende tali azioni

Questa guida dettaglia il principio 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, fai clic sul + a destra di Messaggi diretti per selezionarlo:

Invia il tuo messaggio; se necessario, allega file fino a 100 MB. Puoi anche utilizzare delle “reazioni”.

Menzionare un altro utente

Per menzionare un membro dell'organizzazione (o tutto un team di lavoro) tramite un messaggio, digita il simbolo @ @ per visualizzare le persone o i canali da menzionare. Attenzione, a seconda del tipo di canale, menzionare un utente mostrerà un messaggio che ti permetterà di aggiungerlo alla conversazione, altrimenti non vedrà la menzione.

Richiedere una conferma di lettura

Per consentire agli utenti di confermare la ricezione del tuo messaggio e quindi indicare di aver letto il messaggio, attiva una conferma di lettura prima di inviare il messaggio nel canale, facendo clic sull'icona ⦅!⦆ e poi attivando il pulsante di attivazione:

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

 

Modificare o eliminare un messaggio

Per modificare un messaggio (che conterrà una nota di messaggio modificato), fai clic sul menu di azioni a destra del messaggio da modificare. Nello stesso punto, puoi anche eliminare il tuo messaggio, che scomparirà dalla conversazione per tutti gli utenti:

Organizzare le conversazioni in kChat

Il tipo di ordinamento per gli elementi che gestisci sul lato sinistro dello schermo è molto importante.

Immagina di aprire kChat dopo diversi giorni di assenza; le conversazioni non lette verranno visualizzate una sotto l'altra. Dopo averle lette, potresti voler trovare informazioni lette tra di esse, quindi un ordinamento per attività recente (leggi sotto per altre opzioni) ti permette di trovare 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, appariranno sul lato destro della finestra.

Discussione a thread

In qualsiasi canale o chat privata con un altro utente, puoi avviare una discussione a thread a partire da un altro messaggio semplicemente selezionando Rispondi nel messaggio desiderato.

Si aprirà una discussione a thread a destra, permettendo a ciascun utente del canale di contribuire a questo thread specifico senza disturbare gli eventuali nuovi argomenti del canale in corso:

Questi thread di discussione vengono poi centralizzati per essere letti e riletti nella sezione Thread di discussione nella barra laterale sinistra.

Questa guida riguarda kChat, il servizio di messaggistica istantanea di Infomaniak che consente di scambiare, condividere e coordinare i team in modo sicuro direttamente dal proprio browser web, dispositivo mobile, tablet o computer.

Ottenere kChat

kChat è disponibile con kSuite.

Dopo aver configurato kSuite nella tua organizzazione:

• Scarica l'applicazione kChat per macOS / Windows / Linux o l'app mobile per iOS / Android

e/o

• Utilizza kChat online tramite un browser aggiornato, accedendo al tuo account utente su kchat.infomaniak.com o https://tua-organizzazione.kchat.infomaniak.com/

Leggi la Guida introduttiva (clicca qui).

Infomaniak è un'azienda svizzera certificata ISO 27001 e ISO 9001 conforme al GDPR. Il nostro obiettivo principale è garantire la sicurezza e la riservatezza dei dati che ci vengono affidati. Sono in atto molte misure per garantire la protezione delle tue comunicazioni con kChat:

• il Manager di Infomaniak ti permette di verificare se gli utenti della tua organizzazione hanno attivato l'autenticazione a due fattori
• i dati in attesa e in transito sono crittografati, così come i backup eseguiti automaticamente da Infomaniak
• i dati sono ospitati in Svizzera in data center sviluppati e gestiti esclusivamente da Infomaniak

• ricevi solo messaggi dai tuoi collaboratori o utenti esterni che hai approvato
• puoi creare canali privati per limitare le informazioni sensibili a persone specifiche
• controlli permanentemente i diritti di accesso degli utenti che possono accedere a kChat

Questa guida dettaglia l'uso e la gestione dei canali in kChat.

Un canale kChat è uno spazio di comunicazione dedicato a un progetto, un tema o un team in cui i membri possono scambiarsi documenti, chattare in tempo reale e organizzare videoconferenze.

Canale Generale

Ogni organizzazione in kChat ha automaticamente un canale Generale in cui tutti gli utenti sono automaticamente invitati.

Puoi utilizzare questo canale per condividere informazioni rilevanti per tutta la tua organizzazione, come le uscite aziendali o buone notizie motivanti.

Puoi ovviamente avviare una nuova discussione all'interno del canale Generale.

Canale aggiuntivo

Per aggiungere un nuovo canale di discussione:

1. Fare clic sul pulsante ‍ situato nella barra laterale sinistra di kChat
2. Fare clic su Crea un nuovo canale
   

Informazioni relative a un canale

Quando crei un nuovo canale, puoi scegliere:

 

1. Il suo nome

Potrà essere modificato in seguito.

2. Il suo URL

Per impostazione predefinita, prende il nome del canale, ma puoi cambiarlo utilizzando lettere minuscole, numeri, punti, trattini e underscore - modificabile anche in seguito.

3. Il suo stato Privato o Pubblico

Potrà essere modificato in seguito (leggi sotto).

4. La sua descrizione

La descrizione spiega come dovrebbe essere utilizzato questo canale. Questo testo appare nell'elenco dei canali nel menu "Altro..." e fornisce una guida agli utenti per sapere se devono unirsi al canale o meno.

Una volta creato il canale, puoi anche impostare:

5. Una intestazione

Differenze tra canali Privati e Pubblici

I canali Pubblici aumentano la trasparenza. Tutti gli utenti possono vedere e unirsi a un canale pubblico, assicurando che tutte le persone interessate a un progetto, tema o team abbiano accesso alle stesse informazioni.

I canali Privati consentono di restringere il contenuto sensibile agli utenti selezionati. Solo un membro esistente può invitare un altro utente a un canale privato. Ci sono anche differenze nella gestione dell'archiviazione/ eliminazione (leggi sotto).

Convertire un canale pubblico in un canale privato

Per trasformare un canale Pubblico in un canale Privato:

1. Fare clic sul canale Pubblico nella barra laterale sinistra
2. Quindi fare clic sul titolo del canale nella parte superiore della chat
3. Selezionare Converti
   

La cronologia e l'appartenenza sono conservate; i file condivisi pubblicamente rimangono accessibili a chiunque disponga del link; il cambiamento è permanente e non può essere annullato.

E il contrario?

Il contrario (cambiare un canale privato in un canale pubblico) è anche possibile, ma solo un amministratore kChat può farlo; la cronologia dei messaggi è conservata.

Lasciare un canale

Ad eccezione del canale principale intitolato Generale, puoi lasciare un canale in qualsiasi momento:

1. Fare clic sul menu azione ⋮ a destra del canale interessato (nella barra laterale sinistra)
2. Fare clic su Lascia il canale
   
    

Se lasci un canale privato, non lo troverai più nella ricerca ma solo tramite il suo URL se lo possiedi o venendo re-invitato da un membro del canale.

Se lasci un canale pubblico, lo lasci immediatamente ma puoi unirti di nuovo quando vuoi semplicemente trovandolo per nome nella ricerca, anche se è stato archiviato.

 

Archiviare/ eliminare un canale

Ad eccezione del canale principale intitolato Generale, puoi archiviare un canale in qualsiasi momento, il che impedisce nuovi messaggi e non lo conta più nella tua quota di canali disponibili:

1. Fare clic sul canale nella barra laterale sinistra
2. Quindi fare clic sul titolo del canale nella parte superiore della chat
3. Fare clic su Archivia il canale
   

Se crei un canale e poi lo archivi, puoi unirti a esso quando vuoi semplicemente trovandolo per nome nella ricerca: 

Puoi quindi riattivarlo:

o chiuderlo per non vederlo più nella tua interfaccia:

Preferiti

Per mettere qualsiasi canale tra i preferiti basta fare così:

1. Fare clic sulla stella situata in alto in un canale
2. Un nuovo menu Preferiti apparirà nella barra laterale sinistra, raggruppando tutti gli elementi che hai messo tra i preferiti (valido solo per il tuo utente)
   

Silenziare un canale

Puoi nascondere le notifiche di un canale:

1. Fare clic sul menu azione ⋮ a destra del canale interessato (nella barra laterale sinistra)
2. Selezionare Silenzia
   
   
   
    

Organizzare per categorie

Facendo clic sul pulsante + situato nella barra laterale sinistra di kChat, puoi aggiungere una o più categorie che ti permettono di posizionare elementi (canale, contatto, ecc.) all'interno di esse. Quindi trascina il canale desiderato sulla categoria creata (valido solo per il tuo utente):

Canale di chat da utente a utente

I messaggi personali sono conversazioni dirette tra due o più persone che avvengono fuori dai canali.

Ogni utente di un'organizzazione può liberamente creare messaggi personali il cui contenuto sarà visibile solo alle persone coinvolte.