一个自动跟踪申根签证预约并通过 Telegram 发送通知的机器人。
merhabalar,
anlık olarak kod VFS güncellemelerinden dolayı işe yaramıyor,
github üzerinden daha güncellenmiş versiyonlara araştırarak erişebilirsiniz.
teşekkürler!Bu bot, Schengen vizesi için randevu durumlarını otomatik olarak takip eder ve uygun randevular bulunduğunda Telegram üzerinden bildirim gönderir.
country_code), hedef ülke (mission_code) ve şehir (center içinde) bazında filtrelemevisa_type) göre filtrelemeopen) veya 'bekleme listesi açık' (waitlist_open) durumundaki randevuları bildirmeDEBUG=true)Docker'ı sisteminize kurmak için:
Windows/Mac:
Docker Desktop uygulamasını indirip kurun.
Linux (Ubuntu/Debian):
sudo apt update
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh
# post installation steps
sudo groupadd docker
sudo usermod -aG docker $USER
# Log out and log back in so that your group membership is re-evaluated.Kurulumdan sonra terminalde docker --version ve docker compose version komutları ile kurulumun başarılı olduğunu doğrulayabilirsiniz.
Bot'un sürekli çalışabilmesi için aşağıdaki seçeneklerden birine ihtiyacınız var:
**VPS (Virtual Private Server) - Önerilen **
Kişisel Bilgisayar
Raspberry Pi
⚠️ Önemli Not: Bot'un randevuları kaçırmaması için sürekli çalışır durumda olması gerekir. VPS kullanımı, kesintisiz çalışma ve düşük maliyet açısından en ideal çözümdür.
/newbot komutunu gönderinhttps://api.telegram.org/bot/getUpdates"chat":{"id":-100xxxxxxxxxx} şeklinde bir alan arayın.id değerini (başındaki eksi işareti dahil) kaydedin. Bu sizin Kanal/Grup ID'nizdir (örn: -100123456789).git clone https://github.com/byigitt/visa-checker.git
cd visa-checker# npm kullanıyorsanız
npm install
# yarn kullanıyorsanız
yarn install
# pnpm kullanıyorsanız
pnpm install.env.example dosyasını kopyalayarak .env adında yeni bir dosya oluşturun. Windows'ta:copy .env.example .envLinux/macOS'ta:
cp .env.example .env.env dosyasını bir metin düzenleyici ile açın ve aşağıdaki gibi düzenleyin:…Önemli .env Açıklamaları:
TARGET_COUNTRY: API yanıtındaki country_code alanına göre filtreler (örn: tur, gbr). Tüm ülkeler için all yazılabilir. Varsayılan: tur.CITIES: API yanıtındaki center alanının sonundaki şehir ismine göre filtreler. Örnek center değerleri: Netherlands Visa Application Centre - Antalya, Bulgaria Visa Application Center, Ankara. Virgülle ayrılır. Boş bırakılırsa şehir filtresi uygulanmaz.MISSION_COUNTRY: API yanıtındaki mission_code alanına göre (küçük harfle) filtreler (örn: nld, fra). Virgülle ayrılır. Bu alan zorunludur, varsayılan olarak nld kullanılır eğer boş bırakılırsa.VISA_SUBCATEGORIES: API yanıtındaki visa_type alanının içinde geçen metinlere göre (büyük/küçük harf duyarsız) filtreler (örn: Tourism, Job Seeker). Virgülle ayrılır. Boş bırakılırsa vize tipi filtresi uygulanmaz.# npm kullanıyorsanız
npm run build
# yarn kullanıyorsanız
yarn build
# pnpm kullanıyorsanız
pnpm build# npm kullanıyorsanız
npm run dev
# yarn kullanıyorsanız
yarn dev
# pnpm kullanıyorsanız
pnpm dev# npm kullanıyorsanız
npm start
# yarn kullanıyorsanız
yarn start
# pnpm kullanıyorsanız
pnpm startBot başarıyla başladığında konsolda Vize randevu kontrolü başlatıldı... mesajını ve yapılandırma detaylarını görmelisiniz.
Node.js veya paket yöneticisi kurmadan, Docker ile hızlıca başlatabilirsiniz. .env dosyasını düzenledikten sonra aşağıdaki adımları izleyin:
docker compose up -d --builddocker compose downdocker compose logs -fTELEGRAM_BOT_TOKEN: Zorunlu. Telegram bot token'ınız.TELEGRAM_CHAT_ID: Zorunlu. Telegram kanal/grup ID'niz.TELEGRAM_RATE_LIMIT_MINUTES (Opsiyonel): Dakikada gönderilebilecek maksimum mesaj sayısı (Varsayılan: 15).TELEGRAM_RETRY_AFTER (Opsiyonel): Rate limit aşıldığında beklenecek süre (milisaniye) (Varsayılan: 5000).CHECK_INTERVAL (Opsiyonel): Randevu kontrolü sıklığı (Cron formatı, Varsayılan: */5 * * * * - 5 dakikada bir).TARGET_COUNTRY (Opsiyonel): Takip edilecek kaynak ülke kodu (API'deki country_code, küçük harfle, örn: tur, gbr). Varsayılan: tur. Tüm ülkeler için all yazılabilir.CITIES (Opsiyonel): Takip edilecek şehirler (API'deki center alanından çıkarılır, virgülle ayrılır, büyük/küçük harf duyarsız). Boş bırakılırsa filtre uygulanmaz. Örnek center değerleri: Netherlands Visa Application Centre - Antalya için Antalya, Bulgaria Visa Application Center, Ankara için Ankara.MISSION_COUNTRY (Opsiyonel): Randevusu takip edilecek hedef ülke kodları (API'deki mission_code, küçük harfle, virgülle ayrılır, örn: nld,fra,deu). Boş bırakılırsa varsayılan olarak nld kullanılır.VISA_SUBCATEGORIES (Opsiyonel): Takip edilecek vize tipleri (API'deki visa_type alanıyla kısmi eşleşme, virgülle ayrılır, büyük/küçük harf duyarsız). Boş bırakılırsa filtre uygulanmaz. Örnekler: Tourism, Job Seeker, Family visit.VISA_API_URL (Opsiyonel): Kullanılacak API adresi. (Varsayılan: https://api.visasbot.com/api/visa/list)MAX_RETRIES (Opsiyonel): API hatalarında tekrar deneme sayısı (Varsayılan: 3).RETRY_DELAY_BASE (Opsiyonel): API hataları arasında bekleme süresi (ms) (Varsayılan: 1000).MAX_CACHE_SIZE (Opsiyonel): Önbellekteki maksimum randevu ID'si sayısı (Varsayılan: 1000).CACHE_CLEANUP_INTERVAL (Opsiyonel): Önbellek boyut kontrolü ve temizleme sıklığı (ms) (Varsayılan: 86400000 - 24 saat).DEBUG (Opsiyonel): Detaylı log kayıtları için hata ayıklama modu (true/false) (Varsayılan: false).Bot, filtrelerinize uyan ve durumu open veya waitlist_open olan bir randevu bulduğunda, önbellekte yoksa src/services/telegram.ts içindeki formatMessage fonksiyonuna göre Telegram'a şu formatta bir mesaj gönderir (emojiler ve bazı alanlar duruma göre değişebilir):
*✅ YENİ RANDEVU DURUMU! *
*Merkez:* Netherlands Visa Application Centre - Ankara
*Ülke/Misyon:* TUR -> NLD
*Kategori:* KISA DONEM VIZE / SHORT TERM VISA
*Tip:* TURIZM VIZE BASVURUSU / TOURISM VISA APPLICATION
*Durum:* ✅ open
️ *Son Müsait Tarih:* 22/07/2025
*Takip Sayısı:* 6
⏰ *Son Kontrol:* 31 May 2025 12:02:56(Not: Emoji ve format, randevu durumuna göre değişebilir: ✅ open, ⏳ waitlist_open)
Bot çalışıyor mu?
Vize randevu kontrolü başlatıldı... mesajını görmelisiniz.DEBUG=true yaparak .env dosyasında hata ayıklama modunu açın. Konsolda Geçerli randevu bulundu... veya Skipping appointment... gibi daha detaylı loglar görmelisiniz.Telegram bildirimleri gelmiyor
.env dosyasındaki TELEGRAM_BOT_TOKEN doğru mu kontrol edin..env dosyasındaki TELEGRAM_CHAT_ID doğru mu ve başında - işareti var mı kontrol edin.DEBUG=true yapıp konsolda Yeni randevu bildirimi gönderiliyor... ve Bildirim başarıyla gönderildi... loglarını arayın. Hata varsa loglarda görünmelidir.Belirli bir şehir/ülke/vize tipi için randevuları nasıl takip ederim?
.env dosyasında CITIES, MISSION_COUNTRY ve VISA_SUBCATEGORIES değerlerini istediğiniz kriterlere göre (virgülle ayırarak) düzenleyin. Açıklamalar için .env örneğine bakın.MISSION_COUNTRY için API'deki mission_code değerlerini (örn: nld, fra, deu) kullanın.VISA_SUBCATEGORIES için API'deki visa_type içinde geçen kelimeleri kullanın.Rate limit hatası alıyorum
.env dosyasında TELEGRAM_RATE_LIMIT_MINUTES değerini artırarak dakikada gönderilecek mesaj sayısını azaltabilirsiniz (aslında bu ayar config.telegram.rateLimit olarak koda yansır ve Telegram servisi bu değeri doğrudan kullanır, bu nedenle kontroller arası süreyi etkiler)..env dosyasında CHECK_INTERVAL değerini değiştirerek kontroller arasındaki süreyi artırabilirsiniz (örn: */10 * * * * 10 dakikada bir).API URL'si değişirse ne yapmalıyım?
Bir hata bulduysanız veya öneriniz varsa, lütfen GitHub üzerinden issue açın.
Bu proje MIT lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakın.
暂无开放 Issues,或尚未同步最近议题。