Canali

Cosa Sono i Canali?

I canali sono le piattaforme di comunicazione che i tuoi agenti di Neotask utilizzano per inviare e ricevere messaggi. Connettendo un canale, dai a un agente la capacità di ascoltare i messaggi in arrivo su quella piattaforma e rispondere in tempo reale.

Concetti chiave:

• Configurazione per agente -- Ogni connessione al canale è configurata a livello di agente. Un agente può essere connesso a Slack mentre un altro gestisce Discord, oppure un singolo agente può essere connesso a più canali contemporaneamente.
• Bidirezionale -- I canali supportano sia l'invio che la ricezione di messaggi. Gli agenti possono rispondere ai messaggi in arrivo, avviare messaggi in uscita, o entrambe le cose.
• Multi-account -- Puoi connettere più account per lo stesso tipo di canale (ad esempio, due workspace Slack diversi o più indirizzi email).

Canali Supportati

Connettere un Canale

Il processo di connessione varia in base al metodo di autenticazione del canale.

Flusso OAuth

Usato da: Slack, Microsoft Teams, Google Chat, Email / Gmail

1. Apri la scheda Canali dell'agente.
2. Clicca su Connetti accanto al canale che vuoi aggiungere.
3. Verrai reindirizzato alla pagina di autorizzazione del servizio.
4. Accedi con il tuo account e concedi ad Neotask le autorizzazioni richieste.
5. Dopo l'autorizzazione, vieni reindirizzato alla dashboard e il canale appare come connesso.

Per le piattaforme mobili, è disponibile un'opzione con codice QR. Scansiona il codice QR dal tuo telefono per completare l'autorizzazione senza dover accedere nel browser del tuo desktop.

Token Bot

Usato da: Discord, Telegram

1. Crea un bot sulla rispettiva piattaforma:
   • Discord -- Crea un'applicazione nel Discord Developer Portal e genera un token bot.
   • Telegram -- Invia un messaggio a @BotFather su Telegram per creare un bot e ricevere un token.
2. Apri la scheda Canali dell'agente e clicca su Connetti accanto al canale.
3. Incolla il token bot nel campo del token.
4. Clicca su Salva per stabilire la connessione.

Codice QR

Usato da: WhatsApp

1. Apri la scheda Canali dell'agente e clicca su Connetti accanto a WhatsApp.
2. Apparirà un codice QR sullo schermo.
3. Apri WhatsApp sul tuo telefono, vai su Dispositivi Collegati e scansiona il codice QR.
4. La connessione viene stabilita quando il tuo telefono conferma il collegamento.

Chiave API

Usato da: SMS

1. Ottieni una chiave API dal tuo provider SMS (ad esempio, Twilio, Vonage).
2. Apri la scheda Canali dell'agente e clicca su Connetti accanto a SMS.
3. Inserisci la tua chiave API e qualsiasi campo aggiuntivo richiesto (ad esempio, numero di telefono, account SID).
4. Clicca su Salva per attivare il canale.

Token

Usato da: Matrix, Line, Zalo

1. Genera un token di accesso dalle impostazioni sviluppatore o dal pannello admin della rispettiva piattaforma.
2. Apri la scheda Canali dell'agente e clicca su Connetti accanto al canale.
3. Incolla il token nel campo del token.
4. Clicca su Salva per stabilire la connessione.

Configurazione del Server

Usato da: IRC

1. Apri la scheda Canali dell'agente e clicca su Connetti accanto a IRC.
2. Inserisci l'indirizzo del server, la porta, il nickname e (facoltativamente) una password.
3. Specifica i canali a cui unirti alla connessione.
4. Clicca su Salva per connetterti.

Applicazione Locale

Usato da: Signal, iMessage

1. Assicurati che l'applicazione richiesta sia installata e in esecuzione sulla macchina host:
   • Signal -- Signal Desktop deve essere installato e collegato al tuo account Signal.
   • iMessage -- Richiede un host macOS con Messages.app configurato.
2. Apri la scheda Canali dell'agente e clicca su Connetti accanto al canale.
3. Neotask rileverà l'applicazione locale e stabilirà una connessione.
4. Se l'applicazione non viene rilevata, ti verrà chiesto di installarla o configurarla.

Test della Connessione

Dopo aver connesso qualsiasi canale, Neotask esegue automaticamente una verifica della latenza per verificare la connessione:

• Viene inviato e ricevuto un messaggio di test tramite l'API del canale.
• Viene misurata e visualizzata la latenza round-trip.
• Se il test fallisce, un messaggio di errore descrive il problema (ad esempio, token non valido, concessione OAuth scaduta, server non raggiungibile).

Puoi rieseguire il test di connessione in qualsiasi momento dalle impostazioni del canale.

Operazioni sul Canale

Una volta connesso un canale, puoi gestirlo dalla scheda Canali dell'agente.

Abilita / Disabilita

Attiva o disattiva un canale senza disconnetterlo. Quando disabilitato:

• L'agente smette di ascoltare i messaggi su quel canale.
• Nessun messaggio in uscita viene inviato attraverso di esso.
• Le credenziali di connessione vengono preservate così puoi riabilitare in qualsiasi momento senza riconfigurare.

Test della Connettività

Esegui un test di connettività su richiesta per verificare che il canale sia raggiungibile e reattivo. Il test:

• Invia una richiesta API leggera al servizio del canale.
• Misura la latenza round-trip in millisecondi.
• Riporta il risultato come Connesso (con latenza) o Fallito (con dettagli dell'errore).

Visualizza la Latenza

Ogni canale connesso mostra la sua lettura di latenza più recente nella scheda Canali. Questo ti aiuta a identificare connessioni lente o degradate a colpo d'occhio. La latenza viene aggiornata:

• Automaticamente dopo ogni test di connessione.
• Periodicamente in background mentre il canale è attivo.

Disconnetti / Logout

Per rimuovere completamente una connessione al canale:

1. Clicca su Disconnetti accanto al canale.
2. Conferma l'azione nella finestra di dialogo.
3. Neotask revoca o elimina le credenziali archiviate (i token OAuth vengono revocati lato provider dove supportato).
4. Il canale viene rimosso dall'elenco dei canali attivi dell'agente.

Per riconnetterti dopo la disconnessione, segui di nuovo i passaggi di connessione originali.