# Bot do Discord > Converse a sós nas suas mensagens diretas, ou coloque personagens num servidor e decida quem pode falar com eles e quem paga. Source: https://reverie.im/pt/docs/integrations/discord-bot Language: pt O bot da Reverie leva personagens a dois lugares do Discord: suas **mensagens diretas** com o bot, para conversas a sós, e os **canais de servidor**, onde cada personagem fala com o próprio nome e avatar. Quem fala com um personagem precisa de uma conta Reverie vinculada à sua conta do Discord — uma gratuita basta —, e cada resposta é cobrada em créditos de uma conta Reverie. ## Vincular sua conta \[#link-your-account] Uma conta do Discord corresponde a exatamente uma conta Reverie. Qualquer um destes caminhos junta as duas: * **Pelo painel de integrações.** No app, vá em **Labs → Bots do Discord e Telegram** e toque em **Vincular com o Discord** no cartão do Discord. Você confirma no Discord e volta direto. * **Entrando com o Discord.** Entrar na Reverie com o Discord também vincula o bot — a menos que você o tenha desvinculado no painel; nesse caso ele continua desvinculado até você vincular de novo por conta própria. * **Pelo Discord.** Rode `/link-account` num servidor ou nas suas mensagens diretas com o bot. Só você vê a resposta: um botão **Vincular minha conta** que funciona uma vez e expira em **10 minutos**. Abra, entre, e as contas ficam unidas. ## Conversar a sós nas mensagens diretas \[#chat-one-on-one-in-your-dms] Mande uma mensagem direta para o bot, ou rode `/chat` em qualquer servidor onde o bot esteja — a conversa passa para as suas mensagens diretas, onde só você a vê. `/chat` sozinho oferece personagens para escolher; acrescente um nome para buscar um. * **Um personagem por vez.** `/chat` troca para outro, e `/chats` lista os personagens com quem você já falou nas mensagens diretas. Cada um guarda a própria conversa, então ao voltar você continua de onde parou. * **Toda mensagem recebe resposta**, publicada pelo bot com o nome do personagem em letra pequena acima. Imagens, mensagens de voz e memória funcionam como num canal. * **Você paga** as suas próprias mensagens. Os modos de pagamento e os limites do servidor não se aplicam. * **Nada de personagens 18+.** Uma mensagem direta não pode ser marcada com restrição de idade, por isso personagens 18+ nunca conversam por mensagem direta. * `/remove-character` encerra a conversa atual — ela fica salva para `/chats` —, e `/reset-chat` a apaga depois de pedir sua confirmação. * Dos subcomandos de `/settings`, só `model`, `language` e `chat-style` valem para as mensagens diretas. Se o bot disser que não conseguiu te mandar mensagem, permita mensagens diretas de membros do servidor nas configurações de privacidade do Discord e tente de novo. Suas conversas recentes por mensagem direta também aparecem no painel de integrações em **Chat privado**, onde **Continuar na web** retoma uma no navegador. ## Adicionar o bot a um servidor \[#add-the-bot-to-a-server] ### Convidar o bot \[#invite-the-bot] Toque em **Adicionar Bot ao Servidor** no cartão do Discord no painel de integrações e escolha um servidor. Deixe marcadas todas as permissões pedidas — a tabela abaixo explica para que serve cada uma. Ao entrar, o bot publica uma breve mensagem de primeiros passos onde o servidor mostra as mensagens de entrada. ### Adicionar um personagem a um canal \[#add-a-character-to-a-channel] Num canal de texto, rode `/add-character` e escolha um personagem no autocompletar — ele cobre personagens públicos e os seus próprios personagens privados. Você precisa da permissão **Manage Channels** e de uma conta vinculada. O bot cria um webhook para que o personagem possa postar com o próprio nome e depois manda uma saudação. ### Definir as regras \[#set-the-rules] Opcional. `/settings` decide como os personagens de um canal respondem e quem paga por eles; `/server` decide quem pode falar com eles. Os dois estão explicados mais abaixo. ## Permissões que o convite pede \[#permissions-the-invite-requests] | Permissão | Por que é pedida | | ------------------- | ---------------------------------------------------------------------------------- | | **View Channels** | Ler o canal em que o bot é usado | | **Send Messages** | Postar respostas e a saída dos comandos | | **Manage Messages** | Tirar as respostas do personagem quando a mensagem que as provocou é apagada | | **Embed Links** | A saída dos comandos e os avisos do sorteio da comunidade são embeds | | **Manage Roles** | Distribuir o cargo usado pelo sorteio da comunidade no servidor da própria Reverie | | **Manage Webhooks** | **Obrigatória.** Os personagens falam por um webhook próprio de cada um | Sem **Manage Webhooks**, `/add-character` falha e o personagem não é adicionado. ## Comandos \[#commands] Num servidor, os comandos marcados com **Manage Channels** ou **Manage Server** só aparecem para membros com essa permissão do Discord. As respostas aos comandos de conta e de gestão só você vê. | Comando | Opções | Onde | O que faz | | -------------------- | --------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/help` | — | servidor, DM | Lista os comandos, só para você | | `/link-account` | — | servidor, DM | Publica um link de uso único para unir suas contas do Discord e da Reverie | | `/chat` | `name` (opcional) | servidor, DM | Escolhe ou troca o personagem das suas mensagens diretas. Num servidor, envia a escolha para as suas mensagens diretas | | `/chats` | — | servidor, DM | Os personagens com quem você falou nas mensagens diretas, para alternar entre eles | | `/add-character` | `name` (obrigatório) | servidor · Manage Channels | Adiciona um personagem a este canal e o faz cumprimentar | | `/remove-character` | `name` (obrigatório) | servidor · Manage Channels, DM | Remove o personagem e apaga o webhook dele. Nas mensagens diretas, encerra a conversa atual | | `/list-characters` | — | servidor | Lista os personagens deste canal, cada um com um botão Remover | | `/character-info` | `name` (obrigatório) | servidor, DM | Bio, descrição, saudação, criador, número de chats, marcação NSFW. Com uma conta vinculada, também oferece botões de 1–5★ para avaliar o personagem depois que você recebeu algumas respostas dele e as avaliações estão abertas | | `/reset-chat` | — | servidor · Manage Channels, DM | Apaga as mensagens e os resumos do canal e informa as contagens. Nas mensagens diretas, apaga a conversa atual quando você confirma | | `/regenerate-reply` | `model` (opcional) | servidor, DM | Gera de novo a última resposta do personagem, se quiser com outro modelo nessa tentativa | | `/reply-suggestions` | — | servidor, DM | Três respostas sugeridas como botões; tocar numa a envia como sua mensagem | | `/settings` | um subcomando (obrigatório) | servidor, DM | Configurações do canal e pessoais | | `/plugins` | um subcomando (obrigatório) | servidor, DM | Mostra os plugins em uso aqui; instala, remove ou liga e desliga plugins oficiais e os seus | | `/server` | — | servidor · Manage Server ou o anfitrião | Quem pode falar com os personagens, um limite diário por membro, membros bloqueados e o uso | | `/my-account` | — | servidor, DM | Créditos, uso do plano, data de renovação, número de chats | | `/daily` | — | servidor, DM | Resgata sua recompensa diária | | `/notify` | — | servidor, DM | Se os personagens podem te escrever primeiro, e quais notificações chegam às suas mensagens diretas | `/plugins` aceita `list`, `install`, `remove`, `enable` ou `disable`. Só aparecem plugins oficiais e os seus, e só plugins de prompt e de ferramenta; um plugin que precisa de configurações preenchidas não pode ser instalado pelo bot. O resultado de um plugin de ferramenta é publicado como um cartão curto com o nome do personagem. Num canal, mudar os plugins exige **Manage Channels** ou ter adicionado um personagem ao canal, e qualquer pessoa pode listá-los; nas suas mensagens diretas, quem decide é você. `/settings` sozinho não é um comando válido — ele sempre leva um de seis subcomandos: | Subcomando | Opção | Exige | Efeito | | ------------------------ | ---------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `/settings model` | `model` (opcional) | — | O **seu** modelo para o personagem principal deste canal. Vazio mostra o atual ou redefine. Modelos avançados podem exigir assinatura | | `/settings language` | `language` (opcional) | Manage Channels | Idioma de resposta do canal. Vazio volta para o inglês | | `/settings channel-mode` | `mode`: `auto` ou `mention` | Manage Channels | Se os personagens respondem a toda mensagem ou só quando chamados | | `/settings chat-style` | `style`: `RP` ou `NORMAL` | Manage Channels | Prosa de interpretação com ações, ou só diálogo | | `/settings payment-mode` | `mode`: `owner` ou `user` | Manage Channels | De quem é a cobrança | | `/settings daily-limit` | `credits` (obrigatório, ≥ 0) | Manage Channels | Teto de créditos por dia UTC. `0` significa sem limite | As mesmas configurações estão no painel web, por canal, como **Payment mode**, **Daily credit limit**, **Chat style**, **Reply mode**, **Response language** e **Your model**. Idioma e modelo ficam desativados ali até alguém mandar uma mensagem no canal. ## Quando um personagem responde \[#when-a-character-replies] Um personagem responde quando é **@mencionado**, quando alguém **responde** a uma mensagem dele, ou quando o canal está em resposta automática. A resposta automática vem **desligada por padrão**, então um personagem recém-adicionado fica quieto até ser chamado. Com vários personagens num mesmo canal, o canal se comporta como um único chat em grupo: um pedido lista todos os personagens presentes e o modelo decide quem fala. Mencionar um nome é uma dica que viaja junto com a sua mensagem, não um interruptor que obriga aquele personagem a responder. [Chats em grupo →](https://reverie.im/pt/docs/chatting/group-chats) ## Tópicos \[#threads] Um tópico num canal de texto fala com os personagens desse canal e segue o modo de pagamento, o modo de resposta e o estilo de chat dele, mas tem um histórico próprio — espaço para uma cena paralela que não bagunça o canal. Ele começa no idioma de resposta do canal; `/settings language` e `/settings model` usados dentro do tópico valem só para ele. O que um tópico gasta conta para o limite diário do canal. Comandos que mudam o elenco ou as outras configurações do canal, como `/add-character`, `/list-characters`, `/plugins` ou `/settings chat-style`, mandam você para o canal principal. Publicações de fórum e outros tipos de tópico não têm personagens. ## Quem paga \[#who-pays] | Modo de pagamento | Cobrado de | Limites que valem | | ----------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- | | **Owner pays** (padrão) | O anfitrião do servidor: a conta Reverie que adicionou o primeiro personagem ao servidor, até alguém assumir | O limite diário de créditos do canal e o limite diário por membro definido com `/server` | | **User pays** | O saldo de quem envia | Nenhum — cada membro fica limitado pelo próprio saldo | As mensagens custam o mesmo que no app web: por token, multiplicado pelo multiplicador de créditos do modelo. Os contadores diários zeram às **00:00 UTC**, e a janela de configurações do canal no painel mostra o uso de hoje diante do limite. Para passar a conta para a sua própria conta — por exemplo, se quem configurou o bot saiu —, abra `/server` e toque em **Pagar com minha conta**. Vale para todos os canais do servidor em que o anfitrião paga. ## Regras do servidor \[#server-rules] `/server` abre um painel que só você vê. Podem abri-lo os membros com **Manage Server** e quem paga pelos personagens do servidor. Ele mostra o uso de hoje e dos últimos sete dias, os membros que mais gastaram hoje e três regras: | Regra | Opções | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Quem pode conversar** | **Todos** (padrão), **Só administradores** ou **Membros com certos cargos** — os cargos são escolhidos num segundo menu | | **Limite diário por membro** | Quantos créditos do anfitrião um membro pode gastar por dia UTC, ou **Sem limite** (padrão). Só vale onde o anfitrião paga | | **Membros bloqueados** | Os membros escolhidos aqui não podem falar com personagens em lugar nenhum do servidor | Aqui, administrador é um membro com **Manage Server**. Administradores e a conta que paga nunca ficam de fora, nem por bloqueio nem pelo modo de acesso, e enquanto nenhum cargo for escolhido, **Membros com certos cargos** só deixa eles falarem. Um membro que o modo de acesso deixa de fora é avisado uma vez de que só alguns membros podem falar com os personagens; um membro bloqueado não recebe resposta nenhuma. ## Personagens com restrição de idade \[#age-restricted-characters] Um personagem 18+ só responde num canal com restrição de idade, num canal dentro de uma categoria com restrição de idade ou em qualquer lugar de um servidor configurado como 18+ — um tópico segue o seu canal. Em qualquer outro lugar, o bot explica o motivo em vez de responder. Nas suas mensagens diretas, personagens 18+ nunca conversam. ## O que funciona num canal \[#what-works-in-a-channel] * **Imagens.** Os personagens podem gerar imagens no Discord. * **Voz na saída.** Os personagens podem mandar mensagens de voz. * **Voz na entrada.** As mensagens de voz que você envia são transcritas, até **25 MB**. * **Memória.** Os personagens salvam, atualizam e apagam memórias quando o modelo aceita ferramentas, e o cânone dos world books entra no contexto deles. * **Histórico.** Canais longos são resumidos automaticamente conforme crescem. * Adicionar um segundo personagem ao canal copia o estilo de conversa, o modo de pagamento e o limite diário daquele canal. ## Notificações e recompensa diária \[#notifications-and-check-ins] `/notify` ajusta duas coisas. **Personagens que te escrevem primeiro** é o nível de proatividade da sua conta, a mesma configuração do site: com uma assinatura, o personagem com quem você está falando nas mensagens diretas pode te escrever primeiro — veja [Mensagens por iniciativa do personagem](https://reverie.im/pt/docs/chatting/proactive-messages). **Também me envie aqui** escolhe quais das suas notificações da Reverie chegam também às suas mensagens diretas; no início só **Conta e cobrança** está ativada — veja [Notificações](https://reverie.im/pt/docs/account/notifications). O painel de integrações oferece as mesmas opções. `/daily` resgata sua [recompensa diária](https://reverie.im/pt/docs/rewards/daily-check-in), a mesma do site, e traz um link para o sorteio da sorte. ## Editar e apagar mensagens \[#editing-and-deleting-messages] Editar a sua mensagem mais recente refaz a resposta a ela. > Apagar uma mensagem no Discord apaga aquela mensagem **e todas as mensagens depois dela** do histórico do personagem, junto com memórias e anexos criados depois daquele ponto. As respostas do personagem também somem do canal. Isso não dá para desfazer. ## O que o bot lê \[#what-the-bot-reads] O bot recebe todas as mensagens dos canais que consegue ver — é assim que menções e respostas chegam até ele. Antes de cada resposta ele também lê as **mensagens recentes da última hora** do canal, inclusive as que não são para ele, e as passa ao modelo como contexto para o personagem acompanhar o ambiente. Trate um canal com o bot dentro como um canal em que o bot está ouvindo. Se não for isso que você quer, ponha os personagens num canal só para eles. ## Limites \[#limits] | Limite | Valor | | ---------------------------------- | ---------------------------- | | Personagens por canal | 5 | | Tamanho de uma mensagem do Discord | 2.000 caracteres | | Tamanho de uma mensagem de voz | 25 MB | | Webhooks por canal do Discord | 15 (teto do próprio Discord) | | Mensagens na fila por canal | 3 | Mensagens rápidas e seguidas da mesma pessoa são juntadas num único turno. ## Desvincular \[#unlinking] Desvincule pelo painel de integrações com **Desvincular Conta**. Remover o bot de um servidor ou sair do servidor não desvincula a sua conta. Depois de desvinculada, entrar com o Discord não vincula mais o bot sozinho — use **Vincular com o Discord** ou `/link-account` quando quiser de volta. ## Relacionado \[#related] * [Bot do Telegram](https://reverie.im/pt/docs/integrations/telegram-bot) — os mesmos personagens, no Telegram * [Reverie Labs](https://reverie.im/pt/docs/integrations/labs) — onde mora o painel de integrações * [Chats em grupo](https://reverie.im/pt/docs/chatting/group-chats) — como funcionam as conversas com vários personagens * [Créditos](https://reverie.im/pt/docs/billing/credits) — quanto custa uma mensagem