vfs appointment bot

Bot de rendez-vous VFS

Ce script Python ( vfs-appointment-bot ) automatise la vérification des rendez-vous sur le portail VFS Global dans un pays spécifié.

Installation

Le script vfs-appointment-bot peut être installé en utilisant deux méthodes :

1. Utiliser pip

Il s'agit de la méthode préférée pour installer vfs-appointment-bot . Voici comment procéder :

1. Créez un environnement virtuel (recommandé) :

   python3 -m venv venv

   Cela crée un environnement virtuel nommé venv pour isoler les dépendances du projet de votre installation Python à l'échelle du système ( recommandé ).

2. Activez l'environnement virtuel :

   Linux/macOS :

    source venv/bin/activate

   Fenêtres :

   venv S cripts a ctivate

3. Installer en utilisant pip :

   pip install vfs-appointment-bot

   Cela téléchargera et installera le package vfs-appointment-bot et ses dépendances dans votre environnement Python.

2. Installation manuelle

Pour une méthode d'installation alternative, clonez le code source du référentiel du projet et installez-le manuellement.

1. Clonez le dépôt :

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

2. Accédez au répertoire du projet :

    cd vfs-appointment-bot

3. Créez un environnement virtuel (recommandé) :

   python3 -m venv venv

   Cela crée un environnement virtuel nommé venv pour isoler les dépendances du projet de votre installation Python à l'échelle du système ( recommandé ).

4. Activez l'environnement virtuel :

   Linux/macOS :

    source venv/bin/activate

   Fenêtres :

   venv S cripts a ctivate

5. Installer les dépendances :

   pip install poetry
   poetry install

6. Installez les dépendances du dramaturge :

   playwright install

Configuration

1. Téléchargez le modèle config/config.ini .

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

2. Mettez à jour les informations d’identification VFS et les préférences du canal de notification. Consultez la section Canaux de notification pour plus de détails sur la configuration des notifications par e-mail, Twilio et Telegram.

3. Exportez le chemin du fichier de configuration vers la variable d'environnement VFS_BOT_CONFIG_PATH

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

Si vous avez installé le script en clonant le référentiel (installation manuelle) , vous pouvez directement modifier les valeurs dans config/config.ini .

Usage

1. Argument de ligne de commande :

   Le script nécessite que le code du pays source et du pays de destination (conformément à la norme ISO 3166-1 alpha-2) soit fourni comme argument de ligne de commande en utilisant -sc ou --source-country-code et -dc ou --destination-country-code -option --destination-country-code .

2. Exécution du script :

   Il existe deux manières de fournir les détails requis du rendez-vous :

   • Répondre aux invites de l'utilisateur (recommandé) :

     vfs-appointment-bot -sc IN -dc DE

     Le script vous demandera de saisir les paramètres de rendez-vous requis pour le pays spécifié.

   • En utilisant -ap ou --appointment-params :

     Spécifiez les détails du rendez-vous dans un format clé-valeur séparé par des virgules ( et non par des espaces ) :

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

   Le script se connectera ensuite au site Web VFS Global du pays spécifié, recherchera les rendez-vous disponibles à l'aide des paramètres fournis ou saisis et enverra potentiellement des notifications (selon votre configuration).

Canaux de notification

Il prend actuellement en charge trois canaux de notification pour vous tenir informé de la disponibilité des rendez-vous :

• E-mail : envoie des notifications via un compte Gmail.
• Twilio (SMS et appel vocal) : active les alertes via des messages texte et des appels téléphoniques à l'aide des services de Twilio.
• Telegram : envoie des notifications directement à votre compte Telegram via un bot.

Configuration des notifications :

E-mail:

1. Compte de messagerie : vous aurez besoin d'un compte Gmail pour envoyer des notifications.

2. Mot de passe d'application : générez un mot de passe d'application pour votre compte Gmail au lieu de votre mot de passe habituel. Reportez-vous au guide de Google pour générer des mots de passe d'application : https://support.google.com/accounts/answer/185833?hl=en.

3. Fichier de configuration : mettez à jour le fichier de configuration de votre application ( config.ini ) avec les détails suivants :

   • email (Obligatoire) : Votre adresse Gmail.
   • password (obligatoire) : votre mot de passe généré pour l'application Gmail.

Twilio :

1. Créez un compte Twilio (si nécessaire) : inscrivez-vous pour un compte Twilio gratuit sur https://www.twilio.com/en-us pour obtenir les informations d'identification du compte et les numéros de téléphone.

2. Récupérer les informations d'identification : localisez le SID de votre compte, votre jeton d'authentification et vos numéros de téléphone dans le tableau de bord de votre compte Twilio.

