https://github.com/vilhalva/conversador-no-telegram
🤖BOT DO TELEGRAM QUE CONVERSA NO GRUPO SOBRE UMA VARIEDADE DE TÓPICOS.
https://github.com/vilhalva/conversador-no-telegram
bot framework json projeto python redes-sociais telebot telegram
Last synced: about 1 month ago
JSON representation
🤖BOT DO TELEGRAM QUE CONVERSA NO GRUPO SOBRE UMA VARIEDADE DE TÓPICOS.
- Host: GitHub
- URL: https://github.com/vilhalva/conversador-no-telegram
- Owner: VILHALVA
- Created: 2024-09-20T20:29:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-12T16:01:18.000Z (9 months ago)
- Last Synced: 2025-02-12T17:22:01.720Z (9 months ago)
- Topics: bot, framework, json, projeto, python, redes-sociais, telebot, telegram
- Language: Python
- Homepage:
- Size: 250 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CONVERSADOR NO TELEGRAM
🤖BOT DO TELEGRAM QUE CONVERSA NO GRUPO SOBRE UMA VARIEDADE DE TÓPICOS.
## DESCRIÇÃO:
Este bot é um assistente virtual básico projetado para interagir com os usuários de forma eficiente. Ao ser iniciado, o bot carrega automaticamente dois arquivos essenciais: "WORD.json" e "CONFIG.json". O arquivo "WORD.json" contém uma lista de palavras-chave e suas respostas correspondentes, permitindo que o bot responda a uma variedade de perguntas comuns e forneça informações úteis aos usuários.
Por sua vez, o arquivo "CONFIG.json" define o comportamento do bot. Nele, as configurações podem ser ajustadas conforme necessário para personalizar a interação.
O bot é capaz de compreender palavras-chave em uma frase completa, o que significa que não é necessário que a mensagem do usuário consista apenas na palavra-chave, mas pode ser uma parte dela dentro de uma frase.
## FUNCIONALIDADES:
1. **Respostas a Perguntas Comuns:**
- O bot é capaz de responder a perguntas simples, como "qual é o seu nome?", "como você está?", "o que você pode fazer?", e saudações como "oi" e "tchau".
- Além disso, pode fornecer respostas sobre tópicos como programação, ciência, tecnologia, entre outros.
2. **Gerenciamento Dinâmico de Respostas:**
- Se uma mensagem não corresponder a nenhuma resposta pré-definida, e o modo de erro e criação estiverem habilitados no arquivo "CONFIG.json", o bot solicitará ao usuário que forneça uma resposta para ser adicionada ao banco de dados.
- Ao receber uma entrada no formato correto (`PALAVRA CHAVE: RESPOSTA`), o bot armazena a nova palavra-chave no arquivo "WORD.json" e reinicia para aplicar a nova configuração.
3. **Configurações Avançadas via "CONFIG.json":**
- O comportamento do bot é definido por configurações como:
- **"SEMPRE"**: Define se o bot deve responder sempre, independentemente do tipo de chat.
- **"CRIAR"**: Habilita ou desabilita a funcionalidade de adicionar novas respostas.
- **"ERRO"**: Controla se o bot deve enviar mensagens de erro quando não entende a entrada do usuário.
4. **Reconhecimento de Palavras-chave em Frases:**
- O bot é capaz de identificar palavras-chave dentro de uma frase completa, permitindo maior flexibilidade na forma como o usuário interage.
- Mesmo que a palavra-chave não seja a única palavra na frase, o bot pode reconhecer e fornecer a resposta correspondente.
5. **Tratamento de Mensagens Não Compreendidas:**
- Se o bot não entender a mensagem, ele pode, dependendo das configurações, sugerir que o usuário siga o formato específico para adicionar uma nova palavra-chave ou simplesmente informar que não entendeu.
- Se a funcionalidade de criação estiver ativa, o bot solicitará uma entrada formatada para adicionar novas palavras e respostas.
6. **Comandos Iniciais e Marcações:**
- O comando `/start` é utilizado para iniciar o bot, enviando uma mensagem de boas-vindas e apresentando ao usuário algumas opções de interação.
- O bot também apresenta botões inline com links para o canal e o criador, utilizando o `InlineKeyboardMarkup` do Telegram.
## COMO USAR?
1. **Instale as bibliotecas necessárias:** Antes de executar o bot, certifique-se de instalar todas as dependências necessárias. No terminal, execute o seguinte comando para instalar as dependências listadas no arquivo requirements.txt em `CODIGO`:
```bash
pip install -r requirements.txt
```
2. **Coloque o Token:**
- Antes de executar o bot, é necessário substituir pelo seu token no arquivo `TOKEN.py`, o qual pode ser obtido por meio do [@BotFather](https://t.me/BotFather).
3. **Adicionar o Bot a um Grupo:** Adicione o bot ao grupo do Telegram onde você deseja que ele converse.
4. **Executar o Bot:** Inicie o bot. Ele começará a monitorar as mensagens no grupo e responderá automaticamente quando uma palavra-chave definida for encontrada em uma mensagem.
- Execute o bot do Telegram em Python iniciando-o com o seguinte comando:
```bash
python MAIN.py
```
- Inicie o bot enviando o comando `/start`.
5. **Interagir com o Bot:** Agora, sempre que alguém enviar uma mensagem contendo uma das palavras-chave definidas, o bot responderá automaticamente à mensagem com uma resposta correspondente.
6. **Configure o Arquivo `WORD.json`:** No arquivo "WORD.json", você pode definir as palavras-chave desejadas como chaves do dicionário e as respostas correspondentes como valores associados.
Por exemplo:
```json
{
"novo": "todos nós estamos aprendendo!",
"cheguei": "seja bem vindo!",
"feliz": "isso é bom!",
"python": "python é uma linguagem de programação muito poderosa e versátil"
}
```
## COMO USAR O `CONFIG.json`?
### DESCRIÇÃO:
Aqui está uma descrição do que acontece quando cada chave no arquivo "CONFIG.json" está definida como "ON" ou "OFF":
| Chave | Descrição | Comportamento quando "ON" | Comportamento quando "OFF" |
|---------|-------------------------------------------|-------------------------------------------------------|-------------------------------------------------------|
| SEMPRE | Sempre Responder | O bot responderá a todas as mensagens, independentemente se for mencionado via user (@). | O bot responderá apenas se for mencionado via user (@). |
| CRIAR | Permitir Adicionar Respostas | Os usuários poderão adicionar novas respostas ao banco de dados do bot. | Os usuários não poderão adicionar novas respostas. |
| ERRO | Ativar Mensagem de Erro | Se o bot não entender a mensagem do usuário, ele enviará uma mensagem indicando que não compreendeu e oferecerá orientações sobre como reenviar a mensagem seguindo um formato específico. | Se o bot não entender a mensagem do usuário, ele não enviará uma mensagem de erro e não oferecerá orientações para reenviar a mensagem. |
### PADRÃO:
Por padrão, eu configurei o arquivo "CONFIG.json" com as seguintes configurações:
```json
{
"SEMPRE": "ON",
"CRIAR": "OFF",
"ERRO": "ON"
}
```
Significa o seguinte:
- **SEMPRE: "ON"**
- Isso significa que o bot estará sempre pronto para responder a qualquer mensagem que receber no grupo, Mesmo que o user dele não seja mencionado.
- **CRIAR: "OFF"**
- Com esta configuração, os usuários não poderão adicionar novas respostas ao banco de dados do bot. Isso significa que apenas as respostas pré-definidas no arquivo "WORD.json" serão reconhecidas e respondidas pelo bot.
- **ERRO: "ON"**
- Isso indica que o bot está configurado para enviar uma mensagem de erro quando não entender a mensagem do usuário.
Essas configurações permitem controlar o comportamento do bot de acordo com suas necessidades e preferências. Ajuste as configurações conforme desejado para personalizar a experiência do bot de acordo com sua necessidade.
## NÃO SABE?
- Entendemos que para manipular arquivos em muitas linguagens e tecnologias relacionadas, é necessário possuir conhecimento nessas áreas. Para auxiliar nesse aprendizado, oferecemos alguns subsidios:
* [CURSO DE TELEBOT](https://github.com/VILHALVA/CURSO-DE-TELEBOT)
* [CURSO DE PYTHON](https://github.com/VILHALVA/CURSO-DE-PYTHON)
* [CURSO DE JSON](https://github.com/VILHALVA/CURSO-DE-JSON)
* [CONFIRA MAIS CURSOS](https://github.com/VILHALVA?tab=repositories&q=+topic:CURSO)
## CREDITOS:
- [PROJETO CRIADO PELO VILHALVA](https://github.com/VILHALVA)