vfs appointment bot

บอทนัดหมาย VFS

สคริปต์ Python นี้ ( vfs-appointment-bot ) จะทำการตรวจสอบการนัดหมายที่พอร์ทัล VFS Global ในประเทศที่ระบุโดยอัตโนมัติ

การติดตั้ง

สคริปต์ vfs-appointment-bot สามารถติดตั้งได้โดยใช้สองวิธี:

1. การใช้ pip

เป็นวิธีที่แนะนำในการติดตั้ง vfs-appointment-bot ต่อไปนี้เป็นวิธีดำเนินการ:

1. สร้างสภาพแวดล้อมเสมือน (แนะนำ):

   python3 -m venv venv

   สิ่งนี้จะสร้างสภาพแวดล้อมเสมือนชื่อ venv เพื่อแยกการพึ่งพาโปรเจ็กต์จากการติดตั้ง Python ทั่วทั้งระบบ ( แนะนำ )

2. เปิดใช้งานสภาพแวดล้อมเสมือน:

   ลินุกซ์/macOS:

    source venv/bin/activate

   หน้าต่าง:

   venv S cripts a ctivate

3. ติดตั้งโดยใช้ pip:

   pip install vfs-appointment-bot

   สิ่งนี้จะดาวน์โหลดและติดตั้งแพ็คเกจ vfs-appointment-bot และการขึ้นต่อกันของแพ็คเกจในสภาพแวดล้อม Python ของคุณ

2. การติดตั้งด้วยตนเอง

สำหรับวิธีการติดตั้งแบบอื่น ให้โคลนซอร์สโค้ดจากที่เก็บโปรเจ็กต์และติดตั้งด้วยตนเอง

1. โคลนที่เก็บ:

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

2. นำทางไปยังไดเร็กทอรีโครงการ:

    cd vfs-appointment-bot

3. สร้างสภาพแวดล้อมเสมือน (แนะนำ):

   python3 -m venv venv

   สิ่งนี้จะสร้างสภาพแวดล้อมเสมือนชื่อ venv เพื่อแยกการพึ่งพาโปรเจ็กต์จากการติดตั้ง Python ทั่วทั้งระบบ ( แนะนำ )

4. เปิดใช้งานสภาพแวดล้อมเสมือน:

   ลินุกซ์/macOS:

    source venv/bin/activate

   หน้าต่าง:

   venv S cripts a ctivate

5. ติดตั้งการพึ่งพา:

   pip install poetry
   poetry install

6. ติดตั้งการพึ่งพานักเขียนบทละคร:

   playwright install

การกำหนดค่า

1. ดาวน์โหลดเทมเพลต config/config.ini

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

2. อัปเดตข้อมูลรับรอง vfs และการตั้งค่าช่องทางการแจ้งเตือน ดูส่วนช่องทางการแจ้งเตือนสำหรับรายละเอียดเกี่ยวกับการกำหนดค่าการแจ้งเตือนอีเมล Twilio และ Telegram

3. ส่งออกเส้นทางของไฟล์กำหนดค่าไปยังตัวแปรสภาพแวดล้อม VFS_BOT_CONFIG_PATH

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

หากคุณติดตั้งสคริปต์โดยการโคลนพื้นที่เก็บข้อมูล (การติดตั้งด้วยตนเอง) คุณสามารถแก้ไขค่าใน config/config.ini ได้โดยตรง

การใช้งาน

1. อาร์กิวเมนต์บรรทัดคำสั่ง:

   สคริปต์กำหนดให้ระบุรหัสประเทศต้นทางและปลายทาง (ตามมาตรฐาน ISO 3166-1 alpha-2) เป็นอาร์กิวเมนต์บรรทัดคำสั่งโดยใช้ -sc หรือ --source-country-code และ -dc หรือ --destination-country-code ตัวเลือก --destination-country-code

2. การรันสคริปต์:

   มีสองวิธีในการระบุรายละเอียดการนัดหมายที่จำเป็น:

   • การตอบสนองต่อพรอมต์ผู้ใช้ (แนะนำ):

     vfs-appointment-bot -sc IN -dc DE

     สคริปต์จะแจ้งให้คุณป้อนพารามิเตอร์การนัดหมายที่จำเป็นสำหรับประเทศที่ระบุ

   • การใช้ -ap หรือ --appointment-params :

     ระบุรายละเอียดการนัดหมายในรูปแบบคีย์-ค่าที่คั่นด้วยเครื่องหมายจุลภาค ( ไม่คั่นด้วยช่องว่าง ):

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

   จากนั้นสคริปต์จะเชื่อมต่อกับเว็บไซต์ VFS Global สำหรับประเทศที่ระบุ ค้นหาการนัดหมายที่มีอยู่โดยใช้พารามิเตอร์ที่ให้ไว้หรือที่ป้อน และอาจส่งการแจ้งเตือน (ขึ้นอยู่กับการกำหนดค่าของคุณ)

ช่องทางการแจ้งเตือน

