Python ile Telegram Bot

Bu yazıda Python dilini kullanarak Telegram Bot yazacağız. Teknik bölüme geçmeden önce kavramları inceleyelim.

Telegram : Telegram, çoklu platform desteği sunan bir anlık mesajlaşma servisidir. Telegram istemcileri hem mobil (Android, iOS, Windows Phone, Ubuntu Touch) hem de masaüstü sistemleri (Windows, OS X, Linux) için mevcuttur.^[1]

Bot: Bilişim dünyasında “robot” anlamında kullanılan yaygın bir terimdir. Pek çok bilgisayar işlemini yarı-otomatik olarak yapabilen robotlar bilişimin tüm alanlarında kullanılır.^[2]

Kavramlardan temel olarak bahsettik, şimdi yapacağımız uygulama hakkında konuşalım:

AMAÇ: Telefonumuza düzenli aralıklarla istediğimiz dinamik verileri mesaj atmak. Örn: Her gün hava durumunu mesaj olarak almak, her hafta okul sayfasındaki duyuruları mesaj olarak almak vs.

GEREKSİNİMLER: Python 3.x, BeatifulSoup 4, Telegram hesabı ve temel python bilgisi(paket kurulumu dahil).

Kodun tamamı: GİTHUB

Vereceğim örnekte, “http://guzelsozlerblog.com/gunun-sozu” sayfasından konulara göre günün sözlerini sırayla çekip bu sözleri telegram üzerinden telefonuma mesaj olarak göndereceğim. Elimden geldiğince en açık şekilde ve adım adım anlatmaya çalışacağım, bu sebeple yazı uzun olabilir. Uzun yazıyı görüp motivasyonunuzu kaybetmeyin hemen, yüzeysel olarak göz attığınızda kolay olduğunu siz de göreceksiniz.

Adım 1: Boş bir python dosyası açalım (Örn: sozBotu.py). İlk önce veri çekmek istediğimiz web sitesine erişelim ve sayfanın tamamını elde etmeye çalışalım. Bunun için requests kütüphanesini kullanacağız.

import requests #requests kütühanemizi dahil ettik
url="http://guzelsozlerblog.com/gunun-sozu" #web sayfası URL sini atadık
response=requests.get(url) #kütüphane yardımıyla web sayfasına gittik
print(response.text) #web sayfasının çıktısını yazdırdık

Çıktı aşağıdaki görüntüye benzeyecektir.

Adım 2: Elde ettiğimiz web sayfası çıktısından almak istediğimiz kısımları filtreleyeceğiz. Benim örneğimde almak istediği bilgiler “div id=”PageContent” etiketlerinin arasındaydı. Bu sebeple sadece bu etiketler ve içerikleri lazım. Bu filtrelemeyi yapmak için BeatifulSoup kütüphanesinden faydalanıyoruz. Bu kısımda dönen verinin bir dizi olduğunu göreceğiz.

import requests
from bs4 import BeautifulSoup
url="http://guzelsozlerblog.com/gunun-sozu"
response=requests.get(url)
print(response.text)
AnalizEdilecekIcerik=response.text #Sayfadan gelen HTML kodunu atadık

icerigiAl=BeautifulSoup(AnalizEdilecekIcerik,"lxml") #BS4 HTML kodunu analiz ediyor
#"lxml" parametresini kütüphanenin bize verdiği uyarı gereği kullandık. Parametresiz veya diğer parametreler ile kullanabilirsiniz. Bu parametre hakkında daha fazla bilgi için--> https://www.crummy.com/software/BeautifulSoup/bs4/doc/#installing-a-parser 

filtre=icerigiAl.find_all(id="PageContent") #id değeriyle filtreleme yaptık

print(filtre) #tüm filtreyi yazdırdık
print(filtre[0]) #filtreden gelen verinin sadece 0.indexine ait içeriği yazdırdık. Bu arada print fonksiyonunu gelen veriyi kontrol etmek için kullanıyorum.

Adım 3: Çektiğimiz veriyi istediğimiz şekilde yazdırmak için gerekli algoritmayı oluşturacağız.

import requests
from bs4 import BeautifulSoup
url="http://guzelsozlerblog.com/gunun-sozu"
response=requests.get(url)
<span style="color:#ff0000;">response.encoding= "iso-8859-9"</span> #Bu kod ile çektiğimiz verideki "ş,ç,i" gibi karakterlerde çıkabilecek problemleri önlüyoruz.
AnalizEdilecekIcerik=response.text
icerigiAl=BeautifulSoup(AnalizEdilecekIcerik,"lxml")

