-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'origin/main'
- Loading branch information
Showing
2 changed files
with
35 additions
and
58 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,81 +1,58 @@ | ||
# Getting Started | ||
|
||
Siga estes passos para configurar seu ambiente e começar: | ||
|
||
## Passo 1: Instalar o Python | ||
|
||
1. Acesse o [site oficial do Python](https://www.python.org/downloads/) para baixar e instalar o Python em seu computador. | ||
2. Durante o processo de instalação, certifique-se de marcar a opção "Adicionar Python ao PATH" para poder executar o Python facilmente pelo terminal ou prompt de comando. | ||
|
||
## Passo 2: Instalar Bibliotecas Necessárias | ||
|
||
Abra o terminal ou prompt de comando e execute os seguintes comandos para instalar as bibliotecas necessárias: | ||
Este projeto foi desenvolvido no Ubuntu LTS 22.04. Pode funcionar em outros sistemas operacionais, mas ainda não foi testado. Para rodar o projeto, siga as instruções abaixo: | ||
|
||
## Pré-requisitos | ||
Certifique-se de estar com o sistema atualizado, no terminal rode o seguinte comado: | ||
```bash | ||
pip install python-telegram-bot | ||
pip install python-dotenv | ||
pip install os | ||
sudo apt update && sudo apt upgrade | ||
``` | ||
Antes de iniciar, certifique-se de que você tenha os seguintes softwares instalados na sua máquina: | ||
|
||
## Passo 3: Configurar Seu Bot no Telegram | ||
|
||
1. Entrar em contato com o [@BotFather](https://web.telegram.org/k/#@BotFather) no Telegram. | ||
|
||
2. No chat com o BotFather, use o comando "/newbot" para criar um novo bot. | ||
|
||
3. Siga as instruções para fornecer um nome e um username para o seu bot. | ||
- Git [guia de instalação](https://git-scm.com/download/linux) | ||
- Docker e docker compose [guia de instalação](https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository) | ||
|
||
4. Após a criação, o BotFather irá fornecer um token para o seu bot. Guarde esse token pois será utilizado no código Python. | ||
|
||
## Passo 4: Configurando o ambiente | ||
|
||
Siga estes passos para clonar o repositório, configurar o token do Telegram no arquivo `.env` e executar o bot do Telegram. | ||
|
||
### Clonar o Repositório | ||
## Passo 2: Clonar o Repositório | ||
|
||
1. Abra o terminal ou prompt de comando. | ||
2. Clone o repositório usando o comando: | ||
|
||
```bash | ||
```bash | ||
git clone https://github.com/ResidenciaTICBrisa/T2G2-Chatbot-Participacao-Social | ||
``` | ||
### Acessar a Branch 'bot_telegram' | ||
|
||
1. Mude para a branch bot_telegram com o comando: | ||
|
||
```bash | ||
git checkout bot_telegram | ||
``` | ||
``` | ||
|
||
### Configurar o Arquivo .env | ||
## Passo 3: Configurar o Arquivo .env | ||
1. Crie um arquivo .env no diretório raiz do projeto. | ||
2. Abra o arquivo .env com seu editor de texto preferido. | ||
3. Adicione a seguinte linha ao arquivo .env e substitua SEU_TELEGRAM_TOKEN pelo token fornecido pelo BotFather: | ||
|
||
```bash | ||
TELEGRAM_TOKEN= 'SEU_TELEGRAM_TOKEN' | ||
``` | ||
|
||
## Passo 5: Executar o Bot do Telegram | ||
1. Certifique-se de que você está no diretório do projeto. | ||
2. Certifique-se de que você está na branch 'bot_telegram' com o comando: | ||
|
||
```shell | ||
git checkout | ||
``` | ||
|
||
3. Execute o script Python para iniciar o bot do Telegram: | ||
3. Adicione a seguintes linhas ao arquivo .env e substitua os '*' pelas credenciais que deseja criar no botpress: | ||
|
||
```bash | ||
python chatbot.py | ||
#Credenciais do postgres | ||
POSTGRES_DB= * #Nome do dbanco de dados | ||
POSTGRES_USER= * #Usuário postgress | ||
POSTGRES_PASSWORD= * #Senha do usuário postgres | ||
|
||
#Credenciais da conta de administrador do pgadmin | ||
PGADMIN_DEFAULT_EMAIL= * #email do usuário pgadmin | ||
PGADMIN_DEFAULT_PASSWORD= * #Senha do usuário pgadmin | ||
|
||
#Credencias da conta administrador do botpress | ||
BOTPRESS_ADMIN_EMAIL= * #Email da conta administrador | ||
BOTPRESS_ADMIN_PASSWORD=* #Senha da conta administrador | ||
``` | ||
## Passo 4: Executar o docker compose | ||
De o seguinte comando para rodar o sistema: | ||
```bash | ||
docker compose -f docker-compose-local.yml up | ||
``` | ||
|
||
O bot do Telegram deve estar agora em execução e pronto para interagir com os usuários. | ||
|
||
Parabéns! Você configurou e executou com sucesso o bot do Telegram. | ||
## Passo 5: Acessar o sistema | ||
Se tudo tiver sido da forma adequada, acesse o projeto através do | ||
[http://localhost:3000](http://localhost:3000) | ||
|
||
# Histórico de versão | ||
|
||
| Versão | Data | Descrição | Autor | | ||
| :----: | :--------: | :---------------------------------------------------: | :--------------: | | ||
| 1.0 | 03/04/2024 | Criação do documento | Gabriel Zaranza | | ||
| 1.0 | 03/04/2024 | Criação do documento | Gabriel Zaranza | | ||
| 1.1 | 15/07/2024 | Atualização para versão atual | Arthur Taylor | |