Personalizza il bot di chat
Questa guida mostra come rimodellare l’app del bot lato provider senza uscire da Control Center.
Prerequisiti
Sezione intitolata “Prerequisiti”- Il ruolo
owneroadminnello spazio di lavoro - Un provider connesso. La riga Personalizza il bot compare solo quando lo spazio di lavoro è connesso
- Un’app che Control Center possa gestire. Per Slack questo significa che la connessione contiene un token di aggiornamento della configurazione dell’app (
xoxe-…); se non lo contiene, la riga lo dice e resta disattivata
Cosa puoi cambiare
Sezione intitolata “Cosa puoi cambiare”| Campo | Significato | Limite |
|---|---|---|
| Nome dell’app | Come il provider elenca l’app | 1–35 caratteri |
| Nome del bot (ciò che si digita dopo @) | Ciò che i membri digitano dopo @ |
1–80 caratteri |
| Descrizione breve | Una riga che il provider mostra | 140 caratteri o meno |
| Ciò che il bot dice di saper fare | Mostrato sopra un messaggio diretto con il bot | 300 caratteri o meno |
| Comando | Il comando che i membri invocano, senza la barra | In minuscolo, solo a–z 0–9 _ -, troncato a 32 caratteri |
| Messaggi diretti | Se il bot espone l’esperienza di messaggi diretti e agente | Attivo o disattivo |
Control Center convalida i quattro campi di testo prima di chiamare il provider,
così ottieni «the app name must be between 1 and 35 characters» invece di un
opaco invalid_manifest da un server che non puoi vedere. Il comando non viene
rifiutato ma normalizzato: una barra iniziale viene rimossa, il resto passa in
minuscolo, tutto ciò che sta fuori da a–z 0–9 _ - viene eliminato e un
risultato vuoto ripiega su cc.
Modifica il bot
Sezione intitolata “Modifica il bot”- Vai in Impostazioni → Spazio di lavoro → Generale e scorri fino alla scheda Ponti di chat
- Nel blocco del provider, fai clic su Personalizza il bot
- La finestra si apre sui valori live dell’app, riletti dal provider — quindi il punto di partenza è una modifica che qualcuno ha fatto nell’interfaccia di Slack stessa
- Modifica ciò che ti serve e salva
Leggere quei valori live costa una rotazione di token lato Slack, ed è per questo che la riga richiede un clic deliberato invece di essere qualcosa che la pagina fa al caricamento.
La scrittura sovrappone le tue modifiche alla definizione attuale dell’app. Tutto ciò che Control Center non modella — un secondo comando slash che hai aggiunto in Slack, un passaggio di workflow, un’impostazione che non c’entra — sopravvive intatto. Scope ed eventi vengono uniti, mai sottratti.
Dopo il salvataggio, Control Center rilegge l’identità del bot, così il nome nelle impostazioni corrisponde al nome nell’app di chat.
Reinstalla quando cambiano i permessi
Sezione intitolata “Reinstalla quando cambiano i permessi”Quando un salvataggio cambia i permessi, la finestra resta aperta e dice «Slack ha modificato i permessi dell’app. Reinstallala perché abbiano effetto», con un pulsante Reinstalla l’app che apre la pagina di installazione nel team di Slack per quell’app. In Slack la voce è Install App → Reinstall to Workspace.
Rinomina il comando slash
Sezione intitolata “Rinomina il comando slash”Cambia Comando e salva. Il ponte scrive poi le istruzioni usando il comando con cui è stato invocato l’ultima volta, quindi il testo di aiuto e le istruzioni di collegamento seguono la rinomina invece di nominare un comando che non esiste più.
La rinomina non rompe i thread già collegati tramite il ponte: i thread sono indicizzati per conversazione, non per comando.
Cosa Control Center non cambia
Sezione intitolata “Cosa Control Center non cambia”- Impostazioni strutturali. Il trasporto (Socket Mode), gli scope richiesti e le sottoscrizioni agli eventi sono imposti, non offerti. Un’app che si può configurare fino a farla tacere da una schermata di impostazioni è un ticket di assistenza, non una funzione
- L’icona del bot. Può cambiarla solo l’impostazione dell’app del provider, e la finestra lo dice
- Le migrazioni delle funzionalità del provider. Un’app già sulla vecchia forma di assistente di Slack la mantiene; questa finestra modifica una descrizione, non migra un’app
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”La riga Personalizza il bot non compare affatto
Sezione intitolata “La riga Personalizza il bot non compare affatto”Lo spazio di lavoro non è ancora connesso. La riga compare solo quando il blocco del provider mostra una connessione attiva. Vedi Configura l’integrazione Slack.
La riga Personalizza il bot è disattivata
Sezione intitolata “La riga Personalizza il bot è disattivata”La connessione non ha alcuna credenziale di gestione dell’app — il sottotitolo della riga dice «Control Center ha bisogno di un token di configurazione dell’app per modificare il bot. Riconnettiti includendone uno.» Per Slack, genera una coppia di token di configurazione dell’app su api.slack.com/apps e riconnettiti con il token di aggiornamento compilato. È previsto per un’app costruita a mano o creata tramite Crea in Slack, perché Slack non segnala mai quale app ha creato.
«Control Center does not know which app to edit»
Sezione intitolata “«Control Center does not know which app to edit»”La connessione archiviata non porta alcun id dell’app — tipicamente un’app connessa a mano prima che un id venisse registrato. Riconnetti lo spazio di lavoro, oppure crea l’app da Control Center.
Il nuovo nome del bot non è comparso nella chat
Sezione intitolata “Il nuovo nome del bot non è comparso nella chat”I provider mettono brevemente in cache i metadati dell’app. Se il nome è ancora vecchio dopo un minuto, controlla se il salvataggio ti ha chiesto di reinstallare l’app.