Telegram gereksinimleri ve sınırlamaları

1. Mesaj sınırlamaları

  • Yalnızca metin mesajı: En fazla 4.096 karakter.
  • Resimli mesaj: En fazla 1.024 karakter (1080x1080 px resim için).

2. Resim gereksinimleri

  • Biçim: Kare resimler tercih edilir.
  • En uygun boyut: 900x900 piksel, en fazla 5 MB.

3. Dosya gereksinimleri

Telegram API'sinin yüklenen dosyalar için belirli gereksinimleri vardır:

  • Botlar 2 GB'a kadar dosya gönderebilir.
  • Daha önce yüklenen dosyalarla çalışmak için file_id kullanabilirsiniz. Bu durumda dosya sınırlamaları Telegram belgelerine uyar.
  • Dosyalar bir URL kullanılarak gönderilebilir (bot indirir ve gönderir):
    • Fotoğraflar: ≤ 5 MB
    • Diğer dosyalar: ≤ 20 MB
  • Gönderim için farklı sınırlamalar geçerlidir:
    • Fotoğraflar: 10 MB
    • Diğer dosyalar: 2 GB

Orijinal kaynakta daha fazlasını okuyun

Telegram botu oluşturma

Bir Telegram botu, Telegram'ın resmi bot yönetim sistemi olan BotFather aracılığıyla oluşturulur. Bu doğrulanmış araç (mavi onay işaretiyle gösterilir), herhangi bir programlama bilgisi olmadan bir bot oluşturmanıza olanak tanır ve sizi sahte taklitçilerden korur.

Oluşturma Adımları:

  1. BotFather ile bir sohbet başlatın.
  2. Şu komutu gönderin: /newbot
  3. Botunuz için bir ad seçin (bu, kullanıcılara görünen addır).
  4. Botunuz için bir kullanıcı adı seçin. bot veya _bot ile bitmelidir (örneğin, my_test_bot).

Kullanıcı adı müsaitse, BotFather size API erişimi için benzersiz bir anahtar olan bir "token" içeren bir onay mesajı gönderecektir.

Önemli: Bu token, botunuzun şifresidir. Güvenli bir şekilde saklayın ve asla kimseyle paylaşmayın.

Mesajlaşma bölümüne gidin, Telegram'ı seçin ve botunuzun token'ını sağlanan alana yapıştırın.

Bot kurulumunu tamamlamak ve projenize bağlantıyı etkinleştirmek için Bitti düğmesine tıklayın.

Telegram grupları/kanalları ile çalışma

Yararlı bilgiler

Telegram grubu, katılımcılar arasında bir iletişim kanalıdır: tüm katılımcılar buraya yazabilir.

Telegram kanalı, tek yönlü bir iletişim aracıdır. Yalnızca sahibi veya yöneticiler mesaj gönderebilir, diğer katılımcılar ise yalnızca mesajları görüntüleyebilir ve yorum bırakabilir.

Bir Telegram grubuna/kanalına bot nasıl eklenir

Bot için bu özellik BotFather'da bulunur:

Adım 1. Bot ayarlarına gidin:

Adım 2. "Gruplara İzin Ver" seçeneğine tıklayın.

Adım 3. Etkin durumda olmalıdır.

Bir gruba/kanala yönetici olarak bot ekleme

Sohbetlerde ve kanallarda iş akışını otomatikleştirmek için kendi botunuzu Yönetici olarak eklemeniz gerekir.

Nasıl yapılır?

Adım 1. Grup/Kanal Yönetimi'ne gidin ve Yöneticiler sekmesini seçin.

Adım 2. "Yönetici Ekle" düğmesine tıklayın.

Adım 3. Arama kutusuna botunuzun kullanıcı adını girin.

Adım 4. Tam işlevsellik için botun mesajları okuma ve silme izinlerine sahip olduğundan emin olun.

Sohbetlerde çalışmak için değişkenler

Lütfen dikkat!

