Base di conoscenze

Grazie per aver scelto Infomaniak e kChat come soluzione di discussione tra te, il tuo entourage o la tua azienda! Queste guide ti aiuteranno a organizzare i tuoi canali, utenti, chat e altro ancora!

Preambolo

• Multipiattaforma, kChatè la messaggistica istantanea di kSuite che consente di scambiare, condividere e coordinare i tuoi team in modo sicuro da...
  • ... il tuo browser web
  • ... il tuo dispositivo iOS / Android
  • ... il tuo tablet mobile o il tuo computer macOS / Windows / Linux
• Scarica l'app kChat sui vostri dispositivi!
  • Non è possibile modificare la posizione della cartella kchat-desktop sul tuo hard disk.
  • Il contenuto di discussioni, foto, video, è memorizzato online sui server sicuri di Infomaniak.

Cosa vuoi fare?

• Impostare kChat
• Gestire gli utenti
• Gestire un canale
• Gestire una conversazione
• Reagire ai messaggi
• Gestire le notifiche kChat
• Formattare i messaggi e inserire le 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, si prega di consultare la base di conoscenza prima di Contattare il supporto.
• Clicca qui per condividere una recensione o un 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 dell'evento dall'app Web Calendar Infomaniak (servizio online calendar.infomaniak.com) su un sistema di discussione come kChat di Slack.

Preambolo

• Questa funzionalità vi permetterà di essere notificato nel thread di discussione di vostra scelta Quando un evento è vicino.
• Il sistema di webhook è un metodo in 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 chat 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 Aggiungere un Webhook:
   
    
5. Definisci:
   
   1. Un nome per identificare facilmente il Webhook quando si aggiungono promemoria.
   2. L'URL del webhook (ottenuto dal tuo sistema di discussione - esempi sono riportati in basso nelle 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 per chat

Ora che Calendar è collegato al tuo account di sistema di chat, puoi scegliere di essere avvisato 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 Mostra campi aggiuntivi:
   
4. Aggiungi un Richiamo:
   
5. Nel menu a discesa, Scegli il webhook configurato.
6. Valida le modifiche.

Ora riceverai un promemoria nella chat corrispondente al webhook.

Esempi per ottenere un webhook

kChat

1. Clicca qui‍ Al fine di accedere a l'app web kChat (Servizio online kchat.infomaniak.com) oppure apri l'app desktop kChat (applicazione desktop su macOS / Windows / Linux).
2. Appuntamento nella partita Integrazioni.
3. Clicca su Webhooks in arrivo :
   
4. Clicca in alto a destra su Aggiungi.
5. Completa le informazioni richieste al fine di creare il "bot" che mostrerà i messaggi di rilancio in kChat nel canale di vostra scelta:
   
6. Salva per ottenere l'URL del webhook:
   
7. Crea la notifica personalizzata in Calendar (leggi di più se necessario):
   
8. Seleziona la notifica personalizzata quando aggiungi un promemoria al tuo evento:
   

Slack
 

1. Clicca quiper accedere ai WebHooks Slack.
2. Scegli il thread in cui verranno visualizzati i promemoria (ad es. slackbot oppure general):
   
3. Salva per ottenere l'URL del webhook.

Crea altri webhook per impostare promemoria in altri thread.

Personalizza i rilanci di un promemoria Slack

Puoi utilizzare liberamente le opzioni di formattazione di Slack nelle vostre notifiche. Esempio:

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

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

Scopri di più su quest'altra guida se si desidera gestire i canali a cui dovranno automaticamente appartenere i nuovi membri.

Prerequisiti

• Avere permessi sufficienti per amministrare il prodotto in questione.
• Invitare un utente Entra a far parte di kChat.

Vedere i membri di un canale

Per vedere gli utenti che hanno accesso al canale selezionato:

1. Clicca qui‍ Al fine di accedere a l'app web kChat (Servizio online kchat.infomaniak.com) oppure apri l'app desktop kChat (applicazione desktop su macOS / Windows / Linux).
2. Fare clic sull'icona del personaggio sotto il titolo del canale.
3. I partecipanti vengono visualizzati nella colonna a destra di kChat:
   

