|
| 1 | +# PythonRio-Bot |
| 2 | + |
| 3 | +Esse Readme é um pouco tutorial/como eu o criei. |
| 4 | + |
| 5 | +O bot que está em ruby, foi criado em um linux (Fedora), por isso haverá alguns comandos de um terminal linux. |
| 6 | + |
| 7 | +OBS.: O Token do código já foi trocado, caso necessite de realizar um update no bot, mande uma mensagem para o user do github Hi-hi-ray |
| 8 | + |
| 9 | +------------------------------------------------------------------------------------------------------------------------------ |
| 10 | +Primeira coisa a se fazer, Baixar e Instalar o telegram-bot-ruby: |
| 11 | + |
| 12 | +$ sudo gem install telegram-bot-ruby |
| 13 | + |
| 14 | +OU você pode adicionar ao seu gemfile com : |
| 15 | + |
| 16 | +$ gem 'telegram-bot-ruby' |
| 17 | + |
| 18 | +------------------------------------------------------------------------------------------------------------------------------ |
| 19 | +Segunda coisa a se fazer, Criar o seu bot no telegram: |
| 20 | + |
| 21 | +No telegram, vá em procure pelo o BotFather(@BotFather) |
| 22 | +O BotFather ele tem função de teajudar a criar um Bot. |
| 23 | + |
| 24 | +Comece com /start |
| 25 | +Ele mostrará inúmeras opções, mas vamos usar /newbot |
| 26 | +Então ele perguntará o nome do seu bot, e logo depois o username dele, Lembre-se que ele necessita ter bot no username dele. |
| 27 | + |
| 28 | +Se nada estiver sendo utilizado, seu bot estará criado, e você terá um HTTP API token. |
| 29 | +Mas antes de utilizarmos ele, vamos dar uma caractéristicas para ele, como descrição, imagem e o about text. |
| 30 | + |
| 31 | +Descrição: |
| 32 | +A descrição é a mensagem que aparece quando a pessoa vê o bot pela primeira vez, antes de inicia-lo, e pode ser dada pelo o comando /setdescription |
| 33 | +Escreva uma descrição sobre o seu bot. |
| 34 | + |
| 35 | +About Text: |
| 36 | +O about text é o texto que fica no perfil do bot, você pode criar com o comando /setabouttext |
| 37 | +Agora só escrever um about text. |
| 38 | + |
| 39 | +Imagem: |
| 40 | +A imagem pode ser colocada pelo o comoando /setuserpic |
| 41 | +Ele irá solicitar uma imagem, é só enviar uma imagem. |
| 42 | + |
| 43 | +Todas essas configurações demoram alguns minutos ṕara ser sincronizadas, e podem ser mudadas sempre que você quiser. |
| 44 | + |
| 45 | +------------------------------------------------------------------------------------------------------------------------------ |
| 46 | +Terceira coisa a se fazer, Decidir o que o seu bot irá fazer: |
| 47 | + |
| 48 | +No nosso caso o bot, ele responde a partir de um comando.E suas respostas são mensagens fixas. |
| 49 | +Parar dizemos quais são esses comandos, no telegram,em @BotFather digite o comando /setcommands |
| 50 | +Selecione o seu bot, e depois digite o comando e o que ele faz, exemplo: |
| 51 | + |
| 52 | + dog - diz woof |
| 53 | + cat - diz meow |
| 54 | + |
| 55 | +O.B.S.: cada vez que vc executa esse comando, ele apaga os comandos anteriores. |
| 56 | + |
| 57 | +------------------------------------------------------------------------------------------------------------------------------ |
| 58 | +Quarta Coisa a se fazer, Criar um arquivo ruby (Se quiser pode colar do nosso repositorio): |
| 59 | + |
| 60 | +A estrutura inicial é algo parecido como isso: |
| 61 | + |
| 62 | + require 'telegram/bot' |
| 63 | + token = 'seu TOKEN [Caso você não saiba seu token, o @BotFather tem um comando que mostra o token do seu bot /token]' |
| 64 | + Telegram::Bot::Client.run(token) do |bot| |
| 65 | + bot.listen do |message| |
| 66 | + case message.text |
| 67 | + when '/dog' |
| 68 | + bot.api.send_message(chat_id: message.chat.id, text:"woof") |
| 69 | + when '/cat' |
| 70 | + bot.api.send_message(chat_id: message.chat.id, text:"meow") |
| 71 | + end |
| 72 | + end |
| 73 | + end |
| 74 | + |
| 75 | +O.B.S.: Se seu bot for adicionado em um grupo os seus comando são mudados, por isso você deve cobrir essa possibilidade. |
| 76 | +Exemplo: |
| 77 | + |
| 78 | +No PythonRio_Bot o comando em seu chat /help funcionará muito bem, mas se ele estiver em um grupo e tiver outros bots, isso poderia causar algum conflito, por isso é adicionado automaticamente. |
| 79 | + |
| 80 | +Então para solucionar esse problema, dentro do case basta criar when que cubra esse comando. |
| 81 | + então temos um |
| 82 | + when '/help' |
| 83 | + e outro |
| 84 | + when '/help@PythonRio_Bot' |
| 85 | + assim tornando possivel usar o seu bot em um grupo. |
| 86 | + |
| 87 | +Salve o seu arquivo ruby. |
| 88 | + |
| 89 | +Ultima observação... Se for usar acentos não se esqueça que usamos o padrão UTF-8, e você pode utiliza-lo em seu documento ruby antes de qualquer código basta colocar de forma comentada as seguintes três linhas abaixo: |
| 90 | + |
| 91 | + encoding: UTF-8 |
| 92 | + coding: UTF-8 |
| 93 | + -*- coding: UTF-8 -*- |
| 94 | + |
| 95 | +------------------------------------------------------------------------------------------------------------------------------ |
| 96 | +Quinta Coisa a se fazer, rodar o seu arquivo ruby no terminal: |
| 97 | + |
| 98 | +$ ruby arquivoRuby.rb |
| 99 | + |
| 100 | +Agora o seu bot estará respondendo. |
| 101 | + |
| 102 | +------------------------------------------------------------------------------------------------------------------------------ |
| 103 | +Dando deploy do seu Bot no Heroku (Com Interface) |
| 104 | +Crie um arquivo chamado Procfile, nele escreva: |
| 105 | + |
| 106 | +bot: ruby Nome_Do_Seu_Arquivo_em_Ruby.rb |
| 107 | + |
| 108 | +Save esse arquivo. Agora vamos entrar no Heroku (https://www.heroku.com/), entre no seu perfil. |
| 109 | +-Clique no botão "New". |
| 110 | +-Escolha a opção "Create a new app". |
| 111 | +-Digite o nome do seu App, e escolha o Runtime de sua preferência. |
| 112 | +-Você vai ser direcionado diretamente para a aba de deploy. |
| 113 | + *Nessa aba, em Deployment method, eu utilizei o GitHub como opção. |
| 114 | + *Nele eu entrei com a minha conta e dei as permissões necessárias para o repositório do bot. |
| 115 | + *Procurei o repositório do bot, e depois cliquei "connect". |
| 116 | + *Em "Automatic deploys" escolhi a branch master, marquei a opção "Wait for CI to pass before deploy" e cliquei no botão "Enable Automatic Deploys". |
| 117 | + *E para finalizar em Manual Deploy, selecionei a branch master e cliquei em "Deploy Branch". |
| 118 | +-Na aba Activity você pode ver o log do seu bot. |
| 119 | +------------------------------------------------------------------------------------------------------------------------------ |
| 120 | +Links Uteis |
| 121 | + |
| 122 | ++ Comando que podem ser usado (no nosso bot, usamos o bot.api.send_message) |
| 123 | +https://core.telegram.org/bots/api |
| 124 | + |
| 125 | ++ Linguagens que pode ser feito um bot |
| 126 | +https://core.telegram.org/bots/samples |
| 127 | + |
| 128 | +Caso não tenha dado certo ou precise de ajuda, ou queira modificar esse bot (precisa do token) mande uma mensagem para https://github.com/hi-hi-ray |
| 129 | + |
0 commit comments