Sohbete katılma, sohbetten ayrılma, yeni beğeni vb. olaylar için grup sohbetlerinde değişkenlerin kaydedilmesi mümkün değildir.

Değişkenler yalnızca çalışan bloğun içinde kullanılabilir olacaktır. Çalışmayı izlemek için bu değişkenleri blokta çıktı olarak alabilirsiniz.

Bu, sohbet botlarının çalışmasını HİÇBİR ŞEKİLDE etkilemeyecektir, müşteriler bölümünde kimin girdiğini/çıktığını takip etmek imkansız olacaktır.

  • Mesajın yazarı hakkında bilgi içeren değişkenler

message_from - mesaj yazarının kimliği

message_from_name - mesaj yazarının adı

message_from_username - mesaj yazarının Telegram'daki takma adı

  • İletilen mesaj hakkında bilgi içeren değişkenler

reply_message_id - iletilen mesajın numarası

reply_from - iletilen mesajın yazarı kimdir

reply_from_name - mesajı iletilen kişinin adı

reply_from_username - mesajı iletilen kişinin takma adı

reply_from_chat_id - mesajın iletildiği diyaloğun numarası

  • Gruba ekleme ve gruptan çıkarma

Bu durumda, new_chat_member ve left_chat_member geri çağrıları tetiklenir (değişkenler müşteri kartında kaydedilmez):

chat_member_name - kullanıcı adı

chat_member_username - kullanıcının takma adı

chat_member_id - kullanıcının numarası

Telegram'da Geri Çağrılar

client_unsubscribed - müşteri aboneliği iptal etti, botu engelledi

client_returned - müşteri botun engelini kaldırdı

Gruplarda/kanallarda geri çağrılar

new_chat_member - yeni bir kullanıcı eklendi

left_chat_member - kullanıcı kanaldan ayrıldı

kicked_chat_member - kullanıcı yönetici tarafından silindi

chat_join_request - kanala ekleme talebi alındı

edited_channel_post - kanaldaki gönderi düzenlendi (edited_channel_post + düzenleme tarihi ve saati)

Geri çağrılar Müşteriler bölümünde görüntülenir

bot_added_to_group - sohbete bir bot eklendi (hangisi olduğu fark etmez, herhangi birine yanıt verir, bağlı bot grubun kendisine eklenmiş olsa bile);

bot_left_group - benzer bir geri çağrı, botun kanaldan kaldırılmasıdır;

new_like - gönderi beğenildi

like_deleted - gönderiden bir beğeni silindi

Geri çağrıdaki sayı (new_like; like_deleted), yanıtlanan veya kaldırılan mesajın kimliğidir.

Lütfen dikkat!

  • Tepki geri çağrıları Telegram kanallarında görüntülenmez! Tepki geri çağrıları yalnızca gruplarda gelir.
  • Bir kişi birden fazla beğeni koyduysa ve ardından 1 tanesini sildiyse, hangisinin silindiğini göstermez.

Gruplarda tepki içeren geri çağrılar göründüğünde, blokta aşağıdaki değişkenler kullanılabilir:

reaction_on_message_id - yanıtlanan mesajın kimliğini içerir

reaction_from - tepki verenin kimliği

message_from_username - tepki verenin kullanıcı adı (varsa)

reaction_from_name - tepki verenin adı

Ayrıca, Telegram bir mesaja yanıt verirse, karttaki reply_text değişkeni yanıtlanan mesajın tam metnini içerecektir.

Bir mesaj yanıt olarak (önceki bir mesaj alıntılanarak) gönderildiyse, sistem ayrıca alıntılanan metni içeren tg_quote değişkenini oluşturacaktır.

Boost ile geri çağrılar

  • chat_boost_from user #{id_user} - sohbete (veya kanala) boost verdi:

Bu geri çağrı tetiklendiğinde, değişkenler oluşturulur:

  • remove_boost_from user #{id_user} - sohbetten (veya kanaldan) boost'u aldılar:

