Telegram Bot date_time ile Randevu Saati Nasıl Gösterilir?

Kısa yanıt: Bot randevu saatini nasıl göstermeli?

Telegram botunda randevu saatini yalnızca sabit bir metin parçası olarak yazmak yerine, uygun akışlarda Bot API'nin date_time mesaj varlığını kullanmayı değerlendirin. Telegram, bu MessageEntity türünü Mart 2026'da ekledi; türün amacı kullanıcıya biçimlendirilmiş tarih ve saat göstermek. Ancak bu alan randevu kaydını oluşturmaz, saat dilimi mantığını tek başına kurmaz ve hatırlatmanın doğru anda gönderildiğini garanti etmez. Önce randevunun gerçek zaman damgasını güvenilir kaynaktan alın, sonra mesajın görünen tarih bölümünü bu değerle ilişkilendirin. Telegram'ın sürüm günlüğü özelliğin eklenmesini, Bot API belgesi ise alanlarını açıklar.

Bu yazı, bot mesajının tek bir tarih-saat unsuruna odaklanır. Düğmeler, metin blokları ve yanıtın genel kurgusu için Telegram bot rich messages akışı yazısına bakabilirsiniz. Botu randevu sistemiyle birlikte tasarlamak için Webinle bot yazılımları hizmet kapsamını inceleyin.

Mesajdan önce saat kaynağını belirleyin

En kritik soru, "bot saat kaçta gönderdi?" değil, "hangi randevunun hangi kesin başlangıç anını gösteriyor?" sorusudur. Randevu uygulamasında başlangıç ve bitiş zamanlarını, işletmenin takvim saat dilimini ve gerekiyorsa kullanıcının tercih ettiği saat dilimini ayrı alanlar olarak ele alın. Bir kullanıcı ekranında "14.00" yazması, bunun hangi şehir veya zaman dilimine göre olduğu bilinmiyorsa yeterli değildir. Rezervasyon onayı, değişiklik ve iptal mesajları aynı randevu kimliğine bağlanmalıdır.

Mesaj hazırlarken tarih bölümünün arkasındaki Unix zamanını kayıttan üretin; metne elle girilmiş bir saatle farklı değer taşımayın. Telegram Bot API MessageEntity için unix_time alanını tarih-saat varlığıyla ilişkili Unix zamanı, date_time_format alanını ise biçim tanımı olarak belgeliyor. Mesaj varlığının offset ve length değerleri UTF-16 kod birimleriyle ölçülür. Türkçe karakter veya emoji içeren metinde sıradan karakter sayısını doğrudan bu değerlere vermek, yanlış parçanın biçimlenmesine yol açabilir. Bu nedenle varlık konumunu, gönderilen nihai metin üzerinde test edin.

Bot altyapınız farklı istemciler ve metin biçimlendirme yolları kullanıyorsa, canlı mesajdaki görünümü örnek cihazlarda doğrulayın. Belgenin date_time desteği, her istemcinin her tasarım tercihinde aynı görsel sonucu vereceği anlamına gelmez. Kullanıcı için kritik olan saat bilgisini sadece biçimlendirilmiş alanın üzerinde bırakmak yerine, randevu ayrıntı sayfasında da açıkça gösterin. Mesajda işletmenin saat dilimi veya görüşmenin çevrim içi olup olmadığı belirsizse, kısa bir açıklama ekleyin.

Hatırlatma akışını kimlik ve durumla bağlayın

Gönderim kuyruğundaki her hatırlatma, bir randevu kimliği ve planlanan sürümle ilişkilensin. Randevu saati değiştiğinde eski mesaj görevinin geçersiz kılınıp yeni saatle tekrar planlanması gerekir. İptalde gönderilmeyi bekleyen hatırlatmayı temizlemeyi test edin. Aksi halde bot doğru biçimlendirilmiş ama artık geçersiz bir saat iletebilir. Bu, date_time alanının biçim hatası değil, iş akışındaki durum yönetimi hatasıdır.

