Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iletiniz.com/llms.txt

Use this file to discover all available pages before exploring further.

İletiniz, Telegram Bot API’sini SMS ile aynı uç noktanın altında sunar — istek formatı aynı, kanal seçimi provider: "telegram" ile yapılır.

​
Bot Kurulumu

  1. Telegram’da @BotFather’a yaz, /newbot ile bir bot oluştur.
  2. BotFather’ın verdiği token’ı kopyala (formati 123456789:AAEhBP...).
  3. Kontrol Paneli → Entegrasyonlar → Yeni Bağlantı → Telegram.
  4. Bot Token alanına yapıştır → Doğrula.
Doğrulama, Telegram’ın getMe çağrısıyla yapılır. Bot kullanıcı adı @iletiniz_bot gibi provider_senders tablosuna kaydedilir; bu alan gönderim sırasında kullanılmaz, yalnızca dashboard’da bağlantı kimliği için gösterilir.

​
Alıcı Formatı

to alanı şunlardan biri olabilir:
FormatAnlam
123456789Kullanıcı chat_id (pozitif tam sayı)
-1001234567890Grup veya kanal chat_id (negatif, super-grup)
@kanal_adiPublic kanal kullanıcı adı
Bir bot bir kullanıcıya kullanıcı önce botla konuşmadıkça mesaj gönderemez. chat_id alabilmek için kullanıcının bot ile en az bir kez etkileşmesi gerekir (/start). Aksi halde Telegram 403 Forbidden döner ve mesaj failed olur.

​
Örnek

curl -X POST https://api.iletiniz.com/v1/messages \
  -H "Authorization: Bearer iltz_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "123456789",
    "body": "Bildirim: yeni sipariş geldi.",
    "provider": "telegram"
  }'

​
Farklılıklar

ÖzellikSMSTelegram
sender (msgheader)ZorunluYok sayılır
Segment hesabı160 / 70 karakterYok (sabit 1)
MaliyetPer segmentYok (cost = null)
DLRPoll (5–9 deneme)Anlık (sendMessage zaten teslim olduğunu bildirir)
Maks. body16004096 (Telegram API limiti — iletiniz’de 1600’e kırpılır)
MarkdownYok (düz metin)Yok (planlanan özellik)

​
Toplu Gönderim Davranışı

POST /v1/messages/bulk Telegram için paralel tek çağrılar olarak yürütülür (Telegram’ın gerçek bir “bulk” endpoint’i yoktur). Bot başına Telegram tarafında saniyede 30 mesaj rate-limit’i vardır; bunu aşan istekler 429 döndürür ve adapter exponential backoff ile retry’lar.

​
Bot İzinleri

  • Gruba/kanala mesaj göndermek için bot üye olmalı ve “Send Messages” yetkisi olmalı.
  • Public kanala (@kanal) gönderim için bot kanalın admini olmalıdır.
  • Webhook event tipleri (message.delivered, message.failed) Telegram için de geçerlidir.