vfs appointment bot

Bot de agendamento VFS

Este script Python ( vfs-appointment-bot ) automatiza a verificação de compromissos no portal VFS Global em um país específico.

Instalação

O script vfs-appointment-bot pode ser instalado usando dois métodos:

1. Usando pip

É o método preferido para instalar vfs-appointment-bot . Veja como fazer isso:

1. Crie um ambiente virtual (recomendado):

   python3 -m venv venv

   Isso cria um ambiente virtual chamado venv para isolar as dependências do projeto da instalação do Python em todo o sistema ( recomendado ).

2. Ative o ambiente virtual:

   Linux/macOS:

    source venv/bin/activate

   Windows:

   venv S cripts a ctivate

3. Instale usando pip:

   pip install vfs-appointment-bot

   Isso fará o download e instalará o pacote vfs-appointment-bot e suas dependências em seu ambiente Python.

2. Instalação manual

Para um método de instalação alternativo, clone o código-fonte do repositório do projeto e instale-o manualmente.

1. Clone o repositório:

   git clone https://github.com/ranjan-mohanty/vfs-appointment-bot

2. Navegue até o diretório do projeto:

    cd vfs-appointment-bot

3. Crie um ambiente virtual (recomendado):

   python3 -m venv venv

   Isso cria um ambiente virtual chamado venv para isolar as dependências do projeto da instalação do Python em todo o sistema ( recomendado ).

4. Ative o ambiente virtual:

   Linux/macOS:

    source venv/bin/activate

   Windows:

   venv S cripts a ctivate

5. Instale dependências:

   pip install poetry
   poetry install

6. Instale dependências do dramaturgo:

   playwright install

Configuração

1. Baixe o modelo config/config.ini .

   curl -L https://raw.githubusercontent.com/ranjan-mohanty/vfs-appointment-bot/main/config/config.ini -o config.ini

2. Atualize as credenciais do vfs e as preferências do canal de notificação. Consulte a seção Canais de notificação para obter detalhes sobre como configurar notificações por e-mail, Twilio e Telegram.

3. Exporte o caminho do arquivo de configuração para a variável de ambiente VFS_BOT_CONFIG_PATH

    export VFS_BOT_CONFIG_PATH= < your-config-path > /config.ini

Se você instalou o script clonando o repositório (instalação manual) , poderá editar diretamente os valores em config/config.ini .

Uso

1. Argumento de linha de comando:

   O script exige que o código do país de origem e destino (conforme ISO 3166-1 alfa-2) seja fornecido como um argumento de linha de comando usando o -sc ou --source-country-code e -dc ou --destination-country-code -opção --destination-country-code .

2. Executando o script:

   Existem duas maneiras de fornecer os detalhes do agendamento obrigatório:

   • Respondendo às solicitações do usuário (recomendado):

     vfs-appointment-bot -sc IN -dc DE

     O script solicitará que você insira os parâmetros de nomeação necessários para o país especificado.

   • Usando -ap ou --appointment-params :

     Especifique os detalhes do compromisso em um formato de valor-chave separado por vírgula ( não separado por espaço ):

     vfs-appointment-bot -sc IN -dc DE -ap visa_center=X,visa_category=Y,visa_sub_category=Z

   O script irá então se conectar ao site da VFS Global para o país especificado, procurar compromissos disponíveis usando os parâmetros fornecidos ou inseridos e potencialmente enviar notificações (dependendo da sua configuração).

Canais de Notificação

Atualmente, ele oferece suporte a três canais de notificação para mantê-lo informado sobre a disponibilidade de compromissos:

• E-mail: Envia notificações por meio de uma conta do Gmail.
• Twilio (SMS e chamada de voz): permite alertas por meio de mensagens de texto e chamadas telefônicas usando os serviços do Twilio.
• Telegram: Envia notificações diretamente para sua conta do Telegram por meio de um bot.

Configurando notificações:

E-mail:

1. Conta de e-mail: você precisará de uma conta do Gmail para enviar notificações.

2. Senha do aplicativo: gere uma senha de aplicativo para sua conta do Gmail em vez da senha normal. Consulte o guia do Google para gerar senhas de aplicativos: https://support.google.com/accounts/answer/185833?hl=en.

3. Arquivo de configuração: atualize o arquivo de configuração da sua aplicação ( config.ini ) com os seguintes detalhes:

   • email (obrigatório): seu endereço do Gmail.
   • password (obrigatório): sua senha gerada do aplicativo Gmail.

Twilio:

1. Crie uma conta Twilio (se necessário): Cadastre-se para obter uma conta Twilio gratuita em https://www.twilio.com/en-us para obter credenciais de conta e números de telefone.

2. Recuperar credenciais: localize o SID da sua conta, o token de autenticação e os números de telefone no painel da sua conta Twilio.

