# Telegram botu nasıl yapılır

{% hint style="warning" %}

#### **Telegram gereksinimleri ve limitleri**

**1. Mesaj limitleri**

* **Sadece metin içeren mesaj:** En fazla **4.096 karakter**.
* **Görsel içeren mesaj:** En fazla **1.024 karakter** (1080x1080 px bir görsel için).

**2. Görsel gereksinimleri**

* **Biçim:** Kare görseller tercih edilir.
* **Optimal boyut:** 900x900 piksel, maksimum **5 MB**.

**3. Dosya gereksinimleri**

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

* Botlar şu boyuta kadar dosya gönderebilir: **2 GB**.
* şunu kullanabilirsiniz **file\_id** önceden yüklenmiş dosyalarla çalışmak için. Bu durumda dosya limitleri Telegram dokümantasyonuna göre uygulanır.
* Dosyalar şu yöntemle gönderilebilir: **URL** (bot indirir ve gönderir):
  * **Fotoğraflar:** ≤ 5 MB
  * **Diğer dosyalar:** ≤ 20 MB
* Gönderim için farklı limitler geçerlidir:
  * **Fotoğraflar:** 10 MB
  * **Diğer dosyalar:** 2 GB

[Orijinal kaynakta daha fazla okuyun](https://core.telegram.org/bots/api#sending-files)
{% endhint %}

## Telegram botu oluşturma

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

**Oluşturma adımları:**

1. **Bir sohbet başlatın** yerine [BotFather](https://t.me/botfather).
2. Şu komutu gönderin: `/newbot`
3. **Bir ad seçin** botunuz için (bu, kullanıcılar için görünen addır).
4. **Bir kullanıcı adı seçin** botunuz için. Bu **zorundadır** ile bitmelidir `bot` veya `_bot` (ör. `my_test_bot`).

Kullanıcı adı uygunsa, BotFather size bir onay mesajı gönderir ve içinde bir **"token"**—API erişimi için benzersiz bir anahtar—bulunur.

> **Önemli:** Bu token botunuz için bir şifredir. Güvenli bir yerde saklayın ve **asla kimseyle paylaşmayın** .

<div data-with-frame="true"><figure><img src="/files/c8619f620fdb58fbb1be0ddee46f6366c80acff6" alt=""><figcaption></figcaption></figure></div>

şuraya gidin: **Messenger'lar** bölümünde **Telegram**, ve botunuzun tokenını verilen alana yapıştırın.

<div data-with-frame="true"><figure><img src="/files/b2617685137921288d127b8f80cbd4829a6f58c9" alt=""><figcaption></figcaption></figure></div>

Şuna tıklayın: **Tamam** düğmesine basarak bot kurulumunu tamamlayın ve projenizle bağlantıyı etkinleştirin.

### Telegram grupları/kanallarıyla çalışma

**Faydalı bilgiler**

Bir 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. Sadece sahibi veya yöneticiler mesaj gönderebilir; diğer katılımcılar yalnızca onları görüntüleyebilir ve yorum bırakabilir.

#### Bir botu Telegram grubuna/kanalına nasıl ekleyebilirim

Bot için bu özellik BotFather içinde bulunur:

1\. Adım. Bot ayarlarına gidin:

<div data-with-frame="true"><figure><img src="/files/42a198225337342aba7bc24175ea68f80d999878" alt="" width="563"><figcaption></figcaption></figure></div>

2\. Adım. Şuna tıklayın **"Allow Groups?"**

<div data-with-frame="true"><figure><img src="/files/6da2a2f600525b87f5aea75ee7a4981df6d976d2" alt="" width="563"><figcaption></figcaption></figure></div>

3\. Adım. Etkinleştirilmiş bir durum görünmelidir.

<div data-with-frame="true"><figure><img src="/files/dce84b196b3a9139837737944a9c22c2c037e894" alt="" width="563"><figcaption></figcaption></figure></div>

### Bir botu grupta/kanalda yönetici olarak ekleyin

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

Nasıl yapılır?

1\. Adım. Grup/Kanal Yönetimine gidin ve şunu seçin: **Yöneticiler** sekme

<div data-with-frame="true"><figure><img src="/files/0ec5afc76482d5d399a4b450495ba9d56962cc69" alt="" width="563"><figcaption></figcaption></figure></div>

2\. Adım. Şuna tıklayın: **"Add Admin"** düğmesine tıklamanız gerekir.

<div data-with-frame="true"><figure><img src="/files/41e4e10a9a4e286ff945d83dc933f705976a891e" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/2493e3c7a8c27deab7257c5321eef56374697847" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/674d17d471cadc97e922c797433b7d9cbec3eeed" alt="" width="375"><figcaption></figcaption></figure></div>

### Sohbetlerde çalışma için değişkenler

{% hint style="warning" %}
Lütfen dikkat edin!

Bir sohbete katılma, bir sohbetten çıkma, yeni beğeni vb. gibi olaylar için grup sohbetlerinde değişkenleri kaydetme özelliği mevcut değildir.

Değişkenler yalnızca çalışmış olan bloğun içinde kullanılabilir. Çalışmayı izlemek için bu değişkenleri blokta çıktı olarak verebilirsiniz.

Bu, sohbet botlarının çalışmasını hiçbir şekilde ETKİLEMEYECEKTİR; istemciler bölümünde kimin girip çıktığını izlemek mümkün olmayacaktır.
{% endhint %}

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

message\_from - mesaj yazarının ID'si&#x20;

message\_from\_name - mesaj yazarının adı

message\_from\_username - Telegram'daki mesaj yazarının takma adı

<div data-with-frame="true"><figure><img src="/files/5a01166f2454de908f99b68d0f1ad991fe006083" alt="" width="310"><figcaption></figcaption></figure></div>

* Yönlendirilen mesaj hakkında bilgi içeren değişkenler

reply\_message\_id - yönlendirilen mesajın numarası&#x20;

reply\_from - yönlendirilen mesajın yazarı kim

reply\_from\_name - mesajı yönlendirilen kişinin adı

reply\_from\_username - mesajı yönlendirilen kişinin takma adı

reply\_from\_chat\_id - mesajın yönlendirildiği diyaloğun numarası

* Bir gruba ekleme ve gruptan kaldırma

Bu durumda new\_chat\_member ve left\_chat\_member geri çağrıları tetiklenir (değişkenler istemcinin kartında kaydedilmez):

chat\_member\_name - kullanıcı adı&#x20;

chat\_member\_username - kullanıcının takma adı

chat\_member\_id - kullanıcının numarası

### Telegram'daki geri çağrılar

client\_unsubscribed - müşteri abonelikten çıktı, botu engelledi

client\_returned - müşteri botun engelini kaldırdı

<div data-with-frame="true"><figure><img src="/files/3349c56526e54634b428abe1c13e48251766dd31" alt="" width="349"><figcaption></figcaption></figure></div>

#### Gruplarda/kanallarda geri çağrılar

new\_chat\_member - yeni bir kullanıcı eklendi

left\_chat\_member - kullanıcı kanaldan ayrıldı&#x20;

kicked\_chat\_member - kullanıcı yönetici tarafından silindi

chat\_join\_request - kanala eklenme isteği alındı

edited\_channel\_post - kanaldaki gönderi düzenlendi (edited\_channel\_post + düzenleme tarihi ve saati)

<div data-with-frame="true"><figure><img src="/files/f699b33791879113356358da3157264dd4a269c0" alt="" width="347"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d7d758a12cb31b7bbdf5e78e06283d56315d271c" alt="" width="333"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/6f8bcbe22eba8918ed2eedd2e5a052265c8be9a3" alt="" width="322"><figcaption></figcaption></figure></div>

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

bot\_added\_to\_group - sohbete bir bot eklendi (hangi olduğunun önemi yoktur, bağlı bot grubun kendisine eklenmiş olsa bile herkese yanıt verecektir);

bot\_left\_group - benzer bir geri çağrı, botu kanaldan kaldırmaktır;

new\_like - gönderi beğenildi

like\_deleted - gönderiden bir beğeni silindi

<div data-with-frame="true"><figure><img src="/files/18db6d7954b6cb10d3048b89182e75d6ae80d304" alt="" width="358"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/bd55d27c936c0a23c8d3f369ea30a48c0b361d17" alt="" width="326"><figcaption></figcaption></figure></div>

Geri çağrıdaki sayı (new\_like; like\_deleted), yanıt verilen veya kaldırılan mesajın ID'sidir.

{% hint style="warning" %}
Lütfen dikkat edin!

* Reaksiyonlara ait geri çağrılar Telegram kanallarında görüntülenmez! Reaksiyonlara ait geri çağrılar yalnızca gruplarda gelir.
* Bir kişi birkaç beğeni verdi ve sonra bunlardan 1 tanesini sildi ise, hangisinin silindiği gösterilmez.
  {% endhint %}

Reaksiyonlarla ilgili geri çağrılar gruplarda göründüğünde, blokta şu değişkenler kullanılabilir:

reaction\_on\_message\_id - yanıt verilen mesajın ID'sini içerir

reaction\_from - reaksiyonun geldiği kişinin id'si

message\_from\_username - reaksiyonun geldiği kullanıcının adı (varsa)

reaction\_from\_name - reaksiyonun geldiği kişinin adı

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfQptKK4YrlEATINQANRDaNEnpT95W_lgIGjMfOitIn387SG1GKI_n02rgWMZUrCP6hEGEnYAPiY99aZud2Ze4iOCYSlDCpzNsyHAMFdHd_mCxP5VfBpSx2iG7HzP1lgzDDly1Ziw?key=lL8rEUrFbZeHFjWugKFnxg" alt="" width="375"><figcaption></figcaption></figure></div>

Ayrıca, Telegram bir mesaja yanıt verirse, karttaki reply\_text değişkeni yanıtlanan mesajın tam metnini içerir.

<div data-with-frame="true"><figure><img src="/files/cecec9e64bd936673737eca7d9f55675ab4172b6" alt="" width="337"><figcaption></figcaption></figure></div>

Bir mesaj yanıt olarak gönderildiyse (önceki bir mesaj alıntılanıyorsa), sistem ayrıca şunu oluşturur: `tg_quote` değişkeni, alıntılanan metni içerir.

<div data-with-frame="true"><figure><img src="/files/7c10c3edfe3db6c9ecb7eb95782d482b795e5b67" alt="" width="188"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/336a4513e41f262bb42b643a51a652833d643329" alt="" width="375"><figcaption></figcaption></figure></div>

#### Boost ile geri çağrılar

* chat\_boost\_from user #{id\_user} - sohbete (veya kanala) boost verdi:

<div data-with-frame="true"><figure><img src="/files/ce60fa37912e51d68e214a77d6e32e023fb9305c" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/6c732ac869da805bda3222a87c1f0c7fc657a325" alt="" width="375"><figcaption></figcaption></figure></div>

* remove\_boost\_from user #{id\_user} - boostu sohbetten (veya kanaldan) geri aldılar:

<div data-with-frame="true"><figure><img src="/files/938041467e1b7e2f6e1b9bd613d1516feba0a410" alt="" width="375"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e495148661a571e5fe284a9db309ac09976a8ec1" alt="" width="344"><figcaption></figcaption></figure></div>

* chat\_boost from giveaway - kanalda yıldız çekilişi sırasında verildi
* remove\_chat\_boost from giveaway - kanalda yıldız çekilişi için boost süresi sona erdi

#### Gruplarda sistem bildirimlerinin kaldırılmasını otomatikleştirme

Tüm sistem mesajlarını otomatik olarak silmek için del\_tg\_system\_messages değişkenine herhangi bir değer atamanız yeterlidir (değişken proje sabiti veya işlem değişkeni olabilir) ve botun mesajları silme izni verilmelidir.

del\_tg\_system\_messages değişkeni yalnızca gruplarda kullanılabilir. Kanallarda, bu değişkene herhangi bir değer atamak bir sonuç vermez.

<div data-with-frame="true"><figure><img src="/files/cf1cd242800d1e1bd8e6796203d3af4e4c7dbe64" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/39109eee77c2701ab10870fac0485d59802c9e0b" alt="" width="349"><figcaption></figcaption></figure></div>

**Telegram grup ayarlarında yönetici yetkileri**

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

\- Grup 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 seçili sistem bildirim 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 silinecek bildirim türlerini virgülle ayırarak bir dizi olarak koyun.

{% hint style="warning" %}
Lütfen dikkat edin!

Bu değişkenler yalnızca Telegram grupları için çalışır, kanallar için değil.
{% endhint %}

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' – grup adı değiştirildi

Örneğin, gruba katılma hariç tüm sistem mesajlarını silmeniz gerekiyorsa; proje değişkenine (sabit) "new\_chat\_member" hariç tüm geri çağrı türlerini eklemeniz gerekir.

<div data-with-frame="true"><figure><img src="/files/e9a2c0739bc72ff8f83a360104cf4310253ad7c5" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Lütfen dikkat edin!

Sistem bildirimlerini silmek geri çağrıları etkilemez. Yalnızca Telegram diyaloğundaki sistem mesajı silinir.
{% endhint %}

### Telegram'da forum

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

<div data-with-frame="true"><figure><img src="/files/9fc5087655ebf49ba521290fd1676a59528d2997" alt="" width="375"><figcaption></figcaption></figure></div>

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

Birçok katılımcının bulunduğu standart bir grup sohbetinde konuşmaları takip etmek ve ilgili mesajları bulmak zorlaşır. Forumlar, tartışmaları **özel, tematik konulara**düzenleyerek bunu çözer. Bu, topluluğu otomatik olarak konu ve ilgi alanına göre böler, 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 şu bölümde etkinleştirilir: **Grup ayarları**:

<div data-with-frame="true"><figure><img src="/files/99dc47a5b92447df906d466829f368ff403c0ea0" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/6f35d69abd38e4fbe0dedc174237310bd7bc4deb" alt="" width="563"><figcaption></figcaption></figure></div>

Bağladıktan sonra **Konular**avatarı yuvarlaktan kareye değişecektir; bu da forumu diğer Telegram sohbetlerinden ayırt etmenizi sağlar:

<div data-with-frame="true"><figure><img src="/files/4b27df278d371ab7889c914a64e9ee5e980bc796" alt="" width="563"><figcaption></figcaption></figure></div>

### Bir Telegram istemci paketi bir web sitesiyle nasıl yapılandırılır?

Başarılı bir ödemeden sonra bir telegram istemcisini ve web sitesinden bir istemciyi nasıl bağlayacağınız hakkında daha fazla okuyun burada [başarılı bir ödeme](#how-to-configure-a-telegram-client-bundle-with-a-website).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/chatbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.