Bu geri çağrı tetiklendiğinde, değişkenler oluşturulur:

  • chat_boost from giveaway - kanalda yıldız çekilişi sırasında verilir
  • remove_chat_boost from giveaway - kanalda yıldız çekilişi için boost süresi sona erdi

Gruplarda sistem bildirimlerinin silinmesi nasıl otomatikleştirilir

Tüm sistem mesajlarını otomatik olarak silmek için, del_tg_system_messages değişkenine herhangi bir değer atamak (değişken bir proje sabiti veya bir işlem değişkeni olabilir) ve bota mesajları silme izni vermek yeterlidir.

del_tg_system_messages değişkeni yalnızca gruplarda kullanılabilir. Kanallarda, bu değişkene herhangi bir değer atamak herhangi bir sonuç vermeyecektir.

Telegram grup ayarlarında yönetici hakları

Aşağıdaki sistem bildirimi türleri kaldırılır:

- Grubun adı değiştirildi

- Grubun fotoğrafı değiştirildi

- Grup fotoğrafı silindi

- Mesaj sabitlendi

- Kullanıcı gruba katıldı

- Kullanıcı gruptan ayrıldı

Yalnızca belirli sistem bildirimi türlerini silmek istiyorsanız, del_tg_system_messages değişkeni yerine del_tg_chosen_messages değişkenini oluşturun ve içine virgülle ayrılmış, silinecek bildirim türlerini içeren bir dizi koyun.

Lütfen dikkat!

Bu değişkenler yalnızca Telegram grupları için çalışacaktır, kanallar için değil.

Sistem bildirimi seçenekleri:

  • 'new_chat_member' – kullanıcı gruba katıldı,
  • 'left_chat_member' – kullanıcı gruptan ayrıldı,
  • 'pinned_message' – mesaj sabitlendi,
  • 'delete_chat_photo' – grup fotoğrafı silindi,
  • 'new_chat_photo' – grubun fotoğrafı değiştirildi,
  • 'new_chat_title' – grubun adı değiştirildi

Örneğin, gruba katılma dışındaki tüm sistem mesajı türlerini silmeniz gerekiyor; o zaman proje değişkenine (sabit) "new_chat_member" dışındaki tüm geri çağrı türlerini eklemeniz gerekir.

Lütfen dikkat!

Sistem bildirimlerinin silinmesi geri çağrıları etkilemez. Yalnızca Telegram diyaloğundaki sistem mesajı silinecektir.

Telegram'da Forum

Forum, tartışma için ayrı konular oluşturabileceğiniz bir gruptur. Forumda standart işlevleri kullanabilirsiniz: medya dosyaları ekleme, anketler yayınlama ve bildirimleri ayarlama. Ayrıca mesajları sabitleyebilir ve her sohbete ayrı botlar ekleyebilirsiniz.

Bir forumun temel amacı, büyük bir topluluk içinde iletişimi yapılandırmaktır.

Çok sayıda katılımcının olduğu standart bir grup sohbetinde, konuşmaları takip etmek ve ilgili mesajları bulmak zorlaşır. Forumlar bunu, tartışmaları özel, tematik başlıklar halinde düzenleyerek çözer. Bu, topluluğu otomatik olarak konuya ve ilgi alanına göre böler ve iletişimi daha odaklı ve yönetilebilir hale getirir.

Grupta 100'den fazla üye varsa, yalnızca grup sahibi bir konu oluşturabilir. Grup bir kanala bağlıysa, bir tema oluşturamazsınız. Konular Grup ayarlarında etkinleştirilir:

Yönetici olarak, forum grubunun ayarlarında bir konu oluşturabilirsiniz:

Konular bağlandıktan sonra, avatar yuvarlaktan kareye değişecektir, bu da forumu diğer Telegram sohbetlerinden ayırt etmenizi sağlar:

Bir Telegram-müşteri paketi bir web sitesiyle nasıl yapılandırılır?

Başarılı bir ödemeden sonra bir telegram müşterisi ile web sitesinden bir müşterinin nasıl bağlanacağı hakkında daha fazla bilgiyi burada bulabilirsiniz.