Bot de chat (Discord e Telegram)

O bot de chat conecta o Lords Bot ao seu próprio bot do Discord ou do Telegram. Pelo chat você pode ver quais contas estão online, iniciar e parar contas, pegar logs e uma captura de tela, e receber alertas como uma chave de acesso expirada. Os membros da guilda também podem usar o banco da guilda pelo chat.

Como funciona #

1. Crie seu próprio bot no Discord ou no Telegram e copie o token dele.
2. Conecte: cole o token no Lords Bot e clique em Conectar (Connect).
3. Escolha seu chat: envie !set no canal ou grupo que você quer usar. Você vira o administrador do bot de chat.
4. Use: controle suas contas com comandos, receba alertas e deixe sua guilda usar o banco pelo chat.

Configurar o bot de chat #

Abra Configurações > Opções > Outras configurações (Settings > Options > Other Settings) na janela principal e vá para a aba Bot de bate-papo (Chat Bot). Depois siga os passos para o Discord ou o Telegram.

Discord #

1. Acesse https://discord.com/developers/applications e crie um novo aplicativo (application).
2. Abra a página Bot do aplicativo e copie o token do bot. Mantenha o token em segredo.
3. Na mesma página, ative o Message Content Intent. O Lords Bot precisa dele para ler os comandos. Salve as alterações. Se estiver desligado, o Lords Bot para com um erro que pede para você ligá-lo.
4. No Lords Bot, cole o token em Token de bot: (Bot Token:), escolha Discord e clique em Conectar.
5. Quando o status mostrar Discord Conectado (Discord Connected), clique em Adicionar bot a Discord (Add Bot to Discord) e adicione o bot ao seu servidor.

Dica: Se o Discord disser que a integração “requires code grant” (exige concessão de código), volte ao portal de desenvolvedores e desative a opção OAuth2 code grant do seu bot.

Telegram #

1. Abra https://t.me/BotFather no Telegram e envie /newbot.
2. Escolha um nome e depois um nome de usuário que termine em bot. O BotFather envia o token do bot para você.
3. Envie /setprivacy para o BotFather, escolha seu bot e escolha Disable. Isso permite que o bot leia mensagens que começam com ! nos grupos.
4. No Lords Bot, cole o token em Token de bot:, escolha Telegram e clique em Conectar.
5. Quando o status mostrar Telegram Conectado (Telegram Connected), clique em Adicionar bot a Telegram (Add Bot to Telegram) e adicione o bot ao seu grupo.

Só no Telegram, você pode marcar Usar proxy? (Use Proxy?) e escolher um dos seus proxies para a conexão do bot de chat.

Definir seu chat #

Os comandos só funcionam depois que você vincula o bot a um chat:

1. No canal do Discord ou no grupo do Telegram que você quer usar, envie !set (ou /set).
2. O bot responde Grupo atribuído com sucesso! (Group assigned successfully!)

O chat em que você enviou set passa a ser o chat do bot de chat, e você é o administrador dele. Só o administrador pode usar os comandos do bot de chat, e só nesse chat. No Discord, os comandos também aparecem como comandos de barra (slash commands) nesse servidor depois que você envia set.

O administrador do bot de chat (quem enviou set) não é o mesmo que os usuários autorizados de um banco da guilda. Esses são adicionados em cada banco, na aba Usuários autorizados (Authorized Users).

Para mudar o bot de chat para outro chat, envie /cleargroup no chat atual, ou clique em Limpar dados (Clear Data) na aba Bot de bate-papo, e depois envie set de novo no chat novo.

Outros botões da aba Bot de bate-papo #

Item	O que faz
Desconectar (Disconnect)	Desconecta o bot de chat.
Ver registro (View Log)	Mostra o registro de conexão do bot de chat. Confira se o status disser Algo deu errado, verifique o log (Something went wrong, check log).
Limpar dados	Esquece o chat definido e o administrador.
Publicar novas versões no chat (Post new versions in chat)	Publica uma vez o número da nova versão no chat quando sai uma atualização. Padrão: ligado.
Caixa de informações	Mostra o ID do bate-papo (Chat ID), o ID do administrador (Admin ID) e, no Discord, o ID da guilda (Guild ID), que é o seu servidor.

Se o bot de chat não conseguir conectar, ele tenta de novo após 15 segundos e depois espera mais a cada vez, até a cada 5 minutos. Um token errado, ou o Message Content Intent do Discord desligado, faz ele parar com um erro em vez disso.

Comandos #

Só o administrador do bot de chat pode usá-los, no chat definido com set. Os comandos podem começar com /, ! ou ,. No Discord eles também são comandos de barra, e a caixa de conta sugere nomes de contas enquanto você digita.

