İçeriğe geç

Telegram Bot Entegrasyonu

Bu içerik henüz dilinizde mevcut değil.

@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 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.

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/2023 dosyası ve 582910 PIN için:
https://t.me/Bulgaristanbot?start=req_14820_2023_582910


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:

<!-- 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>

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:

  1. İlk Doğrulama: Bot, Adalet Bakanlığı sistemine bağlanarak dosyanın mevcut durumunu çeker ve kullanıcıya anlık bildirim verir.
  2. Periyodik Otomatik Kontrol: Günde 2 kez arka planda resmi sistem sorgulanır.
  3. 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.
  4. Ukaz (Kararname) Kutlaması: Vatandaşlık kararnamesi yayımlandığı anda bot acil öncelikli bildirim ve randevu alma talimatlarını iletir.
  5. 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.

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.