Invitare o rimuovere un membro su un canale privato

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

1. Fare clic sull'icona del personaggio sotto il titolo del canale.
2. I partecipanti attuali vengono visualizzati nella colonna a destra di kChat.
3. Il pulsante blu Aggiungi consente di invitare un utente kChat o una team di lavoro completo, non avendo ancora accesso a questo canale:
   
4. Il pulsante Gestione 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 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, in particolare kChat, kDrive, Mail, Sito Creator…

Responsabilità delle parti

Dati forniti all'IA

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

Dati forniti dall'IA

• Il modello linguistico genera testo basandosi sui dati che ha assimilato durante il suo apprendimento, privo di coscienza, intenzioni o responsabilità morali.
• È fondamentale che l'utente sia consapevole che le informazioni generate dal modello non sono sempre accurate e non devono essere considerate come una fonte di informazioni indiscutibile.
• Deve esercitare il suo discernimento 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 consulenza medica, legale o finanziaria, deve prendere ulteriori precauzioni per confermare le informazioni provenienti dal modello.
• In caso di utilizzo inappropriato o pericoloso di questo assistente, la responsabilità è dell'utente che intraprende tali azioni.

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

Riassumere automaticamente un messaggio kChat

Per ottenere il riassunto di un messaggio kChat:

1. Sorvola il messaggio e seleziona l'icona delle azioni di IA in alto a destra.
2. Clicca su Riassumere il thread:
   ‍
3. Ottieni il riepilogo, generato da IA e inviato da kChat Bot nel riquadro laterale destro:
   

Scopri di più su quest'altra guida circa gli agenti conversazionali di kChat.

Questa guida illustra il principio delle conversazioni kChatOrganizzato all'interno di Canali di discussione privati e pubblici, e discussioni dirette tra gli utenti.

Inizia una conversazione

Per scrivere a un utente della tua organizzazione, fai clic sul + a destra dei Messaggi diretti per selezionarlo:

Inviare il messaggio; se necessario allegare file fino a 100 MB. È inoltre possibile utilizzare i “reazioni”.

Menzione di un altro utente

Per sollecitare uno dei membri dell'organizzazione (o tutta una team di lavoro) tramite un messaggio, digitare l'arobase @ per mostrare le persone o i canali da menzionare. Attenzione, a seconda del tipo di canale interessato, la menzione di un utente mostra un messaggio che consente di aggiungerlo alla discussione altrimenti non vedrà la menzione.

Chiedere un imputato di lettura

Affinché gli utenti possano confermare la ricezione del messaggio e quindi segnalare di aver letto il messaggio, attivare un avviso di lettura prima dell'invio del messaggio sul canale, facendo clic sull'icona (!) Attivando il pulsante di accensione (toggle switch):

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

 

Modificare o eliminare un messaggio

Per modificare un messaggio (che poi conterrà una menzione di messaggio modificato), fare clic sul menu di azione a destra del messaggio da modificare. Nello stesso posto, puoi anche eliminare il tuo messaggio che poi scomparirà dalla discussione a tutti gli utenti:

Organizzare le conversazioni in kChat

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

Immagina di aprire kChat dopo diversi giorni di assenza, le conversazioni non lette appariranno l'una sotto l'altra. Dopo la lettura di queste, potresti voler trovare un'informazione letta tra una di esse, così una selezione per attività recente p.ex (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.

Cerca una conversazione

La ricerca di elementi (parola, partecipante, file) si trova nella parte superiore della finestra:

Una volta che i risultati sono stati trovati, appaiono sulla destra della finestra.

Filo di discussione (thread)

Indipendentemente dal canale o dalla chat privata con un altro utente, puoi avviare un thread da un altro semplicemente scegliendo Rispondi sul messaggio desiderato.

Un thread di discussione si aprirà sulla vostra destra permettendo ad ogni utente del canale di portare le sue parole in questo particolare filo senza disturbare eventuali nuovi argomenti del canale in corso:

Questi fili di discussione sono poi centralizzati per essere letti e riletti nella parte Fili 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 implementato 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.