Bot Discord
Chatta a tu per tu nei messaggi diretti, oppure metti i personaggi in un server e decidi chi può parlarci e chi paga.
Il bot di Reverie porta i personaggi in due posti di Discord: i tuoi messaggi diretti con il bot, per le chat a tu per tu, e i canali dei server, dove ogni personaggio parla con il proprio nome e il proprio avatar. Chiunque parli con un personaggio ha bisogno di un account Reverie collegato al proprio account Discord (ne basta uno gratuito), e ogni risposta viene addebitata in crediti a un account Reverie.
Collegare il tuo account
Un account Discord corrisponde a esattamente un account Reverie. Una qualsiasi di queste strade li unisce:
- Dalla dashboard delle integrazioni. Nell'app, vai su Labs → Bot Discord e Telegram e premi Collega con Discord sulla scheda di Discord. Confermi su Discord e torni subito indietro.
- Accedendo con Discord. Accedere a Reverie con Discord collega anche il bot, a meno che tu non l'abbia scollegato dalla dashboard: in quel caso resta scollegato finché non lo ricolleghi tu.
- Da Discord. Esegui
/link-accountin un server o nei tuoi messaggi diretti con il bot. Solo tu vedi la risposta: un pulsante Collega il mio account che funziona una volta sola e scade dopo 10 minuti. Aprilo, accedi, e gli account sono uniti.
Chattare a tu per tu nei messaggi diretti
Manda un messaggio diretto al bot, oppure esegui /chat in un qualsiasi server in cui c'è il bot: la conversazione passa nei tuoi messaggi diretti, dove la vedi solo tu. /chat da solo propone dei personaggi fra cui scegliere; aggiungi un nome per cercarne uno.
- Un personaggio alla volta.
/chatpassa a qualcun altro, e/chatselenca i personaggi con cui hai parlato nei messaggi diretti. Ognuno conserva la propria conversazione, quindi tornando riprendi da dove avevi lasciato. - Ogni messaggio riceve una risposta, pubblicata dal bot con il nome del personaggio in piccolo sopra. Immagini, messaggi vocali e memoria funzionano come in un canale.
- Paghi tu i tuoi messaggi. Le modalità di pagamento e i limiti del server qui non valgono.
- Niente personaggi 18+. Un messaggio diretto non può essere segnato con limite di età, quindi i personaggi 18+ non chattano mai nei messaggi diretti.
/remove-characterchiude la conversazione in corso (resta salvata per/chats), e/reset-chatla cancella dopo averti chiesto conferma.- Fra i sottocomandi di
/settings, solomodel,languageechat-stylevalgono nei messaggi diretti.
Se il bot dice di non essere riuscito a scriverti, consenti i messaggi diretti dai membri del server nelle impostazioni della privacy di Discord e riprova. Le tue conversazioni recenti nei messaggi diretti compaiono anche nella dashboard delle integrazioni sotto Chat privata, dove Continua sul web ne riprende una nel browser.
Aggiungere il bot a un server
Invitare il bot
Premi Aggiungi Bot al Server sulla scheda di Discord nella dashboard delle integrazioni e scegli un server. Lascia spuntati tutti i permessi richiesti: la tabella qui sotto spiega a cosa serve ciascuno. Appena entra, il bot pubblica un breve messaggio introduttivo dove il server mostra i messaggi di benvenuto.
Aggiungere un personaggio a un canale
In un canale testuale, esegui /add-character e scegli un personaggio dal completamento automatico: comprende i personaggi pubblici e i tuoi personaggi privati. Ti servono il permesso Manage Channels e un account collegato. Il bot crea un webhook perché il personaggio possa pubblicare con il proprio nome, poi manda un saluto.
Fissare le regole
Facoltativo. /settings decide come rispondono i personaggi di un canale e chi li paga; /server decide chi può parlarci in assoluto. Entrambi sono spiegati più sotto.
Permessi che l'invito richiede
| Permesso | Perché viene richiesto |
|---|---|
| View Channels | Leggere il canale in cui si usa il bot |
| Send Messages | Pubblicare risposte e output dei comandi |
| Manage Messages | Togliere le risposte del personaggio quando il messaggio che le ha provocate viene cancellato |
| Embed Links | L'output dei comandi e gli annunci dell'estrazione della community sono incorporati |
| Manage Roles | Assegnare il ruolo usato dall'estrazione della community nel server di Reverie |
| Manage Webhooks | Obbligatorio. I personaggi parlano attraverso un webhook per ciascuno |
Senza Manage Webhooks, /add-character fallisce e il personaggio non viene aggiunto.
Comandi
In un server, i comandi segnati Manage Channels o Manage Server vengono proposti solo ai membri con quel permesso di Discord. Le risposte ai comandi dell'account e di gestione le vedi solo tu.
| Comando | Opzioni | Dove | Cosa fa |
|---|---|---|---|
/help | — | server, DM | Elenca i comandi, in privato |
/link-account | — | server, DM | Pubblica un link monouso per unire i tuoi account Discord e Reverie |
/chat | name (facoltativo) | server, DM | Sceglie o cambia il personaggio dei tuoi messaggi diretti. In un server, manda la scelta nei tuoi messaggi diretti |
/chats | — | server, DM | I personaggi con cui hai parlato nei messaggi diretti, per passare dall'uno all'altro |
/add-character | name (obbligatorio) | server · Manage Channels | Aggiunge un personaggio a questo canale e lo fa salutare |
/remove-character | name (obbligatorio) | server · Manage Channels, DM | Rimuove il personaggio ed elimina il suo webhook. Nei messaggi diretti, chiude la conversazione in corso |
/list-characters | — | server | Elenca i personaggi di questo canale, ognuno con un pulsante Rimuovi |
/character-info | name (obbligatorio) | server, DM | Bio, descrizione, saluto, creatore, numero di chat, indicatore NSFW. Con un account collegato offre anche i pulsanti 1–5★ per valutare il personaggio, dopo che hai ricevuto qualche sua risposta e se le sue recensioni sono aperte |
/reset-chat | — | server · Manage Channels, DM | Elimina i messaggi e i riassunti del canale e riporta i conteggi. Nei messaggi diretti, cancella la conversazione in corso quando confermi |
/regenerate-reply | model (facoltativo) | server, DM | Rigenera l'ultima risposta del personaggio, volendo con un altro modello per quel tentativo |
/reply-suggestions | — | server, DM | Tre risposte suggerite come pulsanti; toccarne una la invia come tuo messaggio |
/settings | un sottocomando (obbligatorio) | server, DM | Impostazioni del canale e personali |
/plugins | un sottocomando (obbligatorio) | server, DM | Mostra i plugin attivi qui; installa, rimuove o attiva e disattiva i plugin ufficiali e i tuoi |
/server | — | server · Manage Server o l'host | Chi può parlare con i personaggi, un limite giornaliero per membro, i membri bloccati e i consumi |
/my-account | — | server, DM | Crediti, utilizzo del piano, data di rinnovo, numero di chat |
/daily | — | server, DM | Riscuote il tuo premio giornaliero |
/notify | — | server, DM | Se i personaggi possono scriverti per primi, e quali notifiche arrivano nei tuoi messaggi diretti |
/plugins accetta list, install, remove, enable o disable. Sono proposti solo i plugin ufficiali e i tuoi, e solo plugin di prompt e di strumento; un plugin che richiede impostazioni da compilare non si può installare dal bot. Il risultato di un plugin di strumento viene pubblicato come una breve scheda con il nome del personaggio. In un canale, cambiare i plugin richiede Manage Channels o l'aver aggiunto un personaggio al canale, e chiunque può elencarli; nei tuoi messaggi diretti decidi tu.
/settings da solo non è un comando valido: prende sempre uno dei sei sottocomandi.
| Sottocomando | Opzione | Richiede | Effetto |
|---|---|---|---|
/settings model | model (facoltativo) | — | Il tuo modello per il personaggio principale di questo canale. Vuoto mostra quello attuale o lo azzera. I modelli avanzati possono richiedere un abbonamento |
/settings language | language (facoltativo) | Manage Channels | Lingua di risposta del canale. Vuoto riporta all'inglese |
/settings channel-mode | mode: auto o mention | Manage Channels | Se i personaggi rispondono a ogni messaggio o solo quando sono interpellati |
/settings chat-style | style: RP o NORMAL | Manage Channels | Prosa da gioco di ruolo con le azioni, o solo dialogo |
/settings payment-mode | mode: owner o user | Manage Channels | A chi viene addebitato |
/settings daily-limit | credits (obbligatorio, ≥ 0) | Manage Channels | Tetto di crediti per giorno UTC. 0 significa senza limite |
Le stesse impostazioni sono nella dashboard web, canale per canale, come Payment mode, Daily credit limit, Chat style, Reply mode, Response language e Your model. Lingua e modello restano lì disattivati finché qualcuno non ha mandato un messaggio nel canale.
Quando un personaggio risponde
Un personaggio risponde quando viene @menzionato, quando qualcuno risponde a un suo messaggio, o quando il canale è in risposta automatica. La risposta automatica è disattivata di default, quindi un personaggio appena aggiunto sta zitto finché non gli si parla.
Con più personaggi in uno stesso canale, il canale si comporta come un'unica chat di gruppo: una sola richiesta elenca tutti i personaggi presenti e il modello decide chi parla. Nominare qualcuno è un suggerimento che viaggia insieme al tuo messaggio, non un interruttore che costringe quel personaggio a rispondere. Chat di gruppo →
Thread
Un thread in un canale testuale parla con i personaggi di quel canale e ne segue la modalità di pagamento, la modalità di risposta e lo stile di chat, ma ha una cronologia tutta sua: spazio per una scena secondaria che non ingombra il canale. Parte nella lingua di risposta del canale; /settings language e /settings model usati nel thread valgono solo per lui. Quello che spende un thread conta per il limite giornaliero del canale. I comandi che cambiano il cast o le altre impostazioni del canale, come /add-character, /list-characters, /plugins o /settings chat-style, ti rimandano al canale principale. I post dei forum e gli altri tipi di thread non hanno personaggi.
Chi paga
| Modalità di pagamento | Addebitato a | Limiti che valgono |
|---|---|---|
| Owner pays (predefinita) | L'host del server: l'account Reverie che per primo ha aggiunto un personaggio al server, finché qualcun altro non subentra | Il limite giornaliero di crediti del canale e il limite giornaliero per membro impostato con /server |
| User pays | Il saldo di chi scrive | Nessuno: ogni membro è limitato dal proprio saldo |
I messaggi costano quanto nell'app web: a token, moltiplicato per il moltiplicatore di crediti del modello. I contatori giornalieri si azzerano alle 00:00 UTC, e la finestra delle impostazioni del canale nella dashboard mostra il consumo di oggi rispetto al limite.
Per passare il conto sul tuo account (per esempio se chi ha configurato il bot se n'è andato), apri /server e premi Paga con il mio account. Vale per tutti i canali del server in cui paga l'host.
Regole del server
/server apre un pannello che vedi solo tu. Possono aprirlo i membri con Manage Server e chi paga i personaggi del server. Mostra i consumi di oggi e degli ultimi sette giorni, i membri che hanno speso di più oggi e tre regole:
| Regola | Scelte |
|---|---|
| Chi può parlare | Tutti (predefinito), Solo amministratori o Membri con determinati ruoli: i ruoli si scelgono in un secondo menu |
| Limite giornaliero per membro | Quanti crediti dell'host un membro può spendere per giorno UTC, oppure Nessun limite (predefinito). Vale solo dove paga l'host |
| Membri bloccati | I membri scelti qui non possono parlare con i personaggi in nessun punto del server |
Qui un amministratore è un membro con Manage Server. Gli amministratori e l'account che paga non restano mai fuori, né per un blocco né per la modalità di accesso, e finché non si sceglie un ruolo, Membri con determinati ruoli lascia parlare solo loro. Un membro escluso dalla modalità di accesso viene avvisato una volta che solo alcuni membri possono parlare con i personaggi; un membro bloccato non riceve nessuna risposta.
Personaggi con limite di età
Un personaggio 18+ risponde solo in un canale con limite di età, in un canale dentro una categoria con limite di età o ovunque in un server impostato come 18+; un thread segue il suo canale. Altrove, il bot spiega il motivo invece di rispondere. Nei tuoi messaggi diretti i personaggi 18+ non chattano mai.
Cosa funziona in un canale
- Immagini. I personaggi possono generare immagini su Discord.
- Voce in uscita. I personaggi possono inviare messaggi vocali.
- Voce in entrata. I messaggi vocali che mandi vengono trascritti, fino a 25 MB.
- Memoria. I personaggi salvano, aggiornano e cancellano ricordi quando il modello gestisce gli strumenti, e il canone dei world book entra nel loro contesto.
- Cronologia. I canali lunghi vengono riassunti automaticamente man mano che crescono.
- Aggiungere un secondo personaggio a un canale ne copia lo stile di chat, la modalità di pagamento e il limite giornaliero.
Notifiche e premio giornaliero
/notify regola due cose. Personaggi che ti scrivono per primi è il livello di proattività del tuo account, la stessa impostazione del sito: con un abbonamento, il personaggio con cui stai parlando nei messaggi diretti può scriverti per primo; vedi Messaggi di iniziativa. Ricevi anche qui sceglie quali delle tue notifiche di Reverie arrivano anche nei tuoi messaggi diretti; all'inizio è attiva solo Account e fatturazione; vedi Notifiche. La dashboard delle integrazioni offre le stesse scelte.
/daily riscuote il tuo premio giornaliero, lo stesso del sito, e rimanda all'estrazione fortunata.
Modificare e cancellare messaggi
Modificare il tuo messaggio più recente rifà la risposta a quel messaggio.
Cancellare un messaggio su Discord cancella quel messaggio e ogni messaggio successivo dalla cronologia del personaggio, insieme ai ricordi e agli allegati creati dopo quel punto. Anche le risposte del personaggio spariscono dal canale. Non si può annullare.
Cosa legge il bot
Il bot riceve ogni messaggio nei canali che riesce a vedere — è così che gli arrivano menzioni e risposte. Prima di ogni risposta legge anche i messaggi recenti dell'ultima ora del canale, compresi quelli non rivolti a lui, e li passa al modello come contesto perché il personaggio segua quel che succede.
Tratta un canale che ospita il bot come un canale in cui il bot sta ascoltando. Se non è quello che vuoi, metti i personaggi in un canale dedicato.
Limiti
| Limite | Valore |
|---|---|
| Personaggi per canale | 5 |
| Lunghezza di un messaggio Discord | 2.000 caratteri |
| Dimensione di un messaggio vocale | 25 MB |
| Webhook per canale Discord | 15 (tetto di Discord stesso) |
| Messaggi in coda per canale | 3 |
I messaggi rapidi e consecutivi della stessa persona vengono uniti in un solo turno.
Scollegare
Scollega dalla dashboard delle integrazioni con Scollega Account. Togliere il bot da un server o uscire dal server non scollega il tuo account. Una volta scollegato, accedere con Discord non ricollega più il bot da solo: usa Collega con Discord o /link-account quando lo rivuoi.
Correlati
- Bot Telegram — gli stessi personaggi, in Telegram
- Reverie Labs — dove sta la dashboard delle integrazioni
- Chat di gruppo — come funzionano le conversazioni con più personaggi
- Crediti — quanto costa un messaggio