No Discord, os comandos de barra só aparecem para membros do servidor com a permissão Gerenciar servidor (Manage Server). Para mostrá-los a outro cargo, abra Configurações do servidor > Integrações (Server Settings > Integrations), escolha seu bot e permita esse cargo. A caixa de conta encontra qualquer parte de um nome ou o início de um IGG ID, e mostra se cada conta está rodando. Se um comando não puder ser usado, só você vê a resposta.

No Telegram, toque no botão de menu / ao lado da caixa de mensagem para escolher um comando. Envie /start, /stop, /restart, /info, /log ou /shortlog sem conta e o bot responde com um botão para cada conta; toque em um para executar o comando nessa conta.

Se alguém que não é o administrador usar um comando, o bot responde Você não está autorizado a usar esse comando (You are not authorized to use that command). Em qualquer outro chat ele responde Os comandos de administrador só podem ser usados no chat onde: /Set foi usado. (Admin Commands can only be used in the chat where: /Set was used.) A exceção é o /setcastle, que o administrador pode usar em qualquer chat em que o bot esteja.

Banco da guilda no chat #

O banco da guilda pode responder a comandos em qualquer canal do Discord ou grupo do Telegram em que o seu bot de chat esteja, não só no chat do administrador. Repita estes passos para cada banco.

Adicionar um banco a um chat (administrador) #

No chat do grupo, envie /setcastle seguido do nome ou do IGG ID da conta do banco, por exemplo /setcastle MyBank. O bot responde Conta atribuída ao bate-papo (Account Assigned to Chat). Para remover, envie /unsetcastle MyBank no chat do administrador do bot de chat.

Registrar-se como usuário do banco (cada jogador) #

Cada jogador vincula sua conta do Discord ou do Telegram ao seu nome no jogo uma vez:

1. No chat do grupo, envie um comando do banco, como !bal. (Use o prefixo do banco se ele tiver sido mudado de !.)
2. O bot responde com Por favor, envie ao banco: (Please send the bank:) e um comando como !reguser 123456789.
3. Envie exatamente esse comando para o banco no jogo, no chat da guilda ou por correio. O banco responde Conta social registrada (Social account registered).
4. Envie !bal de novo no chat do grupo. Você recebe o seu saldo.

Agora você pode usar pelo chat qualquer comando do banco que a sua patente permite. Para desvincular, envie !unreguser para o banco no jogo. Veja Comandos do banco da guilda para a lista completa.

Observação: Os comandos do bot de chat são lidos primeiro. Um comando do banco com o mesmo nome de um comando do bot de chat, como !stop, é tratado no chat como o comando do bot de chat. Envie esses comandos do banco pelo jogo.

Notificações das contas #

O bot de chat pode postar alertas das contas no chat do administrador. Ative-os em cada conta: abra a janela da conta e vá para Configurações > Geral > Avançado (Settings > General > Advanced), no grupo Chat Bot. Você pode usar as Configurações globais ou um modelo para configurar muitas contas de uma vez.

Opção	O que posta
Publicar status no Chatbot (Post Status in Chatbot)	Liga os alertas do bot de chat para esta conta.
Expiração da chave de acesso (Access Key Expiry)	Quando a chave de acesso expira, é renovada ou não pode ser renovada.
Status da Conexão Alterado (Connection Status Change)	Quando a conta fica offline (uma vez por queda), quando volta, e na primeira conexão depois que você a inicia.
Só após offline por (min) (Only after offline for (min))	Acima de 0, espera esses minutos antes de postar que a conta está offline; uma reconexão nesse tempo não posta nada. 0 posta na hora.
Outro Login (Other Login)	Quando outra pessoa entra na conta.
Status do agendamento (Schedule Status)	Quando um descanso do agendamento começa e termina, e quando a conta entra durante um descanso para conferir as tarefas.
Limite de RSS próximo (Nearing RSS limit)	Quando comida, pedra, madeira, minério ou ouro chega a 4 bilhões, perto do limite do jogo.
Publicar agrupamentos / ataques recebidos (Post incoming rallies / attacks)	Quando um agrupamento ou ataque está vindo contra o castelo, marcando o administrador. Um alerta por ataque: o próximo só vem depois que a torre de vigia ficar limpa.
Enviar estatísticas (Upload Stats)	Posta os relatórios de estatísticas que esta conta salva (estatísticas de presentes, lista da guilda e estatísticas do Festival das Guildas, ativados na página Guilda) como arquivos no chat em que esta conta foi adicionada com /setcastle. Nada é postado até você fazer isso. Com esta opção ligada, o comando do banco !stats all enviado desse chat também envia o relatório como arquivo. As Configurações globais e os modelos não mudam esta opção: ligue-a em cada conta.

Enquanto Publicar status no Chatbot estiver ligado, alguns alertas são sempre postados, por exemplo quando a conta é banida ou suspensa, ou quando o limite de contas é atingido.

Alertas que chegam juntos são enviados em uma só mensagem. Quando várias contas têm o mesmo alerta, ele é postado uma vez com as contas listadas abaixo.