ขณะนี้รองรับช่องทางการแจ้งเตือนสามช่องทางเพื่อแจ้งให้คุณทราบเกี่ยวกับความพร้อมในการนัดหมาย:

• อีเมล: ส่งการแจ้งเตือนผ่านบัญชี Gmail
• Twilio (SMS & Voice Call): เปิดใช้งานการแจ้งเตือนผ่านข้อความและโทรศัพท์โดยใช้บริการของ Twilio
• Telegram: ส่งการแจ้งเตือนโดยตรงไปยังบัญชี Telegram ของคุณผ่านบอท

การกำหนดค่าการแจ้งเตือน:

อีเมล:

1. บัญชีอีเมล: คุณจะต้องมี บัญชี Gmail เพื่อส่งการแจ้งเตือน

2. รหัสผ่านสำหรับแอป: สร้างรหัสผ่านสำหรับแอปสำหรับบัญชี Gmail ของคุณแทนรหัสผ่านปกติ ดูคำแนะนำของ Google สำหรับการสร้างรหัสผ่านสำหรับแอป: https://support.google.com/accounts/answer/185833?hl=th

3. ไฟล์การกำหนดค่า: อัปเดตไฟล์การกำหนดค่าแอปพลิเคชันของคุณ ( config.ini ) โดยมีรายละเอียดดังต่อไปนี้:

   • email (จำเป็น): ที่อยู่ Gmail ของคุณ
   • password (จำเป็น): รหัสผ่านแอป Gmail ที่คุณสร้างขึ้น

ทวิลิโอ:

1. สร้างบัญชี Twilio (หากจำเป็น): ลงทะเบียนเพื่อรับบัญชี Twilio ฟรีที่ https://www.twilio.com/en-us เพื่อรับข้อมูลรับรองบัญชีและหมายเลขโทรศัพท์

2. ดึงข้อมูลประจำตัว: ค้นหา SID บัญชีของคุณ โทเค็นการตรวจสอบสิทธิ์ และหมายเลขโทรศัพท์ภายในแดชบอร์ดบัญชี Twilio ของคุณ

3. ไฟล์การกำหนดค่า: อัปเดตไฟล์การกำหนดค่าแอปพลิเคชันของคุณ ( config.ini ) ด้วย:

   • auth_token (จำเป็น): โทเค็นการตรวจสอบสิทธิ์ Twilio ของคุณ
   • account_sid (จำเป็น): SID บัญชี Twilio ของคุณ
   • sms_enabled (ไม่บังคับ): เปิดใช้งานการแจ้งเตือนทาง SMS (ค่าเริ่มต้น: True)
   • call_enabled (ไม่บังคับ): เปิดใช้งานการแจ้งเตือนการโทรด้วยเสียง (ค่าเริ่มต้น: เท็จ)
   • url (ไม่บังคับ): Twilio API URL (จำเป็นเฉพาะเมื่อเปิดใช้งานการโทร)
   • to_num (จำเป็น): หมายเลขโทรศัพท์ของผู้รับสำหรับการแจ้งเตือน
   • from_num (จำเป็น): หมายเลขโทรศัพท์ Twilio ที่คุณจะใช้สำหรับส่งข้อความ

โทรเลข:

1. สร้าง Telegram Bot: ไปที่ https://telegram.me/BotFather เพื่อสร้าง Telegram bot ปฏิบัติตามคำแนะนำบนหน้าจอเพื่อรับโทเค็นของบอท

2. ไฟล์การกำหนดค่า: อัปเดตไฟล์การกำหนดค่าแอปพลิเคชันของคุณ ( config.ini ) ด้วย:

   • bot_token (จำเป็น): โทเค็นบอท Telegram ของคุณที่ได้รับจาก BotFather
   • chat_id (ไม่บังคับ): ID แชท Telegram เฉพาะที่คุณต้องการรับการแจ้งเตือน หากละเว้น บอทจะส่งการแจ้งเตือนไปยังแชทที่ส่งข้อความมา หากต้องการค้นหา ID แชทของคุณ คุณสามารถสร้างแชทกลุ่มกับตัวคุณเอง จากนั้นใช้คำสั่ง /my_id ภายในบอท

ประเทศที่รองรับและพารามิเตอร์การนัดหมาย

ตารางต่อไปนี้แสดงรายการประเทศที่รองรับในปัจจุบันและพารามิเตอร์การนัดหมายที่เกี่ยวข้อง:

ประเทศ	พารามิเตอร์การนัดหมาย
อินเดีย(IN) - เยอรมนี(DE)	visa_category, visa_sub_category, visa_center
อิรัก(IQ) - เยอรมนี(DE)	visa_category, visa_sub_category, visa_center
โมร็อกโก(แมสซาชูเซตส์) - อิตาลี(ไอที)	visa_category, visa_sub_category, visa_center, การชำระเงิน_โหมด
อาเซอร์ไบจาน(AZ) - อิตาลี(IT)	visa_category, visa_sub_category, visa_center

หมายเหตุ:

