Telegram botu yapmayı öğrenmek

Telegram botu tam olarak nedir ve nasıl çalışır?

Telegram botu, arkasında bir insan değil yalnızca sizin programınız olan özel bir hesaptır. O program onu nereye koyarsanız orada çalışır; bir sunucuda ya da kendi dizüstünüzde, ve Telegram ile bir web API üzerinden konuşur. Telegram kodunuzu barındırmaz ve çalıştırmaz; yalnızca mesajları size verir ve sizinkileri alır.

Konuşma biçimi basit bir kalıptır ve Bot API belgeleri bunu tam olarak şöyle yazar: bütün sorgular HTTPS üzerinden sunulmalı ve şu biçimde verilmelidir: https://api.telegram.org/bot<token>/METHOD_NAME. Her yöntem bir adrestir. Yanıt her zaman bir ok alanı taşıyan bir JSON nesnesidir.

Token ise belgelerin kimlik doğrulama tokenı dediği şeydir ve her botun oluşturulurken kendine özel bir tane aldığını söyler; biçimi 123456:ABC-DEF... gibi bir şeydir. Bu cümlenin iki anlamı var ve ikincisi daha önemli: token, yanında bir parola bulunan bir anahtar değildir; token kimliğin kendisidir. O dizgiyi elinde tutan herkes sizin botunuzdur.

Genel yapı şu: kullanıcı Telegram da bir şey yazar, Telegram bunu botunuzun güncellemeler kuyruğuna koyar, programınız alır, karar verir ve bir HTTPS isteğiyle yanıt gönderir. API nedir yazısını okuduysanız burada yöntem adları dışında yeni bir şey yok.

BotFather dan ilk mesaja, adım adım

Botu Telegram in kendisi oluşturmaz; @BotFather adlı bir bot oluşturur. Telegram da ona gidersiniz, /newbot gönderirsiniz, bir görünen ad ve bot ile biten bir kullanıcı adı verirsiniz, o da size tokenı verir. Komut listesini de orada kaydedebilirsiniz; çoğu öğretici bunu atlar ve kullanıcı bir eğik çizgi yazdığında öneri listesini açan şey tam olarak budur. Belgelere göre komutlar her zaman / işaretiyle başlar ve en fazla 32 karakterdir.

Herhangi bir kod yazmadan önce tokenı deneyin. Tek bir istek yeter:

curl -s "https://api.telegram.org/bot<token>/getMe"

Token doğruysa bot bilgilerini JSON olarak alırsınız. Yanlışsa dönen şey bir HTTP hata sayfası değil, aynı JSON zarfıdır. Bugün kendi sunucumuzdan uydurma bir tokenla denedik ve yanıt tam olarak şuydu:

{"ok":false,"error_code":401,"description":"Unauthorized"}

Bunu bilerek gösteriyoruz, çünkü işin bütün biçimi bu tek satırda: ok başarılı olup olmadığını, olmadıysa description nedenini söyler. Programınız her zaman önce ok a bakmalı, yalnızca HTTP durum koduna değil.

Bundan sonra botun bilmesi gereken ilk şey /start a nasıl yanıt vereceğidir, çünkü kullanıcının onu açtığı düğme odur. Botun ne yaptığını ve sonra neye basılacağını söyleyen tek bir cümle yazın. /start a bulanık yanıt veren bir bot orada kapatılır.

Mesajları getUpdates ile mi webhook ile mi almalıyım?

Belgeler açık: güncellemeleri almanın iki yolu vardır ve bunlar birbirini dışlar; bir yanda getUpdates yöntemi, öbür yanda webhook lar. Yani bir webhook ayarlıysa getUpdates hiç çalışmaz ve bu tek cümle ilk gece hatalarının çoğunu açıklar.

Birinci kipte programınız sürekli yeni bir şey olup olmadığını sorar. Basittir, genel bir adres istemez ve bir dizüstünde çalışır; bu yüzden öğrenmek ve ilk sürüm için doğru seçimdir. Belgelerin hatırlattığı bir nokta: her yanıttan sonra offset i yeniden hesaplayın, yoksa aynı mesajları tekrar alırsınız.

İkinci kipte bir adres verirsiniz ve Telegram bir şey oldukça o adrese HTTPS üzerinden bir POST isteği gönderir. Daha verimlidir ve yoğun bir bot için doğru yanıttır. Belgelerin kendisinden iki şeyi bilin: adresiniz 2XX dışında bir kodla yanıt verirse Telegram isteği yineler ve makul sayıda denemeden sonra vazgeçer. Daha da önemlisi, gelen güncellemeler bot alana kadar Telegram sunucusunda saklanır, ama 24 saatten uzun tutulmaz.

