# Telegram API işlevleri

API işlevleri, Telegram’daki bir botun yeteneklerini önemli ölçüde genişletir. API işlevlerini kullanarak Telegram’daki ekler, gruplar ve sohbetlerle çalışabilirsiniz — örneğin kullanıcıları otomatik olarak engelleme veya engelini kaldırma ve çok daha fazlası!

{% hint style="info" %}
Kaynak: [Telegram bot API](https://core.telegram.org/bots/api)
{% endhint %}

{% hint style="warning" %}
Önemli! 

API işlevleriyle nasıl çalışılacağını anlamak için, hesap makinesinde işlevlerin ve parametrelerin belirtilme kurallarını incelemenizi şiddetle tavsiye ederiz.

<mark style="color:kırmızı;">**GÖSTERİM:**</mark>

<mark style="color:kırmızı;">**!**</mark> — ünlem işareti, zorunlu parametreleri gösterir

**parameter=None** — bu, belirtilen parametrenin varsayılan değerini gösterir.

Şu <mark style="color:kırmızı;">**yanlış**</mark> belgelemelerden işlev metnini doğrudan kopyalamak, örneğin şu şekilde: tg\_send\_message(platform\_id, "Some text", client\_message\_id=61818138, reply\_markup=None, parse\_mode=None, disable\_web\_page\_preview=0, protect\_content=False)

Eşittir işaretlerinden sonraki değerler, her parametre için varsayılan değerleri temsil eder. Bu nedenle, belirli bir parametreye ihtiyacınız yok ama ardından gelen bir parametreye ihtiyacınız varsa, kullanılmayanı sadece atlayamazsınız — bunun yerine, onun varsayılan değerini açıkça iletmelisiniz.

Böylece, <mark style="color:yeşil;">**doğru**</mark> kullanım şu şekilde olur: tg\_send\_message(platform\_id, "Some text", 61818138, None, None, 0, True)
{% endhint %}

### Nereden bulabilirim <mark style="color:kırmızı;">platform\_id</mark> bildirim göndermek için?

* Projenize bağlı bir Telegram botunuz olmalı.
* Bildirim almak istediğiniz Telegram hesabından bu bot’a herhangi bir mesaj gönderin.
* Proje istemcileri listesinden, istek göndermek istediğiniz istemci sohbetini seçin.
* Messenger alanındaki ID değerini kopyalayın.

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

<details>

<summary>Aşağıdaki öğeyi iletme örneği <mark style="color:kırmızı;">platform_id</mark> parametresi:</summary>

1. platform\_id parametresi, sayısal değerler açıkça belirtilmeden iletilebilir.

<figure><img src="/files/fbb07fc12421315b1c6fb674b60de16237aa0a53" alt=""><figcaption><p>platform_id herhangi bir değer olmadan sağlandı</p></figcaption></figure>

`react = tg_set_reaction(platform_id, 1556, '👌')`

Bu parametreye sahip işlevler, platform\_id değeri açıkça belirtilmeden de çalışır.
\
Önemli: Çoğu işlevde bu parametre zorunludur ve atlanmamalıdır. <br>

2\. İşlevi belirli bir sohbet, kanal veya grupta kullanmanız gerekiyorsa, platform\_id’yi sayısal bir değer olarak belirtmelisiniz.

<figure><img src="/files/8626f9c60503dcda38bc71afb9728a5368308300" alt="" width="563"><figcaption></figcaption></figure>

İşlevde **tg\_send\_message(!platform\_id, !text)** yukarıda gösterildiği gibi, platfor&#x6D;**\_id parametresi** tırnak işaretleri içinde bir sayısal değer kullanılarak iletilir:

`tgmess = tg_send_message('1234566788', 'Merhaba!')`&#x20;

<figure><img src="/files/764360a1d6eab4e9361fe8c91fee52a1ea2c68ac" alt="" width="563"><figcaption></figcaption></figure>

</details>

### reply\_markup parametresinde düğmeler nasıl tanımlanır

**Yanıt düğmelerine örnek:**

`opts = {"keyboard": [[{"text": "Sol"}, {"text": "Sağ"}]]}`

**Satır içi düğmelere örnek:**

opts = {"inline\_keyboard": \[\[{"text": "Paket 1","callback\_data":1}, {"text": "Paket 2","callback\_data":2}]]}

### parse\_mode parametresinde metin biçimlendirmesi (Markdown) nasıl kullanılı&#x72;**?**&#x20;

Düğmenin **parse\_mode** parametresi, tüm metni veya bir kısmını *italik* veya **kalın**biçiminde biçimlendirir. Şu değerleri alabilir: html, markdown veya markdownV2.

1. <mark style="color:mavi;">**html’yi seçerseniz:**</mark>

&#x20;        şunlar için **kalın metin**için şunu kullanın  `"<b>başlık</b>"`

&#x20;        şunlar için *italik metin*için şunu kullanın `"<i>başlık</i>"`

2. <mark style="color:mavi;">**Markdown için:**</mark>

&#x20;        şunlar için **kalın metin**için şunu kullanın  `"*başlık*"`

&#x20;        şunlar için *italik metin*için şunu kullanın  `"_başlık_"`

**İtalik metin gönderme örneği:**\
`tg_send_message(47615196, "<i>italic</i>",None,None,"html")`

**Kalın metin gönderme örneği:**\
`tg_send_message(platform_id, '*test*', None, None, 'markdown')`


---

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