{"id":17663987,"url":"https://github.com/tiago154/discord-bot-guilda-nodejs","last_synced_at":"2025-06-13T18:09:09.054Z","repository":{"id":42688853,"uuid":"271886837","full_name":"tiago154/discord-bot-guilda-nodejs","owner":"tiago154","description":"🤖 - Exemplo prático de como criar um bot no discord","archived":false,"fork":false,"pushed_at":"2024-06-18T01:17:29.000Z","size":373,"stargazers_count":8,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-07T23:09:14.147Z","etag":null,"topics":["bot","discord","discord-bot","discord-js","nodejs-bot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tiago154.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-12T20:43:23.000Z","updated_at":"2023-09-01T00:58:35.000Z","dependencies_parsed_at":"2024-11-09T11:00:42.498Z","dependency_job_id":"8e0e0c8e-fa80-446a-bf17-e58d00787812","html_url":"https://github.com/tiago154/discord-bot-guilda-nodejs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tiago154/discord-bot-guilda-nodejs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiago154%2Fdiscord-bot-guilda-nodejs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiago154%2Fdiscord-bot-guilda-nodejs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiago154%2Fdiscord-bot-guilda-nodejs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiago154%2Fdiscord-bot-guilda-nodejs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiago154","download_url":"https://codeload.github.com/tiago154/discord-bot-guilda-nodejs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiago154%2Fdiscord-bot-guilda-nodejs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259695308,"owners_count":22897514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","discord","discord-bot","discord-js","nodejs-bot"],"created_at":"2024-10-23T19:43:03.822Z","updated_at":"2025-06-13T18:09:09.030Z","avatar_url":"https://github.com/tiago154.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\r\n  \u003ca href=\"\" rel=\"noopener\"\u003e\r\n \u003cimg width=200px height=200px src=\"https://www.bombril.com.br/media/img/upload/f992f40a-f9c7-4415-af7c-77671c15a645.png\" alt=\"Bot logo\"\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n\u003ch3 align=\"center\"\u003eBombril bot - Mil e uma utilidades\u003c/h3\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n[![Status](https://img.shields.io/badge/status-active-success.svg)]()\r\n[![GitHub Issues](https://img.shields.io/github/issues/tiago154/discord-bot-guilda-nodejs.svg)](https://github.com/tiago154/discord-bot-guilda-nodejs/issues)\r\n[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/tiago154/discord-bot-guilda-nodejs.svg)](https://github.com/tiago154/discord-bot-guilda-nodejs/pulls)\r\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n\u003cp align=\"center\"\u003e 🤖 - Bot desenvolvido na Guilda de Nodejs exemplificando alguns recursos na plataforma do Discord\r\n    \u003cbr\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e ❓ - A ideia é que cada desenvolvedor deixe online sua própria versão do bot. Os passos para isso serão descritos abaixo.\r\n    \u003cbr\u003e\r\n\u003c/p\u003e\r\n\r\n## 📝 - Conteúdo\r\n\r\n- [Sobre](#about)\r\n- [Demonstração](#demo)\r\n- [Como funciona](#working)\r\n- [Uso](#usage)\r\n- [Utilizando](#getting_started)\r\n- [Construído usando](#built_using)\r\n- [Contrubuindo](../CONTRIBUTING.md)\r\n- [Autores](#authors)\r\n\r\n## 🧐 - Sobre \u003ca name = \"about\"\u003e\u003c/a\u003e\r\n\r\nBombril bot é responsável por ajudar seus usuários em diversas tarefas (mil e uma utilidade).\u003cbr/\u003e\r\nAtualmente possui as funcionalidades:\r\n\r\n- Informações de localidade pelo CEP\r\n- Dados relacionados ao COVID-19 por país\r\n\r\n## 🎥 - Demonstração \u003ca name = \"demo\"\u003e\u003c/a\u003e\r\n\r\n![demo-bombril](https://user-images.githubusercontent.com/10531605/84601614-df4d6300-ae57-11ea-8f81-64de81080ac7.gif)\r\n\r\n## 💭 - Como funciona \u003ca name = \"working\"\u003e\u003c/a\u003e\r\n\r\n- CEP: \u003cbr/\u003e\r\nO bot consulta uma API publica de CEP (https://docs.awesomeapi.com.br/api-cep), filtra os dados relevantes e monta uma mensagem amigável para o usuário. Também é montado a URL do Google Maps com a localidade aproximada.\r\n\r\n- COVID: \u003cbr/\u003e\r\nO bot consulta uma API publica do COVID-19 (https://github.com/NOVELCOVID/API), filtra os dados relevantes e monta uma mensagem amigável para o usuário. Também é montado a URL da busca do Google onde é mostrado alguns dados do país\r\n\r\nO Bot inteiro é escrito em Nodejs 12\r\n\r\n## 🎈 - Uso \u003ca name = \"usage\"\u003e\u003c/a\u003e\r\n\r\nPara usar o bot digite:\r\n\r\n- CEP: \u003cbr/\u003e\r\n\r\n```\r\n!bombril cep:\u003ccep\u003e\r\n```\r\nO cep pode ser escrito com 8 digitos ou 5 digitos + 3 digitos separados por `-`\r\n\r\n\r\n- Covid: \u003cbr/\u003e\r\n\r\nPara usar o bot digite:\r\n\r\n```\r\n!bombril covid:\u003cpais\u003e\r\n```\r\n\r\nO país tem que ser escrito em ingles exemplo: `Brazil` ou utilizar o padrão `ISO 3166-1` com o código de 2 (`BR`) ou 3 (`BRA`) caracteres.\r\n\r\n\r\n## 🏁 - Utilizando \u003ca name = \"getting_started\"\u003e\u003c/a\u003e\r\n\r\n### Ideia\r\n\r\nA ideia é que o desenvolvedor suba sua própria versão do BOT\r\n\r\n### Pré-requisitos\r\n\r\nPara rodar o bot será necessário:\r\n\r\n- Ser administrador em um servidor discord\r\n- Ter o Nodejs 12 instalado\r\n- Criar seu bot no [painel do discord](https://discord.com/developers/applications)\r\n\r\n### Criando seu BOT no Discord\r\n\r\nAcesse https://discord.com/developers/applications e crie sua aplicação responsável pelo BOT\r\n\r\n![discord-applications](https://user-images.githubusercontent.com/10531605/85205402-9bdc7400-b2f1-11ea-8178-7437022a41cb.png)\r\n\r\n\u003cdiv style=\"display: flex\"\u003e\r\n  \u003cimg src=\"https://user-images.githubusercontent.com/10531605/85205451-d34b2080-b2f1-11ea-9792-a043a1d80979.png\" style=\"margin: auto\"/\u003e\r\n\u003c/div\u003e\r\n\r\nDepois disso, adicione seu bot\r\n\r\n![image](https://user-images.githubusercontent.com/10531605/85205465-e65df080-b2f1-11ea-8d34-bfaac30126e4.png)\r\n\r\nAutorize o bot em seu servidor.\u003cbr\u003e\r\nA URL para integração pode ser gerada no link `https://discord.com/developers/applications/{CLIENT_ID}/oauth2`.\r\n\r\n![generate-integration-url](https://user-images.githubusercontent.com/10531605/85205615-d397eb80-b2f2-11ea-9df9-20b337292bbd.png)\r\n\r\n### Instalando\r\n\r\nClone o repositório\r\n\r\n```sh\r\ngit clone git@github.com:tiago154/discord-bot-guilda-nodejs.git\r\n\r\ncd discord-bot-guilda-nodejs\r\n```\r\n\r\nAgora instale as dependências\r\n\r\n```sh\r\nnpm install\r\n```\r\n\r\nNão esqueça de preencher o arquivo `.env` com o token do BOT (https://discordjs.guide/preparations/setting-up-a-bot-application.html#your-token) e outras variaveis de ambiente. O exemplo de quais valores deve ser preenchido está disponivel no arquivo `.env_example`.\r\n\r\nPara iniciar o bot, digite:\r\n\r\n```js\r\nnpm start\r\n```\r\n\r\nou para auto reload\r\n\r\n```js\r\nnpm run dev\r\n```\r\n\r\n## ⛏️ - Construído usando \u003ca name = \"built_using\"\u003e\u003c/a\u003e\r\n\r\n- [Discord.js](https://discord.js.org/#/) - O Discord.js é um poderoso módulo node.js que permite interagir com a API do Discord com muita facilidade\r\n- [Axios](https://www.npmjs.com/package/axios) - Cliente HTTP baseado em Promise para o navegador e node.js\r\n\r\n## ✍️ - Autores \u003ca name = \"authors\"\u003e\u003c/a\u003e\r\n\r\n- [@tiago154](https://github.com/tiago154) - Construção da ideia e trabalho inicial\r\n\r\nVeja também a lista de [contribuidores](https://github.com/tiago154/discord-bot-guilda-nodejs/contributors) que participaram deste projeto.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiago154%2Fdiscord-bot-guilda-nodejs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiago154%2Fdiscord-bot-guilda-nodejs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiago154%2Fdiscord-bot-guilda-nodejs/lists"}