# Kişisel Telegram hesabı için chatbot

## Bilinmesi önemli

Bir hesabı kullanırken, kullanım senaryosuna dayalı kısıtlamalar uygulanabilir. Kesin veriler mevcut değildir, ancak yaklaşık limit değerleri açık kaynaklarda bulunabilir.

{% hint style="warning" %}
SINIRLAMALAR VE ÖNERİLER

1. Yeni bir Telegram hesabında (yeni kayıt olmuş) ilk senkronizasyon sırasında istediğiniz sayıda kişiyi ekleyebilirsiniz.
2. Mevcut hesaplarda 200 kişi sınırı vardır.
3. Daha önce kişilerin eklendiği yeni bir hesap için sınır 200'dür.
4. 200 kişi sınırını aşarsanız, yine de günde manuel olarak en fazla 15 kişi ekleyebilirsiniz.
5. Daha fazla kısıtlamadan kaçınmak için kişileri gün boyunca kademeli olarak ekleyin. Bir seferde çok fazla eklemek (ör. 5-10 dakika içinde 15 kişi) daha sıkı günlük limitleri tetikler: ertesi gün 5 kişi ve alt sınır da aşılırsa sonunda günde sadece 1 kişi.
6. Gün boyunca 15 kişi eklerseniz, ertesi gün herhangi bir sınır uygulanmaz.
7. Günlük sınır, farklı sohbetlere 40 mesajdır; bundan sonra hesabınız geçici olarak kısıtlanacaktır.
   {% endhint %}

<details>

<summary>KISITLAMALAR HAKKINDA DAHA FAZLA</summary>

### İletişim

Bir telefon numarasına mesaj göndermek için önce onu Telegram kişi listenize eklemeniz gerekir.

**Kişi listesi senkronizasyonu:**

a) Telegram'da daha önce hiç kullanılmamış bir numarayla yeni oluşturulmuş bir hesap için, ilk kişi senkronizasyonunda içe aktarma sınırı yoktur.

b) Daha önce Telegram'a kaydedilmiş telefon numaraları için, ilk kişi içe aktarma işlemi 200 kişiyle sınırlıdır. Bu sınır, yeniden senkronizasyon yapılırsa yeni numaralar için de geçerlidir.

c) 200 kayıt sınırına ulaşıldığında, yeni kişiler *manuel olarak*.

#### Manuel kişi oluşturma

Çok fazla kişiyi çok hızlı eklemek (ör. bir dakikada 15 kişi), sınırınızı ertesi gün 5 kişiye düşürür.

Aynı gün içinde hızlıca 5 kişi daha eklemek, sınırı günde 1'e kadar daha da düşürür. Ancak eklemeleri eşit şekilde yaymak (ör. 15 kişiyi gün boyunca) ertesi gün için tam sınırı korur.

Kısıtlama zamanla sıfırlanmaz.

Telegram'a göre:

> &#x20;*«Kullanıcılarımızı spam ve kötüye kullanımdan korumak için, aynı anda içe aktarılabilecek kişi sayısını sınırlayan korumalar uyguladık. Bu sınırları aşarsanız, hesabınızın daha fazla kişi içe aktarması kısıtlanır. Bu gibi durumlarda, günde manuel olarak en fazla beş yeni numara ekleyebilirsiniz. Bu sınırın ötesinde eklenen diğer kişiler, zaten platformda olsalar bile Telegram kullanıcısı olarak tanınmaz.»*

{% hint style="success" %}
**İpucu:** Kısıtlamaları önlemek için kişi eklemelerini tam güne yayın.
{% endhint %}

### Kullanıcı adı ekleme sınırları

Bir kullanıcının kullanıcı adı varsa, onu kişileriniz arasına kaydetmeniz gerekmez — doğrudan mesaj gönderebilirsiniz. Ancak, bu tür kullanıcıları arama işlemi günde yaklaşık 200 istekle sınırlıdır.

### Spam'a izin verilmez

Telegram, aşırı mesajlaşma veya aynı anda çok fazla sohbete mesaj gönderme nedeniyle hesabı geçici veya kalıcı olarak engeller.

{% hint style="warning" %}
Geçici kısıtlamalar dakika, saat veya gün sürerken, kalıcı yasak hesabın erişimini süresiz olarak iptal eder. Bu ceza genellikle toplu spam, dolandırıcılık, yasaklı içerik paylaşımı veya tekrarlanan kullanıcı şikayetleri dahil olmak üzere ağır ihlaller için uygulanır.
{% endhint %}