3. Arquivo de configuração: atualize o arquivo de configuração da sua aplicação ( config.ini ) com:

   • auth_token (obrigatório): seu token de autenticação Twilio
   • account_sid (obrigatório): o SID da sua conta Twilio
   • sms_enabled (opcional): ativa notificações por SMS (padrão: True)
   • call_enabled (opcional): ativa notificações de chamadas de voz (padrão: falso)
   • url (opcional): URL da API Twilio (necessário apenas se a chamada estiver habilitada)
   • to_num (obrigatório): número de telefone do destinatário para notificações
   • from_num (obrigatório): número de telefone da Twilio que você usará para enviar mensagens

Telegrama:

1. Crie um bot do Telegram: Visite https://telegram.me/BotFather para criar um bot do Telegram. Siga as instruções na tela para obter o token do seu bot.

2. Arquivo de configuração: atualize o arquivo de configuração da sua aplicação ( config.ini ) com:

   • bot_token (obrigatório): seu token de bot do Telegram obtido do BotFather.
   • chat_id (opcional): O ID específico do chat do Telegram onde você deseja receber notificações. Se omitido, o bot enviará notificações para o chat de onde a mensagem foi enviada. Para encontrar seu ID de bate-papo, você pode criar um bate-papo em grupo apenas com você e usar o comando /my_id no bot.

Países suportados e parâmetros de nomeação

A tabela a seguir lista os países atualmente suportados e seus parâmetros de nomeação correspondentes:

País	Parâmetros de Compromisso
Índia(IN) - Alemanha(DE)	visa_category, visa_sub_category, visa_center
Iraque(IQ) - Alemanha(DE)	visa_category, visa_sub_category, visa_center
Marrocos(MA) - Itália(IT)	visa_category, visa_sub_category, visa_center, payment_mode
Azerbaijão(AZ) - Itália(IT)	visa_category, visa_sub_category, visa_center

Notas:

• Os parâmetros de agendamento podem variar dependendo do país específico e do tipo de visto. Consulte sempre o site da VFS Global para obter as informações mais recentes.

Problemas conhecidos

1. Falhas de login após solicitações frequentes:
Se o bot fizer solicitações de login no site VFS com muita frequência, o sistema VFS poderá bloquear temporariamente seu acesso devido a suspeita de automação. Isso pode levar a falhas de login.

• Solução alternativa:
  • Reduza a frequência de solicitações: considere aumentar o atraso entre as execuções do bot para evitar o acionamento dos mecanismos de bloqueio do VFS. Você pode ajustar o intervalo na configuração ou no código.
  • Tentar novamente após 2 horas: se você encontrar uma falha de login, aguarde pelo menos 2 horas antes de tentar novamente. O bloco VFS deve expirar dentro deste prazo.

2. Verificação ocasional de Captcha:
O site VFS requer uma etapa de verificação CAPTCHA durante o login. Atualmente, o bot não possui um solucionador CAPTCHA integrado.

• Solução alternativa:
  • Espere e tente novamente: às vezes, CAPTCHAs aparecem devido a problemas temporários no site. Aguarde um pouco e tente novamente mais tarde.
  • Tente novamente em outro navegador: os CAPTCHAs geralmente são resolvidos automaticamente no navegador Firefox. Se ainda falhar, tente novamente o processo de login em outro navegador, definindo browser_type como "chromium" or "webkit" em seu arquivo config.ini .

Observação: estamos trabalhando constantemente para melhorar a funcionalidade do bot. Atualizações futuras podem incluir recursos integrados de resolução de CAPTCHA.

Estendendo o Apoio ao País

Este script está atualmente projetado para funcionar com o site VFS Global para a Alemanha. Pode ser possível estender o suporte para outros países, modificando o script para lidar com possíveis variações na estrutura do site e nos requisitos de parâmetros em diferentes páginas de países da VFS Global.

Contribuindo

Agradecemos contribuições da comunidade para melhorar este projeto! Veja como você pode se envolver:

• Reportar problemas: Se você encontrar algum bug ou problema com o script, crie um problema no repositório do projeto.
• Sugira melhorias: você tem ideias para tornar o script mais fácil de usar ou rico em recursos? Sinta-se à vontade para criar um problema ou solicitação pull no repositório.
• Envie solicitações pull: se você fez alterações no código que acha que beneficiariam o projeto, crie uma solicitação pull no repositório. Siga todas as diretrizes de contribuição descritas em um arquivo CONTRIBUTING.md.

História das Estrelas

Isenção de responsabilidade

Este script é fornecido no estado em que se encontra e não é afiliado à VFS Global. É sua responsabilidade garantir que você cumpra os termos e condições da VFS Global ao usar este script. Esteja ciente de que as estruturas do site e os mecanismos de disponibilidade de agendamento podem mudar com o tempo.