Güvenilir bir sıra şöyle olabilir: randevu kaydını okuyun; kayıt hâlâ onaylı mı kontrol edin; başlangıç anını ve saat dilimini çözün; mesaj metniyle varlık aralığını oluşturun; gönderimden hemen önce kaydın sürümünü yeniden doğrulayın; gönderim sonucunu randevuya bağlayın. Bu sıra örnek bir tasarım önerisidir, Telegram'ın zorunlu çalışma kuralı değildir. Mevcut sisteminiz farklı bir işlem sırası kullanıyorsa aynı hata senaryolarının kapsanması daha önemlidir.

Kullanıcıya gereğinden fazla veri taşımayın. Grup konuşmasında hasta adı, telefon veya özel randevu nedeni gösterilmesi ayrı bir mahremiyet sorunudur. Hatırlatmaların hangi sohbete gideceği, kullanıcının botla ilişkilendirilmesi ve mesaj içerik seviyesi kabul kriteri olarak belirlenmelidir. Aynı kullanıcıya iki kez mesaj gitmesini önlemek için gönderim kaydında randevu, mesaj türü ve planlanan zaman birlikte tutulabilir. Bu kayıt, gönderilen saatin doğru olduğunu sınamayı da kolaylaştırır.

Kabul testinde hangi hataları arayın?

Örnek kabul senaryosu

Bir kullanıcı pazartesi için randevu aldığında kayıt sisteminin başlangıç anı, botun gösterdiği tarih ve kurumun panelindeki saat aynı randevu kimliğine bağlanmalıdır. Ardından randevuyu salıya taşıyın: eski gün için hazırlanan hatırlatma artık geçersiz olmalı, yeni mesaj salıdaki başlangıç anını kullanmalıdır. Kullanıcı mesajı farklı saat dilimindeki cihazda açıyorsa görünen saatin hangi bağlamda anlaşıldığını özellikle sorun. Böyle bir deneme, yalnızca API şemasının doğruluğunu değil, insanın mesajı doğru okuyup okumadığını da gösterir.

Bir de başarısız gönderimi canlandırın. Bot gönderim yanıtı alamadığında işleyici aynı görevi tekrar çalıştırabilir; tekrarın yeni bir randevu yaratmasına veya birden çok hatırlatma üretmesine izin vermeyin. İşlemin nihai durumunu kontrol etmek için kendi kayıtlarınızı ve Telegram yanıtını birlikte değerlendirin. Bildirimin gönderilmiş olması, kullanıcının okuduğu anlamına gelmediği için randevu durumu yalnızca mesaj teslimine bağlanmamalıdır.

İlk test, kısa ve uzun Türkçe mesajlarda tarih kısmının doğru varlık aralığını almasıdır. İkinci test, saat dilimi farkı olan bir kullanıcıyla işletme saatinin açıkça anlaşılmasıdır. Üçüncü test, randevu yeniden planlandığında eski hatırlatmanın gönderilmemesidir. Dördüncü test, aynı gönderim isteği tekrarlandığında bildirim politikanıza uygun davranılmasıdır. Son test, desteklenmeyen biçim veya istemci görünümünde mesajın yine anlaşılır kalmasıdır. Her testi gerçek müşteri bilgisi olmadan örnek kayıtla çalıştırın.

API yanıtını tek başarı ölçütü saymayın. Mesaj kabul edilmiş olabilir, fakat kullanıcı yanlış randevunun saatini görmüş olabilir. Hata günlüğünde mesaj metninin tamamını saklamak yerine randevu kimliği, gönderim zamanı, varlık aralığı ve durum kodu gibi gerekli teknik bilgileri tutun. Tüketiciye görünen saat ile asıl kayıt arasındaki farkı pilot kullanıcılarla ayrıca kontrol edin. Entegrasyonun kapsamını belirlerken mesaj üretimi kadar iptal, güncelleme ve geri alma adımlarını da hesaba katın.

Telegram'daki date_time, randevu bildirimini daha açık hale getirebilen bir sunum aracıdır. Kalıcı değer, doğru zaman kaynağı ve doğru durum akışıyla birlikte kullanılmasındadır. Mevcut randevu paneliniz ve botunuz için bir entegrasyon değerlendirmesi isterseniz örnek onay, değişiklik ve iptal senaryolarını hazırlayın; böylece hangi mesajların otomatikleşeceği somutlaşır.