Bu son cümle bir ayrıntı değil, sizin için işletimsel bir karardır. Bot sunucusu tam bir gün kapalı kalırsa o günün mesajları gider ve geri getirmenin bir yolu yoktur. Hobi botu için önemli değildir; müşteri destek botu için önemlidir ve bir uyarı gerektirir.

Bir bot grupta neyi görür?

Bu bölüm hem gizlilik sorusu hem de botunuzun bir grupta "çalışmamasının" nedenidir. Telegram da Privacy Mode adlı bir kip var; bir gruba eklenen her bot için varsayılan olarak açıktır ve o kipte bot yalnızca şunları görür: kendisine açıkça yönelik komutlar, örneğin /command@this_bot; gruba mesaj gönderen son bot ise /start gibi genel komutlar; kendisi üzerinden gönderilen satır içi mesajlar; ve bu bota yönelik mesajlara verilen yanıtlar.

Buna karşılık, kipten bağımsız olarak her bot şunları alır: bütün hizmet mesajları, özel sohbetlerdeki bütün mesajlar ve üyesi olduğu kanallardaki bütün mesajlar. Pek çok kişiyi şaşırtan bir istisna var: bir gruba yönetici olarak eklenen botlar her zaman bütün mesajları alır.

Kip kapatılabilir ve o zaman bot sıradan bir kullanıcı gibi her mesajı görür, ama iki nokta: değişiklik bot gruba yeniden eklenene kadar etkili olmaz ve Telegram aynı sayfada bunu yalnızca botun çalışması için kesinlikle gerekli olduğu yerlerde önerdiğini, çoğu durumda force reply seçeneğinin fazlasıyla yeterli olduğunu yazar.

Bizim konumumuz da aynı: varsayılanı açık bırakın. Yalnızca bir grup üyesi bir botun bütün konuşmasını okumasını beklemediği için değil, botunuz da o mesajları istemediği için; onları işlememek hem daha ucuz hem daha güvenlidir. Gerçekten kapatmak zorunda kalırsanız botun neyi okuduğunu /start mesajının içinde söyleyin. Grup üyeleri herhangi bir botun güncel gizlilik ayarını üye listesinde görebilir, yani gizlemek zaten seçenek değil.

Sınırlar ve herkesin ilk seferinde yaptığı hatalar

Üç sınır ailesi var ve üçü de resmî SSS te yazılı. Birincisi mesaj hızı: tek bir sohbette saniyede birden fazla mesaj göndermekten kaçının; Telegram bunun üstünde kısa patlamalara izin verebileceğini ama sonunda 429 hataları almaya başlayacağınızı söyler. Bir grupta bir bot dakikada 20 mesajdan fazlasını gönderemez. Toplu bildirimlerde ise bir bot saniyede yaklaşık 30 mesajdan fazlasını yayınlayamaz.

İkincisi ücretli yayın. O tavan azsa Telegram bunu saniyede 1000 mesaja çıkaran bir özelliğe sahip; saniyedeki ücretsiz 30 un üstündeki her mesaj 0.1 Yıldız tutuyor. Koşulunu da yazıyor ve küçük bir koşul değil: botun bakiyesinde en az 100.000 Yıldız ve en az 100.000 aylık etkin kullanıcı bulunmalı. Yani bu yol yeni botunuz için değil ve hız satın almayı değil bir kuyruk ile bir zamanlamayı planlamanız daha iyi olur.

Üçüncüsü dosyalar. Bir bot 50 MB a kadar dosya gönderebilir ve getFile yöntemi yalnızca 20 MB a kadar dosyalarla çalışır. Bu iki sayı aynı değil ve video kabul eden bir botun testte çalışıp gerçek bir kullanıcının elinde bozulduğu yer tam da burası.

Ve tekrarlanan üç hata. Birincisi, tokenı GitHub da yayımlanan bir kodun içine koymak; token botun kimliğinin kendisi olduğu için onu gören herkes sizin adınıza mesaj gönderebilir. Tokenın yeri bir kaynak dosyası değil, bir ortam değişkenidir. İkincisi, mesajları aralık bırakmadan bir döngüde göndermek ki bu doğrudan o 429 a yürür. Üçüncüsü, botun her zaman ayakta olduğunu varsaymak: programınız bir gün düşecek ve 24 saatten uzun kapalı kalırsa o aralığın mesajları geri gelmez.