Rispondi in Slack con il tuo agente AI

Il tuo agente può rispondere in Slack: menzionalo in un canale, oppure inviagli un messaggio diretto, e risponde nel thread con la stessa conoscenza, le stesse istruzioni, azioni e regole del widget. Ogni thread di Slack è una conversazione nella scheda Conversations dell'agente, con un badge Slack, e il tuo team può prenderla in carico dall'Inbox.

Piano

L'agente Slack è disponibile da Starter in su. Con Free, il riquadro Slack mostra una nota per passare a un piano superiore e non si può collegare nessun workspace. Dopo un downgrade a Free, un workspace collegato resta salvato, ma l'agente smette di rispondere lì, e il tuo team non può rispondere nei suoi thread da intoCHAT, finché non passi di nuovo a un piano superiore.

Ogni risposta dell'IA in Slack conta sul tuo piano esattamente come nel widget: un messaggio con il modello predefinito, di più con un modello più grande. Le risposte del tuo team non contano. Quando i tuoi messaggi finiscono, l'agente pubblica nel thread lo stesso avviso del widget ("Message limit reached…"), al massimo una volta ogni 10 minuti per thread; un agente che ha raggiunto il suo tetto mensile pubblica "This chat has reached its limit for now". Vedi Piani e limiti.

Collegare Slack

Ti serve il permesso di installare app nel tuo workspace Slack. Alcuni workspace chiedono che un admin approvi prima le nuove app.

1. Apri il tuo agente, vai alla scheda Share e trova il riquadro Slack.
2. Clicca su Add to Slack. Si apre la schermata di installazione di Slack.
3. Scegli il tuo workspace se fai parte di più workspace, controlla cosa potrà fare intoCHAT e clicca su Allow.
4. Torni alla scheda Share, che mostra "Slack connected" e il nome del workspace.

Poi provalo:

• Messaggio diretto: apri l'app intoCHAT in Slack (sotto Apps nella barra laterale) e inviale una domanda.
• Canale: invita l'app in un canale con /invite @intochat, poi menzionala: @intochat what are your opening hours?

Se annulli nella schermata di Slack, non viene collegato nulla. Se lì impieghi più di 10 minuti, ricomincia da Add to Slack.

Collegare e scollegare richiede il livello Manage per le integrazioni, quindi possono farlo il proprietario e gli admin. Tutti nell'account vedono quale workspace è collegato. Vedi Membri del team e ruoli.

Un workspace, un agente. Un workspace Slack risponde per un solo agente alla volta, e un agente ha al massimo un workspace. Il collegamento di un workspace che risponde già per un altro agente intoCHAT viene rifiutato con "This Slack workspace is already connected to another intoCHAT agent"; scollegalo prima da lì. Se non puoi, perché quell'agente appartiene all'account di qualcun altro, rimuovi l'app intoCHAT in Slack in Manage apps e poi clicca di nuovo su Add to Slack: un workspace la cui app è stata rimossa non è più vincolato all'altro agente. Per spostare un agente su un altro workspace, scollega il primo.

A cosa risponde

• Messaggi diretti all'app: ogni messaggio.
• Canali: solo i messaggi che menzionano l'app (@intochat …), nei canali pubblici e privati in cui l'app è stata invitata. All'interno di un thread, menzionala di nuovo per ogni domanda; i messaggi senza menzione non vengono letti.
• I messaggi di altre app e bot, i messaggi dell'app stessa, i messaggi modificati ed eliminati, e un messaggio che contiene solo la menzione, senza una domanda, non ricevono risposta.

La menzione viene rimossa prima che l'agente legga il messaggio. Le altre menzioni, i nomi dei canali e i link vengono passati come testo leggibile.

L'agente scrive testo:

• Le risposte usano la formattazione di Slack: grassetto, elenchi puntati, codice e link cliccabili.
• I pulsanti e le schede prodotto delle tue azioni vengono pubblicati come link sotto la risposta, e le risposte arricchite come testo semplice.
• Moduli, modulo dei lead, carrelli, orari di prenotazione, domande di approfondimento e link alle fonti non si possono mostrare in Slack, quindi lì l'agente non li propone. Le azioni API lato server, le procedure, il passaggio via email e le ricerche degli ordini funzionano come nel widget. Le azioni lato client, che vengono eseguite in una pagina web, non vengono proposte.
• L'agente legge solo il testo di un messaggio. File e immagini nei messaggi Slack vengono ignorati.

Thread

L'agente risponde sempre in un thread: sotto il messaggio in cui gli è stata fatta la domanda, oppure nel thread in cui è stata posta la domanda.