• พารามิเตอร์การนัดหมายอาจแตกต่างกันไปขึ้นอยู่กับประเทศและประเภทของวีซ่า ปรึกษาเว็บไซต์ของ VFS Global เสมอสำหรับข้อมูลล่าสุด

ปัญหาที่ทราบ

1. ความล้มเหลวในการเข้าสู่ระบบหลังจากการร้องขอบ่อยครั้ง:
หากบอทส่งคำขอเข้าสู่ระบบไปยังเว็บไซต์ VFS บ่อยเกินไป ระบบ VFS อาจบล็อกการเข้าถึงของคุณชั่วคราวเนื่องจากระบบอัตโนมัติที่น่าสงสัย ซึ่งอาจนำไปสู่การเข้าสู่ระบบล้มเหลว

• วิธีแก้ปัญหา:
  • ลดความถี่ในการร้องขอ: พิจารณาเพิ่มความล่าช้าระหว่างการทำงานของบอทเพื่อหลีกเลี่ยงการทริกเกอร์กลไกการบล็อกของ VFS คุณสามารถปรับช่วงเวลาในการกำหนดค่าหรือโค้ดได้
  • ลองอีกครั้งหลังจาก 2 ชั่วโมง: หากคุณพบว่าการเข้าสู่ระบบล้มเหลว ให้รออย่างน้อย 2 ชั่วโมงก่อนลองอีกครั้ง บล็อก VFS ควรหมดอายุภายในกรอบเวลานี้

2. การตรวจสอบ Captcha เป็นครั้งคราว:
เว็บไซต์ VFS ต้องมีขั้นตอนการตรวจสอบ CAPTCHA ระหว่างการเข้าสู่ระบบ ปัจจุบัน บอทไม่มีตัวแก้ปัญหา CAPTCHA ในตัว

• วิธีแก้ปัญหา:
  • รอแล้วลองอีกครั้ง: บางครั้ง CAPTCHA จะปรากฏขึ้นเนื่องจากปัญหาเว็บไซต์ชั่วคราว โปรดรอสักครู่แล้วลองอีกครั้งในภายหลัง
  • ลองอีกครั้งในเบราว์เซอร์อื่น: CAPTCHA มักจะถูกแก้ไขโดยอัตโนมัติในเบราว์เซอร์ Firefox หากยังคงล้มเหลว ให้ลองกระบวนการเข้าสู่ระบบอีกครั้งในเบราว์เซอร์อื่นโดยตั้ง browser_type เป็น "chromium" or "webkit" ในไฟล์ config.ini ของคุณ

หมายเหตุ: เรากำลังทำงานอย่างต่อเนื่องเพื่อปรับปรุงการทำงานของบอท การอัปเดตในอนาคตอาจรวมถึงความสามารถในการแก้ไข CAPTCHA แบบรวม

การขยายการสนับสนุนประเทศ

ปัจจุบันสคริปต์นี้ได้รับการออกแบบให้ทำงานร่วมกับเว็บไซต์ VFS Global ในประเทศเยอรมนี อาจเป็นไปได้ที่จะขยายการสนับสนุนไปยังประเทศอื่นๆ โดยการแก้ไขสคริปต์เพื่อรองรับการเปลี่ยนแปลงที่อาจเกิดขึ้นในโครงสร้างเว็บไซต์และข้อกำหนดพารามิเตอร์ในหน้าต่างๆ ของประเทศต่างๆ ของ VFS Global

มีส่วนร่วม

เรายินดีรับการสนับสนุนจากชุมชนเพื่อปรับปรุงโครงการนี้! คุณสามารถมีส่วนร่วมได้ดังนี้:

• รายงานปัญหา: หากคุณพบข้อบกพร่องหรือปัญหาใดๆ กับสคริปต์ โปรดสร้างปัญหาบนที่เก็บของโปรเจ็กต์
• แนะนำการปรับปรุง: คุณมีแนวคิดในการทำให้สคริปต์ใช้งานง่ายขึ้นหรือมีคุณสมบัติหลากหลายหรือไม่? อย่าลังเลที่จะสร้างปัญหาหรือดึงคำขอจากพื้นที่เก็บข้อมูล
• ส่งคำขอดึง: หากคุณได้ทำการเปลี่ยนแปลงโค้ดที่คุณคิดว่าจะเป็นประโยชน์ต่อโปรเจ็กต์ ให้สร้างคำขอดึงบนที่เก็บ โปรดปฏิบัติตามแนวทางการสนับสนุนที่ระบุไว้ในไฟล์ CONTRIBUTING.md

ประวัติดารา

ข้อสงวนสิทธิ์

สคริปต์นี้จัดทำขึ้นตามที่เป็นอยู่และไม่มีส่วนเกี่ยวข้องกับ VFS Global คุณมีหน้าที่รับผิดชอบในการตรวจสอบให้แน่ใจว่าคุณปฏิบัติตามข้อกำหนดและเงื่อนไขของ VFS Global เมื่อใช้สคริปต์นี้ โปรดทราบว่าโครงสร้างเว็บไซต์และกลไกความพร้อมในการนัดหมายอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป