Telegram Bot Entegrasyonu
This content is not available in your language yet.
@Bulgaristanbot, Bulgaristan vatandaşlık adaylarının dosyalarını 7 gün 24 saat otomatik olarak takip eden, durum değişikliği veya Kararname (Ukaz) çıktığında anında Telegram üzerinden bildirim gönderen resmi botumuzdur.
Bu kılavuzda, web sitenizden veya müşteri portalınızdan @Bulgaristanbot’a nasıl derin bağlantı (Deep Link) yönlendirmesi yapabileceğinizi ve kullanıcı deneyimini nasıl otomatikleştireceğinizi bulabilirsiniz.
🚀 Telegram Deep Link Protokolü
Section titled “🚀 Telegram Deep Link Protokolü”Telegram botları, ?start=PARAMETRE parametresiyle başlatıldığında parametreyi bota özel bir olay olarak iletir. @Bulgaristanbot, bu parametreyi okuyarak dosya numarasını ve PIN kodunu otomatik algılar ve kullanıcıdan tekrar bilgi girmesini istemeden takibe alır.
Deep Link Formatı
Section titled “Deep Link Formatı”https://t.me/Bulgaristanbot?start=req_{DOSYA_NUMARASI}_{PIN}Önemli Kural: Telegram URL parametrelerinde
/(bölü) karakterine izin verilmediği için, dosya numarasındaki yıl ayracı alt tire (_) olarak kodlanmalıdır.Örnek:
14820/2023dosyası ve582910PIN için:
https://t.me/Bulgaristanbot?start=req_14820_2023_582910
🎨 Web Sitenize Buton Ekleme
Section titled “🎨 Web Sitenize Buton Ekleme”Hukuk büronuzun veya danışmanlık firmanızın web sitesinde sonuç gösterim sayfasına aşağıdaki hazır buton bileşenini ekleyebilirsiniz:
HTML & CSS Buton Şablonu
Section titled “HTML & CSS Buton Şablonu”<!-- Telegram Takip Butonu --><a href="https://t.me/Bulgaristanbot?start=req_14820_2023_582910" target="_blank" rel="noopener noreferrer" class="bg-bot-btn"> <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"> <path d="M21.5 2L2 9.5l7 3 2.5 7.5L15 15l6.5-13z"/> </svg> <span>Telegram ile 7/24 Otomatik Bildirim Al</span></a>
<style>.bg-bot-btn { display: inline-flex; align-items: center; gap: 10px; background: linear-gradient(135deg, #0088cc, #006699); color: #ffffff; padding: 12px 24px; border-radius: 12px; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; font-size: 15px; font-weight: 600; text-decoration: none; box-shadow: 0 4px 14px rgba(0, 136, 204, 0.35); transition: transform 0.2s ease, box-shadow 0.2s ease;}.bg-bot-btn:hover { transform: translateY(-2px); box-shadow: 0 6px 20px rgba(0, 136, 204, 0.45);}</style>⚙️ JavaScript ile Dinamik Link Oluşturma
Section titled “⚙️ JavaScript ile Dinamik Link Oluşturma”Kullanıcınız web sitenizdeki forma dosya numarasını ve PIN kodunu girdiğinde dinamik link oluşturmak için:
function generateTelegramTrackingUrl(caseNumber, pin) { // "14820/2023" -> "14820_2023" const sanitizedCase = caseNumber.trim().replace(/\//g, "_"); const sanitizedPin = (pin || "").trim();
let startParam = `req_${sanitizedCase}`; if (sanitizedPin) { startParam += `_${sanitizedPin}`; }
return `https://t.me/Bulgaristanbot?start=${startParam}`;}
// Örnek kullanım:const link = generateTelegramTrackingUrl("14820/2023", "582910");console.log(link);// Çıktı: https://t.me/Bulgaristanbot?start=req_14820_2023_582910🔔 Botun Çalışma Mantığı ve Bildirim Döngüsü
Section titled “🔔 Botun Çalışma Mantığı ve Bildirim Döngüsü”Kullanıcı bota abone olduktan sonra:
- İlk Doğrulama: Bot, Adalet Bakanlığı sistemine bağlanarak dosyanın mevcut durumunu çeker ve kullanıcıya anlık bildirim verir.
- Periyodik Otomatik Kontrol: Günde 2 kez arka planda resmi sistem sorgulanır.
- Aşama Değişikliği Alarmı: Dosya yeni bir aşamaya geçtiğinde (örn: Zorunlu koordinasyon -> Vatandaşlık Konseyi incelemesi) kullanıcıya bildirim gönderilir.
- Ukaz (Kararname) Kutlaması: Vatandaşlık kararnamesi yayımlandığı anda bot acil öncelikli bildirim ve randevu alma talimatlarını iletir.
- Eksik Evrak Uyarısı: Dosyada ek belge talebi veya eksiklik çıktığında, süre aşımı yaşanmaması için tarih uyarısı gönderilir.
🤝 Destek ve Özel Bot Entegrasyonları
Section titled “🤝 Destek ve Özel Bot Entegrasyonları”Hukuk büroları ve kurumsal danışmanlık firmaları için kendi markanızla çalışan White-Label Telegram Botu veya Kurumsal Webhook çözümleri sunmaktayız.
- Telegram Destek: @Bulgaristanbot?start=yardim