• Un thread è una conversazione. Alle domande successive nello stesso thread risponde tenendo conto dei messaggi precedenti di quel thread, come nel widget. Un nuovo messaggio di primo livello (un nuovo messaggio diretto o una nuova menzione nel canale) avvia una nuova conversazione.
• Chi ha avviato il thread è il visitatore della conversazione; l'Inbox mostra il suo nome visualizzato di Slack. Quando qualcun altro scrive nel thread, il suo messaggio viene salvato con il suo nome davanti.

Passaggio e presa in carico da parte del team

Quando qualcuno chiede di parlare con una persona e il passaggio via email è attivo, l'agente passa la conversazione al tuo team come nel widget, e la conversazione entra nell'Inbox. Puoi anche spostare tu stesso qualsiasi conversazione Slack nell'Inbox.

Apri una conversazione Slack nell'Inbox o nella scheda Conversations. Sotto la trascrizione:

• La casella di risposta pubblica il tuo messaggio nel thread di Slack come app intoCHAT, con il tuo nome in grassetto davanti, per esempio "Anna: I've refunded your order." Viene salvato nella trascrizione con il tuo nome e "team, Slack", e mette in pausa l'IA.
• Pause AI impedisce all'agente di rispondere a questo thread. I nuovi messaggi vengono comunque salvati, così il tuo team li vede, ma non ricevono una risposta dell'IA. Resume AI restituisce il thread all'agente.
• L'IA riprende da sola 24 ore dopo l'ultima pausa o risposta del tuo team, al messaggio successivo nel thread.

Mettere in pausa, riattivare e rispondere spetta a tutti quelli che possono gestire le conversazioni: il proprietario, gli admin e gli editor. Slack non ha una finestra di risposta, quindi il tuo team può rispondere a un thread in qualsiasi momento finché Slack è collegato.

Limiti

• Un workspace può inviare all'agente fino a 300 messaggi all'ora. Gli altri messaggi di quell'ora vengono salvati per il tuo team senza una risposta dell'IA. I limiti generali del tuo agente valgono comunque.
• Ai messaggi si risponde man mano che arrivano, di solito entro pochi secondi; un'azione lenta o un modello più grande può allungare i tempi. Le risposte lunghe vengono divise in più messaggi.
• Un agente privato non risponde in Slack; dopo il primo messaggio il riquadro Slack mostra una nota che lo indica.
• Se l'app viene rimossa dal workspace o il suo accesso viene revocato in Slack, il riquadro mostra Needs attention con il motivo indicato da Slack. Scollega e clicca di nuovo su Add to Slack.
• Le conversazioni Slack mostrano channel come slack nella REST API, nel server MCP, nel filtro per canale dell'Inbox e in Interroga le tue conversazioni.

Privacy

• intoCHAT legge solo ciò che Slack gli invia: i messaggi che menzionano l'app e i messaggi diretti all'app. Non legge gli altri messaggi dei canali e non importa la tua cronologia di Slack.
• Per ogni conversazione intoCHAT conserva i messaggi a cui ha risposto o che ha ricevuto, l'ID utente Slack di chi ha avviato il thread e il suo nome visualizzato (recuperato con users.info di Slack). Vengono conservati ed eliminati come qualsiasi altra conversazione.
• I messaggi vengono inviati al modello di IA per scrivere la risposta, come i messaggi del widget. Vedi Come nascono le risposte.
• Il token Slack dell'app viene conservato in forma cifrata, non viene mai mostrato nella dashboard e serve solo a pubblicare le risposte e a recuperare i nomi visualizzati.
• Disconnect nel riquadro Slack revoca il token presso Slack e lo elimina. L'agente smette di rispondere in quel workspace; le conversazioni precedenti restano nella scheda Conversations. Puoi anche rimuovere l'app in Slack, in Manage apps.

Per chi gestisce la piattaforma: l'app Slack

Questa sezione è per chi gestisce il server di intoCHAT, non per i proprietari degli agenti. L'app si crea dal manifest in integrations/slack/manifest.json; integrations/slack/README.md contiene i passaggi.

Variabili d'ambiente (solo i nomi; non mettere mai i valori nel codice):

Senza le tre variabili SLACK_, il riquadro Slack non viene mostrato e l'URL degli eventi risponde 404. L'URL di reindirizzamento OAuth si basa su NEXT_PUBLIC_APP_URL e deve corrispondere a quello dell'app: https://<your domain>/api/integrations/slack/callback. Gli eventi vanno a https://<your domain>/api/integrations/slack/events.

L'app si installa dal pulsante Add to Slack di intoCHAT stesso una volta attivata la distribuzione pubblica nelle impostazioni dell'app. Non serve pubblicarla nello Slack Marketplace, né la revisione di Slack prevista per farlo.