Telegram API Developer Guide

Telegram Bot Dünyasını Keşfedin

İşletmenizi otomatize edin, topluluklarınızı yönetin ve müşterilerinize anında yanıt verin. Telegram Bot API, basit bildirimlerden karmaşık e-ticaret sistemlerine kadar sınırsız olanaklar sunar.

Bu rehberde; BotFather ile bot kurulumu, Telegram ID bulma yöntemleri, API entegrasyonu ve Eka Sunucu'nun profesyonel bot geliştirme hizmetlerini bulacaksınız.

Bot Nasıl Yapılır? Bot Hizmetleri

EkaBot bot

Merhaba! Size nasıl yardımcı olabilirim? /start

Sipariş durumumu öğrenmek istiyorum.

Lütfen sipariş numaranızı giriniz... 🤖

BotFather
Kurulumu

Saniyeler içinde kendi botunuzu oluşturun ve token alın.

ID Bulma
Yöntemleri

Kullanıcı, Grup ve Kanal ID'lerini (Chat ID) kolayca öğrenin.

Webhook &
Polling

Botunuzun çalışma mantığını ve sunucu iletişimini anlayın.

Bot
Hosting

Botlarınızı 7/24 kesintisiz çalıştıracak VDS çözümleri.

Telegram Bot Nedir ve Ne İşe Yarar?

Telegram Botları, Telegram içinde çalışan, kullanıcılarla mesajlaşabilen, komutları işleyen ve çeşitli görevleri otomatize eden yazılım robotlarıdır. Bir telefon numarasına ihtiyaç duymazlar ve kodlar aracılığıyla yönetilirler.

Botlar ile haber bültenleri gönderebilir, e-ticaret satışı yapabilir, müşteri desteği verebilir, grup yönetimini otomatize edebilir (spam engelleme vb.) veya harici sistemlerden (sunucu durumu, borsa verisi) bildirimler alabilirsiniz.

7/24 Aktif: Asla uyumazlar, her an yanıt verirler.
Entegrasyon: Web sitenizle veya diğer API'lerle konuşabilirler.
Ücretsiz: Bot oluşturmak ve API kullanmak tamamen ücretsizdir.

BotFather ile Bot Nasıl Kurulur?

Adım adım kendi botunuzu oluşturun ve Token alın

BotFather'ı Bulun

Telegram arama çubuğuna @BotFather yazın ve mavi tikli olan hesabı açın. /start diyerek başlatın.

Yeni Bot Oluşturun

/newbot komutunu gönderin. BotFather sizden botunuz için bir İsim (Name) isteyecektir (Örn: Eka Destek).

Kullanıcı Adı Belirleyin

Botunuz için benzersiz bir Kullanıcı Adı (Username) seçin. Sonu mutlaka bot ile bitmelidir (Örn: ekasunucubot).

API Token'ı Alın

İşlem başarılıysa BotFather size uzun bir HTTP API Token verecektir. Bu anahtarı kimseyle paylaşmayın!

123456789:ABCdefGhIJKlmNoPQRstUVwxyZ

Telegram ID (Chat ID) Nasıl Bulunur?

Telegram API ile mesaj göndermek için hedef kişinin veya grubun benzersiz Chat ID'sine ihtiyacınız vardır. Kullanıcı adları (@kullanici) API tarafında genellikle işe yaramaz, sayısal ID gereklidir.

En Kolay Yöntemler:

1. RawDataBot Kullanımı

Telegram'da @RawDataBot'u aratın ve başlatın. Size gönderdiği JSON verisi içinde "id": 123456789 satırını bulun. Bu sizin User ID'nizdir.

2. Gruplar İçin

Botu grubunuza ekleyin. Tarayıcınızdan şu adrese gidin:
https://api.telegram.org/botTOKEN/getUpdates
Gruba bir mesaj atın ve sayfayı yenileyin. "chat": {"id": -100...} kısmındaki eksi ile başlayan numara Grup ID'sidir.

3. Web Telegram (Plus)

Bazı 3. parti Telegram istemcileri (Plus Messenger vb.) profil ayarlarında ID'yi doğrudan gösterir.

{
  "update_id": 8837461,
  "message": {
    "message_id": 12,
    "from": {
      "id": 987654321,
      "is_bot": false,
      "first_name": "Ahmet",
      "username": "ahmet123"
    },
    "chat": {
      "id": -1001234567890,
      "title": "Eka Destek Grubu",
      "type": "supergroup"
    },
    "date": 1678901234,
    "text": "ID nedir?"
  }
}

Teknik Detaylar: Webhook vs Long Polling

Botunuzun sunucu ile nasıl iletişim kuracağını seçin

Long Polling

Botunuz sürekli olarak Telegram sunucularına "Yeni mesaj var mı?" diye sorar. Basit kurulumludur, yerel bilgisayarda çalışır. Ancak çok trafikli botlarda gecikme yaratabilir ve sunucu kaynaklarını tüketir.

Başlangıç İçin Uygun

Webhook

Telegram, yeni bir mesaj geldiğinde sizin sunucunuza (URL'nize) veriyi anında gönderir (Push). Daha hızlıdır, kaynak dostudur ancak SSL Sertifikası (HTTPS) olan bir sunucu gerektirir.

Profesyonel Seçim

Örnek PHP Kodu (Mesaj Gönderme)

<?php
$token = "SIZIN_BOT_TOKENINIZ";
$chat_id = "HEDEF_CHAT_ID";
$mesaj = "Merhaba! Bu bir test mesajıdır.";

$url = "https://api.telegram.org/bot$token/sendMessage";
$data = ['chat_id' => $chat_id, 'text' => $mesaj];

$options = [
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => http_build_query($data)
    ]
];
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
?>

Sıkça Sorulan Sorular

Telegram botları hakkında merak edilenler

Telegram Bot API ücretli mi?

Hayır, Telegram Bot API tamamen ücretsizdir. Ancak botunuzu 7/24 çalıştırmak için bir sunucuya (VDS/Hosting) ihtiyacınız olabilir, bu sunucu maliyeti size aittir.

Botlar gruplardaki mesajları okuyabilir mi?

Varsayılan olarak botlar "Privacy Mode" (Gizlilik Modu) açık gelir ve sadece komutları (/) veya kendilerine yanıt verilen mesajları görürler. BotFather üzerinden "Privacy Mode" kapatılırsa tüm mesajları görebilirler.

Hangi programlama dillerini kullanabilirim?

Telegram Bot API, HTTP tabanlı olduğu için HTTPS isteği gönderebilen her dille (PHP, Python, Node.js, C#, Java, Go vb.) bot yazabilirsiniz.

Bot mesaj limiti var mı?

Evet, spam'i önlemek için limitler vardır. Bir bot aynı sohbete saniyede 1 mesaj, farklı sohbetlere ise saniyede toplam 30 mesaj gönderebilir. Bu limitler aşılırsa "429 Too Many Requests" hatası alırsınız.