3. Fichier de configuration : mettez à jour le fichier de configuration de votre application ( config.ini ) avec :

   • auth_token (obligatoire) : votre jeton d'authentification Twilio
   • account_sid (obligatoire) : le SID de votre compte Twilio
   • sms_enabled (Facultatif) : Active les notifications par SMS (par défaut : True)
   • call_enabled (Facultatif) : Active les notifications d'appels vocaux (par défaut : False)
   • url (Facultatif) : URL de l'API Twilio (nécessaire uniquement si l'appel est activé)
   • to_num (obligatoire) : numéro de téléphone du destinataire pour les notifications
   • from_num (obligatoire) : numéro de téléphone Twilio que vous utiliserez pour envoyer des messages

Télégramme:

1. Créez un bot Telegram : visitez https://telegram.me/BotFather pour créer un bot Telegram. Suivez les instructions à l'écran pour obtenir le jeton de votre bot.

2. Fichier de configuration : mettez à jour le fichier de configuration de votre application ( config.ini ) avec :

   • bot_token (obligatoire) : votre jeton de bot Telegram obtenu auprès de BotFather.
   • chat_id (Facultatif) : L'ID de chat Telegram spécifique où vous souhaitez recevoir des notifications. En cas d'omission, le bot enverra des notifications au chat d'où il a été envoyé. Pour trouver votre identifiant de discussion, vous pouvez créer une discussion de groupe avec vous-même, puis utiliser la commande /my_id dans le bot.

Pays pris en charge et paramètres de rendez-vous

Le tableau suivant répertorie les pays actuellement pris en charge et leurs paramètres de rendez-vous correspondants :

Pays	Paramètres de rendez-vous
Inde(IN) - Allemagne(DE)	visa_category, visa_sub_category, visa_center
Irak(IQ) - Allemagne(DE)	visa_category, visa_sub_category, visa_center
Maroc(MA) - Italie(IT)	visa_category, visa_sub_category, visa_center, payment_mode
Azerbaïdjan(AZ) - Italie(IT)	visa_category, visa_sub_category, visa_center

Remarques :

• Les paramètres de rendez-vous peuvent varier en fonction du pays spécifique et du type de visa. Consultez toujours le site Web de VFS Global pour obtenir les dernières informations.

Problèmes connus

1. Échecs de connexion après des demandes fréquentes :
Si le bot effectue trop fréquemment des demandes de connexion au site Web VFS, le système VFS peut bloquer temporairement votre accès en raison d'une automatisation suspectée. Cela peut entraîner des échecs de connexion.

• Solution de contournement :
  • Réduire la fréquence des requêtes : pensez à augmenter le délai entre les exécutions du bot pour éviter de déclencher les mécanismes de blocage de VFS. Vous pouvez ajuster l'intervalle dans la configuration ou le code.
  • Réessayez après 2 heures : si vous rencontrez un échec de connexion, attendez au moins 2 heures avant de réessayer. Le bloc VFS devrait expirer dans ce délai.

2. Vérification Captcha occasionnelle :
Le site Web VFS nécessite une étape de vérification CAPTCHA lors de la connexion. Actuellement, le bot ne dispose pas de solveur CAPTCHA intégré.

• Solution de contournement :
  • Attendez et réessayez : Parfois, des CAPTCHA apparaissent en raison de problèmes temporaires sur le site Web. Attendez un moment et réessayez plus tard.
  • Réessayez dans un autre navigateur : les CAPTCHA sont souvent résolus automatiquement dans le navigateur Firefox. Si l'échec persiste, réessayez le processus de connexion dans un autre navigateur en définissant browser_type sur "chromium" or "webkit" dans votre fichier config.ini .

Remarque : Nous travaillons constamment à améliorer les fonctionnalités du bot. Les futures mises à jour pourraient inclure des capacités intégrées de résolution de CAPTCHA.

Extension du soutien aux pays

Ce script est actuellement conçu pour fonctionner avec le site Web VFS Global pour l'Allemagne. Il pourrait être possible d'étendre la prise en charge à d'autres pays en modifiant le script pour gérer les variations potentielles de la structure du site Web et des exigences en matière de paramètres sur les différentes pages de pays de VFS Global.

Contribuer

Nous apprécions les contributions de la communauté pour améliorer ce projet ! Voici comment vous pouvez vous impliquer :

• Signaler les problèmes : si vous rencontrez des bugs ou des problèmes avec le script, veuillez créer un problème sur le référentiel du projet.
• Suggérer des améliorations : avez-vous des idées pour rendre le script plus convivial ou plus riche en fonctionnalités ? N'hésitez pas à créer un ticket ou une pull request sur le référentiel.
• Soumettre des demandes d'extraction : si vous avez apporté des modifications au code qui, selon vous, pourraient profiter au projet, créez une demande d'extraction sur le référentiel. Veuillez suivre toutes les directives de contribution décrites dans un fichier CONTRIBUTING.md.

Histoire des étoiles

Clause de non-responsabilité

Ce script est fourni tel quel et n'est pas affilié à VFS Global. Il est de votre responsabilité de vous assurer que vous respectez les termes et conditions de VFS Global lorsque vous utilisez ce script. Soyez conscient que les structures des sites Web et les mécanismes de disponibilité des rendez-vous peuvent changer avec le temps.