#CSS ile de filtreleyebiliriz, ben bunu tercih ediyorum.
sozler=icerigiAl.select("div#PageContent")

for i in range(0,len(sozler)): #döngüyü, aldığımız dönütün uzunluğu ile sınırlandırıyoruz.
print(sozler[i].contents[0].text +": "+sozler[i].contents[2]+"\n") #Etiket içeriklerini çekip yazdırıyoruz.

Adım 4: Şimdi, Telegram uygulamasında yapmamız gereken ayarları yapacağız.

4.1. BotFather adlı ön tanımlı ayarlama kullanıcısını çağıralım. Bunun için masaüstü bilgisayarından https://telegram.me/BotFather bağlantısını kullanabilirsiniz.

4.2. Aşağıdaki yönergeleri izleyiniz. gununSozu ve GununSozuBot gibi ifadeleri kendinize göre değiştirebilirsiniz. Bot Babamızın da dediği gibi dikkat etmeniz gereken yer: İkinci ismin “bot” ile bitmek zorunda olması. Babanın size verdiği tek satırlık token kodunu kaydedin bir yere.

4.3. Bu defa babaya “/mybots” komutunu verin. Botunuz – botlarınız listelenecektir. Benim daha önce bir botum olduğu için o da göründü, siz ilk defa yapıyor olduğunuz için sadece bir bot olarak listelenecektir. Botunuzu seçin.

4.4. Ekran görüntüsünde işaretlenen yere tıklayarak, botun sohbet penceresine erişin.

4.5. “Start” butonu ile botu aktif edin. Ekran görüntüsünde gördüğünüz “Günün sözlerini her gün ileten bir bot.” yazısını BotFather üzerinden “/setdescription” komutunu kullanarak oluşturabilirsiniz.

4.6. https://api.telegram.org/bot{token}/getMe

kullanarak bota erişim olup olmadığını kontrol edin. Buradaki {token} 4.2. de not aldığımız token kodu.

4.7. Botun sohbet penceresinden bota herhangi bir mesaj atın.

4.8. https://api.telegram.org/bot{0}/getupdates

kullanarak gelen verilerin json çıktısını elde edelim. Bu çıktıda bizim için önemli olan id parametresi. Bu paramtrenin değerini de not alalım. Şu an elimizde token ve id parametreleri var. Artık bu iki parametre ile botumuzu kontrol edeceğiz.

Artık kodumuza devam edebiliriz.

Adım 5: Kodumuza son halini vereceğiz. Aldığımız çıktıyı bot aracılığıyla kendimize göndereceğiz. Telegramın bize sunduğu URL yapısı sayesinde mesajımızı ileteceğiz. Bu URL yapısı,

https://api.telegram.org/bot{0}/sendMessage?chat_id={1}&text={2}

import requests
from bs4 import BeautifulSoup

url="http://guzelsozlerblog.com/gunun-sozu"
response=requests.get(url)
response.encoding= "iso-8859-9"
AnalizEdilecekIcerik=response.text

icerigiAl=BeautifulSoup(AnalizEdilecekIcerik,"lxml")
sozler=icerigiAl.select("div#PageContent")

gonderilecekYazi="" #her iterasyonda aldığımız veriyi bu değişkenin üzerine ekleyeceğiz

for i in range(0,len(sozler)):
gonderilecekYazi+=sozler[i].contents[0].text +": "+sozler[i].contents[2]+"\n\n"

token = "309--441:AAG------------r6n97cz_Y" #telegram token
chat_id = "253529798" #telegram id

requests.post(url='https://api.telegram.org/bot{0}/sendMessage'.format(token), data={'chat_id': 253529798, 'text': gonderilecekYazi}).json()

#telegram sendMessage url, daha fazla bilgi için --> https://core.telegram.org/bots

Kodu çalıştırdığınızda eğer herhangi bir yerde hata yapmadıysanız, Telegram hesabınıza bildirim gelecektir.

Bu mesajın istediğimiz zamanlarda bize gelmesini istiyorsak, bir sunucuya bu python dosyasını atıp Görev Zamanlayıcı(Cron Jobs) ile istediğiniz zaman çalıştırabiliriz. Bu yazı yeterince uzun olduğu için sadece yöntemi söylemekle yetiniyorum şimdilik. Daha sonra bu aşamaları da anlatacağım.

Kaynakça

1.^Telegram (yazılım). 21 Ocak 2017.

2.^Bot (robot). 21 Ocak 2017.