1. Günde farklı sohbetlere 40'a kadar mesaj gönderebilirsiniz; bundan sonra geçici bir engel etkinleştirilir.
2. Mesajlaşma sınırının tekrar tekrar ihlal edilmesi, dakikalardan ve saatlerden günlere veya haftalara kadar değişen, giderek daha uzun engellere yol açar ve bu durum kalıcı hesap yasağına kadar ilerleyebilir.
3. Aynı mesajları arka arkaya, ara vermeden gönderirseniz, birkaç denemeden sonra bir engel uygulanabilir.
4. Spam olarak tanımlanan içerik, anında ve kalıcı bir yasağa yol açabilir.
5. Mesajlarınız diğer kullanıcılardan şikayet (rapor) alırsa, bir engel de kaçınılmazdır.

</details>

## Başlarken

Hesabınızı bağlamak için önce api\_id ve api\_hash değerlerinizi alın. Şuraya gidin: [https://my.telegram.org](https://my.telegram.org/) ve hesabınıza giriş yapın.

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

Giriş yaptıktan sonra, şuraya geçin: **"API development tools"** bölümünde görünecektir.

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

Ardından alanları doldurun:

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

1. Düğmenin **"App title"** alanı, yalnızca harfler kullanılarak, boşluk veya herhangi bir sembol olmadan doldurulmalıdır (alt çizgi, virgül vb. yok).
2. Düğmenin **"Short name"** alanı, yalnızca harfler ve rakamlar kullanılarak, boşluk veya herhangi bir sembol olmadan doldurulmalıdır (alt çizgi, virgül, nokta, tire, kesme işareti vb. yok).
3. Düğmenin **"URL"** alanı, web sitenize ait geçerli bir bağlantıdır.
4. Seçin **"WEB"** alanına **"Platform".**
5. Açıklama şu dilde olmalıdır: **Latin**.

Sonra şuna tıklayın: **Uygulama oluştur**.&#x20;

Düğmenin `[object Object]` hatası [**my.telegram.org**](https://my.telegram.org/) geçersiz veri olduğu anlamına gelir. Tüm alanların doğru olduğundan ve **'app title'** ve **'short name'** alanlarının daha önce alınmamış olduğundan emin olun.

Her şeyi doğru doldurduysanız, aşağıdaki verileri göreceksiniz:

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

## Hesap bağlantısı

"Messenger" bölümünde "Telegram Account" seçin, ardından telefon numaranızı ve elde edilen bilgileri (api\_id ve api\_hash) girin.

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

Tıklayın **"Get code"**:

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

Telegram hesabınıza bir doğrulama kodu gönderilecektir. Kodu girin:

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

Hesabınızda iki faktörlü kimlik doğrulama (2FA) etkinse, şifrenizi de girmeniz gerekir.

## Grup sohbetleri

Botun grup sohbetlerinde yanıt vermesine izin vermek için, istemci değişkenini answer\_on\_group\_chat = "1" olarak ayarlayın. Varsayılan olarak bu özellik devre dışıdır.

## Sohbet arşivi

Arşivlenen sohbetler işlemden hariç tutulur.

## Bir telefon numarası kullanarak sohbet başlatma

Yeni bir müşteriyle bir sohbet başlatmak için şuraya gidin: **"Müşteriler"** bölümüne gidin ve şuna tıklayın: **"Write in Telegram".**

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

Açılan pencerede müşterinin telefon numarasını ve adını girin ve şuna tıklayarak onaylayın: **"Ekle"**.

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

Yeni müşteri, Telegram gizlilik ayarlarını telefon numarasıyla bulunmaya izin verecek şekilde yapılandırdıysa, yeni bir müşteri kaydı oluşturulur.

## Dosyadan müşteri içe aktarma

Müşterileri bir dosyadan içe aktarabilirsiniz. Bunun için şuna tıklayın: **Müşteri listesi yükle** alanına **Messenger'lar** istenen botun bölümünde.

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

İçe aktarma tamamlandığında, telefon numarasına göre kişilere eklenebilecek olanlar için müşteri profilleri oluşturulacaktır.

{% hint style="danger" %}
LÜTFEN DİKKAT!

Telegram hesabı kişi oluşturma kısıtlamalarını dikkate alın. Daha fazla bilgi için şuraya bakın: [Bilinmesi önemli ](#important-to-know)bölümünde görünecektir.&#x20;
{% endhint %}

## Hesap makinesi yöntemleri

create\_telegram\_client(phone, name, group) - belirtilen numarayı Telegram hesabındaki kişilere ekler ve MaviBot'ta buna karşılık gelen bir müşteri oluşturur.

phone - müşterinin telefonu

name - müşterinin adı

group - bot bağlantısı için hedef bot kullanıcı kimliği.

{% hint style="success" %}
Hesap makinesi ayrıca genel/yaygın yöntemleri de destekler.
{% endhint %}


---

# 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/personal.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.
