# Mesajlarda ek gönderme işlevleri

## Belgeler nasıl gönderilir

<details>

<summary>Belge gönder  tg_send_document() </summary>

<mark style="color:kırmızı;">**!**</mark> Bu işlevler, herhangi bir türde dosya göndermenize olanak tanır. Önerilen форматlar: **GIF, PDF, ZIP** en fazla **2GB**.

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>&#x20;

**tg\_send\_document(platform\_id, document, caption, reply\_markup, parse\_mode,reply\_to\_message\_id, protect\_content, disable\_notification**, **message\_thread\_id, entities)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderilmesi gereken Telegram’daki istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii) &#x20;

<mark style="color:kırmızı;">**!**</mark>**&#x20;document** - Telegram sunucusundaki belgeye bağlantı. Bağlantının tg\_request aracılığıyla nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md).&#x20;

**caption** - açıklama, en fazla 1024 karakter

**reply\_markup** — düğme ayarları [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)&#x20;

**parse\_mode** — açıklamadaki metin biçimlendirmesi (kalın veya italik)  [ **\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)**.** Olası değerler: html, markdown, markdownV2. ссылка

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**disable\_notification** — ses bildirimini kontrol etme bayrağı (varsayılan: 0).\
1 - bildirim olmadan gönder, 0 - bildirimle gönder

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)\
\
**entities** — önceden biçimlendirilmiş metni stilleriyle yeniden kullanmanıza olanak tanır. Biçimlendirme için karakter ofsetini ve aralığını tanımlamanız yeterlidir. Örnek, tg\_request içinde ilgili alanda mevcuttur. Bir sözlük olmalıdır.\
\
Parametreyi geçirme örneği: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
Bu örnekte yalnızca sözlük gösterilmiştir; gerçek mesaj metni ayrı bir değişkende tanımlanır.

Bir düğme kümesi açıklamasını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button).&#x20;

</details>

<details>

<summary>Birden fazla belge veya başka dosya gönder tg_send_some_document()</summary>

<mark style="color:kırmızı;">**!**</mark> Bu işlevler, herhangi bir türde dosya göndermenize olanak tanır. Önerilen форматlar: **GIF, PDF, ZIP** en fazla **2GB**.

**tg\_send\_some\_document(platform\_id, document\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderilmesi gereken Telegram’daki istemci kimliği  [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)&#x20;

<mark style="color:kırmızı;">**!**</mark>**&#x20;document\_list** - belgelerden oluşan bir dizi. Böyle bir dizinin nasıl oluşturulacağına dair örnek aşağıda verilmiştir

**disable\_notification** — ses bildirimini kontrol etme bayrağı (varsayılan: 0).\
1 - bildirim olmadan gönder, 0 - bildirimle gönder

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

**document\_list dizisini oluşturma örneği:**\
'\[\["Belge bağlantısı", "caption", "parse\_mode"], \["Belge bağlantısı 2"], \["Belge bağlantısı 3", "caption"]]'&#x20;

**Tek bir belge için veri biçimlendirme örneği** \
\["Belge bağlantısı", "caption", "parse\_mode"]&#x20;

<mark style="color:kırmızı;">**Parametrelerin sırası önemlidir!**</mark> Bir belge dizisi oluştururken tırnak işaretleri " " çıkarılabilir.

**document\_list dizisi için parametre açıklaması:**\ <mark style="color:kırmızı;">**!**</mark>**&#x20;Belge bağlantısı** - Telegram sunucusundaki belge bağlantısı. Bağlantının з tg\_request aracılığıyla nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md)   \
**caption** — açıklama en fazla 1024 karakter\
**parse\_mode** — açıklamanın biçimlendirilmesi, yani metnin kalın veya italik olarak vurgulanması  [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Örnek</summary>

Bir belgeyi gönderme, satır içi düğmeler ekleme ve belgeye açıklama ekleme örneğini inceleyelim:

1. Önce, belgenizin bağlantısını alın. Bunu nasıl yapacağınıza dair ayrıntılı açıklama [burada bulunabilir.](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md#how-to-get-a-media-link-using-a-variable)
2. Bir blok oluşturun ve değişkenleri ekrandaki gibi ayarlayın:<br>

   <div data-with-frame="true"><figure><img src="/files/48dc422a4142b96f04c779a092f4ad3b0f993745" alt="" width="563"><figcaption></figcaption></figure></div>
3. Bloğu kendimize gönderelim ve çalışmamızın sonucuna bakalım:

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

Şimdi birden fazla belge göndermeye bakalım.

1. Burada da her belge için dahili bir Telegram bağlantısı almanız ve bir dizi oluşturmanız gerekir.\
   lnkdoc='\[\["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],\["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
2. Son olarak, belgeleri göndermek için işlevi bir araya getirin:

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

3\. Ve çalışmanın sonucuna bakın:

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

Tek bir belge göndermek için kod örneği:

```
lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excellent","callback_data":"Answer1"}, {"text": "Not accepted","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Belge gönderimi", opts) 
```

Birden fazla belge göndermek için kod örneği:

```
lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)
```

</details>

## Ses / sesli mesaj nasıl gönderilir

<details>

<summary>Sesli mesaj gönder <strong>tg_send_voice(</strong>)</summary>

<mark style="color:kırmızı;">!</mark> Bu işlev, .OGG türünde ve OPUS ile kodlanmış, boyutu 2 GB’a kadar olan ses dosyalarının gönderilmesine olanak tanır.

<mark style="color:varsayılan;background-color:green;">**! Yalnızca Telegram işletme hesabıyla çalışır**</mark>

**tg\_send\_voice(platform\_id, voice, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, disable\_notification, message\_thread\_id, entities)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;voice** - .OGG biçimindeki sesli mesaja bağlantı

**caption** - açıklama en fazla 1024 karakter

**reply\_markup** — düğme ayarları [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — açıklamadaki metin biçimlendirmesi, kalın veya italik [ **\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)**.** Olası değerler:  html, markdown, markdownV2.

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**disable\_notification** — bildirim sesiyle mesaj gönderme bayrağı (varsayılan 0’dır)   1 - alındığında bildirimi kapat, 0 - bildirimle gönder

**message\_thread\_id** — konu kimliği (forum özelliği etkinse süper gruplarda kullanılabilir).\
\
**entities** —bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg\_request içinde ilgili alanda bir örnek görebilirsiniz. Parametre bir sözlük olmalıdır. \
\
Parametre geçirme örneği: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
Örnek yalnızca bir sözlük gösterir; mesaj metninin kendisi bir değişkende tanımlanır.

Düğme seti açıklamasını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Birden fazla sesli mesaj gönder <strong>tg_send_some_audio()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> Bu işlev, maksimum 2 GB boyutunda .MP3 veya .M4A türünde ses dosyalarının gönderilmesine olanak tanır.

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>&#x20;

**tg\_send\_some\_audio(platform\_id, audio\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;audio\_list** - ses dosyalarından oluşan bir dizi (detaylar aşağıda)

**disable\_notification** — mesajın bildirimli veya bildirimsiz gönderilmesini kontrol eden bayrak (varsayılan: 0).                                                                                                                   1 — bildirim olmadan gönder, 0 — bildirimle gönder

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

**audio\_list dizisini oluşturma örneği:** \
'\[\["Ses bağlantısı 1", "caption", "parse\_mode"], \["Ses bağlantısı 2"], \["Ses bağlantısı 3", "caption"]]'&#x20;

**Tek bir ses örneği:** \
\["Ses bağlantısı", "caption", "parse\_mode"]&#x20;

<mark style="color:kırmızı;">**Parametrelerin sırası önemlidir!**</mark> Ses dosyaları dizisi oluşturulurken "" tırnak işaretleri çıkarılabilir

**Parametre açıklaması:** \ <mark style="color:kırmızı;">**!**</mark>**&#x20;Ses bağlantısı** - .OGG biçimindeki bir ses dosyasına bağlantı\
**caption** — açıklama (en fazla 1024 karakter) \
**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik   [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Örnek</summary>

Yukarıda belirtildiği gibi, işlev .OGG dosyalarıyla çalışır. Bu nedenle, ilk görev bu biçimde bir ses kaydı elde etmektir. \
Eğer bir **.**&#x4D;P3 dosyanız varsa, onu **.**&#x4F;GG’ye dönüştürebilirsiniz <https://t.me/mp3toolsbot> botunu kullanarak.&#x20;

Sonra, ortaya çıkan dosyayı botta kendinize gönderin ve şu algoritmayı izleyerek file\_id alın [burada açıklanmıştır. ](#documents-an-example-of-how-to-send-using-the-telegram-api)

Şimdi işlevi bir araya getirelim:

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

Harika! Aferin!

</details>

<details>

<summary>Kopyalama örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")
```

</details>

<details>

<summary>Sesli mesaj gönderirken hata</summary>

Bir mesaj gizlilik ayarları nedeniyle gönderilemezse, aşağıdaki hata döndürülür:

<mark style="color:kırmızı;">{"ok":false,"error\_code":400,"description":"Bad Request: user restricted receiving of voice messages"}</mark>

Hatanın nedeni: kullanıcının gizlilik ayarlarında “Sesli mesaj almayın” seçeneği vardır (herkesten ya da yalnızca belirli kullanıcılardan izin verilmiş olabilir):

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

Kullanıcı bu gizlilik kısıtlamasını devre dışı bıraksın bile, hata görünmeye devam eder.

Aslında, kullanıcı zaten izinleri etkinleştirmiş olsa bile, bu hatayı aşmanın tek yolu istemciyi Mavibot veritabanından tamamen kaldırmaktır.

<mark style="color:yeşil;">**Çözüm:**</mark>&#x20;

Kullanıcı gizlilik ayarlarını değiştirdikten sonra, 30–60 saniyelik bir bekleme yapmanız gerekir (mesajlaşma sunucuları değişiklikleri işleyene kadar) ve yalnızca bundan sonra bot aracılığıyla Telegram’a bir API isteği göndermelisiniz:\ <mark style="color:yeşil;">**<https://api.telegram.org/bot\\><TOKEN>/getChat?chat\_id=#{platform\_id}**</mark>

Bundan sonra kullanıcı verileri yenilenecek ve sesli mesajlar doğru şekilde gönderilecektir.

</details>

## Animasyonlar nasıl gönderilir

<details>

<summary>Animasyon gönder <strong>tg_send_animation()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> Bu işlev, sesi olmayan GIF veya H.264/MPEG-4 AVC video dosyalarının maksimum 2 GB boyutunda gönderilmesine olanak tanır.

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>

**tg\_send\_animation(platform\_id, animation, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities, show\_caption\_above\_media)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği. [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;animation**- animasyona bağlantı. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md)&#x20;

**caption** - açıklama en fazla 1024 karakter

**reply\_markup** — düğme yapılandırması [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik  [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)**.** Olası değerler: html, markdown, markdownV2

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**has\_spoiler** — spoiler’ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın.

**disable\_notification** — mesajı bildirimli veya bildirimsiz gönderme bayrağı (varsayılan: 0).  1 — bildirim olmadan gönder, 0 — bildirimle gönder

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)\
\
**entities** — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg\_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.&#x20;

**show\_caption\_above\_media** - True olarak ayarlanırsa, mesaj açıklaması medyanın üzerinde gösterilir\
\
Parametre geçirme örneği:\
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Örnek</summary>

İşi biraz zorlaştırıp kopyalama ve spoiler korumalı bir animasyon gönderelim.

Her zaman olduğu gibi süreç, seçilen animasyon için dahili Telegram bağlantısını elde etmekle başlar (ayrıntılar [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram.md)).

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

Son olarak, işlevi bir araya getirelim:

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

Ve çalışmanın sonucuna bakalım:

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Mutlu Yıllar!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)
```

</details>

## Videolar nasıl gönderilir

<details>

<summary>Telegram API kullanarak video gönder <strong>tg_send_video()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> Bu işlev, boyutu 2 GB’a kadar olan MPEG4 dosyalarını göndermenize olanak tanır. \
(Diğer formatlar tg\_send\_document() kullanılarak dosya olarak gönderilebilir)

<mark style="color:varsayılan;background-color:green;">**! Telegram business hesabıyla çalışır**</mark>&#x20;

**tg\_send\_video(platform\_id, video, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities,** show\_caption\_above\_media, cover **)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;video** - video bağlantısı. tg\_request aracılığıyla bağlantıların nasıl alınacağını görmek için [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md)&#x20;

**caption** - açıklama en fazla 1024 karakter

**reply\_markup** — düğme ayarları  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik  [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)**.** Olası değerler: html, markdown, markdownV2.

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

**has\_spoiler** — spoiler’ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)\
\
**entities** — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg\_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.&#x20;

**show\_caption\_above\_media** - True olarak ayarlanırsa, mesaj metni medyanın üzerinde gösterilir.

cover - mesajdaki video kapak görüntüsü. URL’nin tg\_request aracılığıyla alınması [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md). \
\
Parametre geçirme örneği:\
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz[ küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Telegram API kullanarak birden fazla video gönder <strong>tg_send_some_video()</strong></summary>

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>&#x20;

**tg\_send\_some\_video(platform\_id, video\_list, disable\_notification, protect\_content, reply\_to\_message\_id, has\_spoiler, message\_thread\_id)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;video\_list** - video dosyalarından oluşan bir dizi (detaylar aşağıda)&#x20;

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**has\_spoiler** — spoiler biçimlendirmesini etkinleştirir (isteğe bağlı; etkinleştirmek için True olarak ayarlayın)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

**video\_list dizisi oluşturma örneği:** \
'\[\["Video bağlantısı1", "caption", "parse\_mode"], \["Video bağlantısı2"], \["Video bağlantısı3", "caption"]]'

**Tek bir ses örneği oluşturma:** \
\["Video bağlantısı", "caption", "parse\_mode"]&#x20;

<mark style="color:kırmızı;">**Parametrelerin sırası önemlidir!**</mark> Video dosyaları dizisi oluşturulurken "" tırnakları çıkarılabilir

**Parametre açıklaması:** \ <mark style="color:kırmızı;">**!**</mark>**&#x20;Video bağlantısı** — dahili Telegram video URL’si. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md#how-to-get-webhook).\
**caption** — metin başlığı, en fazla 1024 karakter\
**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik  [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)**.** Olası değerler:  html, markdown, markdownV2.

</details>

<details>

<summary>Örnek</summary>

Öyleyse, göndermek istediğimiz dosyanın bağlantısını alarak başlayalım ve ardından gerekli işlev parametrelerini dolduralım:

<div data-with-frame="true"><figure><img src="/files/318a14e60646a15b53b0d395ab1dce0b906b4587" alt="" width="563"><figcaption><p>tg_request aracılığıyla video bağlantısı alma</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5fb3d5892e4d4ed30e9554e80c6183538557e158" alt="" width="563"><figcaption><p>Video gönderme parametresi</p></figcaption></figure></div>

Kontrol ettikten sonra videoyu alırız:

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video
```

</details>

## Yuvarlak video nasıl gönderilir

<details>

<summary>Yuvarlak video gönder <strong>tg_send_video_note()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> 4.0 sürümünden itibaren Telegram, süresi bir dakikaya kadar olan yuvarlak MPEG4 videoların gönderilmesini destekler.

<mark style="color:varsayılan;background-color:green;">**! Telegram business hesabıyla çalışır**</mark>

**tg\_send\_video\_note(platform\_id, video\_note,  reply\_markup, protect\_content, reply\_to\_message\_id, disable\_notification,  message\_thread\_id)** &#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;video\_note** - video bağlantısı. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md) \
**reply\_markup** — düğme ayarları [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**message\_thread\_id** —   konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara ](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)

</details>

<details>

<summary>Örnek</summary>

Eğer kare bir videonuz varsa, onu <https://t.me/roundNoteBot> botunu kullanarak yuvarlak bir videoya dönüştürebilirsiniz:&#x20;

<figure><img src="/files/3a3a18381faa7e78e3002b800a35252c4405bb96" alt=""><figcaption><p>@roundNoteBot aracılığıyla yuvarlak video botu alma (https://t.me/roundNoteBot)</p></figcaption></figure>

Yuvarlak videoyu aldıktan sonra, bağlantıyı almak için onu botta kendinize gönderin (ayrıntılar [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/api/attachment.md)), ve ardından yuvarlak videoyu göndermek için işlevi kurun:

<figure><img src="/files/870426eee4a3be980e2b5351ffc16404a1c97e7c" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

```

</details>

## Konum nasıl gönderilir

<details>

<summary>Coğrafi konum gönder <strong>tg_send_venue()</strong></summary>

<mark style="color:varsayılan;background-color:green;">**! Telegram business hesabıyla çalışır**</mark>&#x20;

**tg\_send\_venue(platform\_id, latitude, longitude, title, address, protect\_content, disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;enlem** — enlem

<mark style="color:kırmızı;">**!**</mark>**&#x20;boylam** — boylam

<mark style="color:kırmızı;">**!**</mark>**&#x20;title** — başlık

<mark style="color:kırmızı;">**!**</mark>**&#x20;address** — adres

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**reply\_markup** — düğme ayarları  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz[ küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Örnek</summary>

Öyleyse, önce yerin koordinatlarını belirleyerek başlayalım. Bunları şu araçla alabilirsiniz:  [Google Haritalar ](https://www.google.com/maps)

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

Sonra, elde edilen koordinatları ondalık derecelerden coğrafi biçime herhangi bir çevrimiçi [koordinat dönüştürücü](https://coordinates-converter.com/en/decimal/51.000000,10.000000?karte=OpenStreetMap\&zoom=8):

<figure><img src="/files/53585068e54b55693e54c918f45f1160db5a9888" alt="" width="375"><figcaption></figcaption></figure>

Şimdi, işlev parametrelerini doldurmaya ve istenen sonucu elde etmeye geçelim:

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

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

```
soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Düşler gerçek olur!", "Paris, Eyfel Kulesi") 
```

</details>

## Kişiler nasıl gönderilir

<details>

<summary>Kişi gönder <strong>tg_send_contact()</strong></summary>

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>

Telegram, adres defterinizden kişileri paylaşmak için hızlı bir yol sunar. Mesajlaşma uygulaması şunları göndermeyi destekler: **vCard** — elektronik bir kartvizit

tg\_send\_contact işlevi, bir telefon numarasını bir adla (veya kuruluş adıyla) göndermeye, ayrıca düğmeler eklemeye ve mesaj için içerik korumasını etkinleştirmeye olanak tanır.

**tg\_send\_contact(platform\_id, phone, first\_name, last\_name, protect\_content, disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

<mark style="color:kırmızı;">**! - gerekli işlev parametresi**</mark>

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;phone** — uluslararası biçimde telefon numarası. Örneğin Rusya için: +7XXXXXXXXXX

<mark style="color:kırmızı;">**!**</mark>**&#x20;first\_name** ve **last\_name** - ad ve soyad&#x20;

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**reply\_markup** — düğme ayarları [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Örnek</summary>

Parametreleri doldurun: telefon numarası, ad ve soyad.

<div data-with-frame="true"><figure><img src="/files/57908b4f4b9cc29371db59d158df1cee55b31366" alt="" width="563"><figcaption><p>Kişi gönderme işlevi için parametreleri doldurma örneği.</p></figcaption></figure></div>

Sonucu kontrol edin:

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

```
soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 
```

</details>

## Sticker nasıl gönderilir

<details>

<summary>Sticker gönder <strong>tg_send_sticker()</strong></summary>

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>

**tg\_send\_sticker(platform\_id, sticker\_id, protect\_content,  disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

Parametreler:&#x20;

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;sticker\_id** - sticker kimliği. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md)&#x20;

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**disable\_notification** — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**reply\_markup** — düğme ayarları [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Örnek</summary>

Sticker göndermek, diğer ekleri göndermekten farklı değildir:\
1\. Dahili Telegram bağlantısını alın (ayrıntılar burada) \
2\. İşlev parametrelerini doldurun\
3\. Bloğu kendinize gönderin ve sonucu kontrol edin

<div data-with-frame="true"><figure><img src="/files/a54d4ad1647e807a3e3c1a2d54cea5ea12e5bd3b" alt="" width="563"><figcaption><p>Sticker gönderiliyor</p></figcaption></figure></div>

Sonuç:

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')
```

</details>

## Fotoğraf nasıl gönderilir

{% hint style="warning" %}

#### **Aşağıdakini anlamak `caption` parametre**

Düğmenin **`caption`** parametresi, bir görüntü için açıklayıcı metin sağlar (örneğin, kısa bir özet veya açıklama). Şöyle çalışır:

* **Tek bir görüntü ile:** eğer bir başlık sağlanırsa, mesaj hem görüntüyü hem de açıklayıcı metni içerir.
* **Birden fazla görüntü ile:** her görüntünün kendi ayrı başlığı olabilir. Bu durumda her görüntü, kendi açıklamasıyla birlikte gönderilir.

**Kullanıcı deneyimi:** başlık metni genellikle kullanıcı görüntüye tıkladığında veya dokunduğunda gösterilir.

> **Ayrıntılı teknik özellikler ve API davranışı için lütfen resmi Telegram belgelerine bakın.**

**Not:** bir video eğitimini takip ediyorsanız, ayarlar ve arayüzler zaman içinde güncellenebileceğinden lütfen adımları dikkatlice inceleyin.
{% endhint %}

<details>

<summary>Fotoğraf gönder <strong>tg_send_photo()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> Fotoğraf 10 MB’tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli aşmamalıdır. Genişlik/yükseklik oranı 20’yi geçmemelidir.

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>

**tg\_send\_photo(platform\_id, photo, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, has\_spoiler, disable\_notification, message\_thread\_id, entities, show\_caption\_above\_media)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;fotoğraf** - görsele bağlantı. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır [burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md).&#x20;

**caption** - açıklama en fazla 1024 karakter

**reply\_markup** — düğme ayarları  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik  [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)

**reply\_to\_message\_id -** Yanıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**has\_spoiler** — spoiler biçimlendirmesini etkinleştirir, etkinleştirmek için True olarak ayarlayın

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)\
\
**entities** — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg\_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.

show\_caption\_above\_media - True olarak ayarlanırsa, mesaj metni medyanın üzerinde gösterilir\
\
Parametre gönderme örneği: \
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`  \
\
Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Birden fazla fotoğraf gönder <strong>tg_send_some_photo()</strong></summary>

<mark style="color:kırmızı;">**!**</mark> Fotoğraf 10 MB’tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli aşmamalıdır. Genişlik/yükseklik oranı 20’yi geçmemelidir.

<mark style="color:varsayılan;background-color:green;">**! Telegram business hesabıyla çalışır**</mark>&#x20;

**tg\_send\_some\_photo(platform\_id, image\_list, disable\_notification=0**, **protect\_content=False, reply\_to\_message\_id=0, has\_spoiler=False,message\_thread\_id)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:kırmızı;">**!**</mark>**&#x20;image\_list** - görüntü dosyaları dizisi  (aşağıda detaylar)&#x20;

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**protect\_content** — içeriği kopyalanmaya karşı koruma bayrağı (isteğe bağlı parametre, etkinleştirmek için değer olarak 1 gönderin)

**reply\_to\_message\_id -**  Yanıt verilecek mesajın kimliği (yani, alıntı)

**has\_spoiler** — spoiler biçimlendirmesini etkinleştirir (isteğe bağlı; etkinleştirmek için True olarak ayarlayın)

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)<br>

**image\_list örneği:**

`'[["Görsel bağlantısı 1", "caption", "parse_mode"], ["Görsel bağlantısı 2"], ["Görsel bağlantısı 3", "caption"]]'`

**Tek bir görüntü için veri örneği:** \
\["Görsel bağlantısı 1", "caption", "parse\_mode"]&#x20;

<mark style="color:kırmızı;">**Parametre sırası önemlidir!**</mark> Görüntü dosyaları dizisi oluşturulurken "" tırnakları çıkarılabilir

**Parametre açıklaması:&#x20;**&#x20;

<mark style="color:kırmızı;">**!**</mark>**&#x20;Görsel bağlantısı 1** - görsel bağlantısı. tg\_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır[ burada](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/webhook.md) &#x20;

**caption** — başlık en fazla 1024 karakter

**parse\_mode** — başlıktaki metin biçimlendirmesi, kalın veya italik [**\*\*\***](/doc/tr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Örnek</summary>

Birden fazla görüntü göndermek için bir işlev örneğine bakalım:

önce bir görüntü dizisi oluşturun

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

Sonra işlev parametrelerini doldurun

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

Bloğu kendinize gönderin ve sonucun tadını çıkarın

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden video için kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)
```

</details>

## Zar nasıl gönderilir

<details>

<summary>Rastgele seçmeli bir emoji gönder (Dice) <strong>tg_send_dice()</strong> </summary>

**tg\_send\_dice(platform\_id, emoji, reply\_markup, disable\_notification, reply\_to\_message\_id, protect\_content, message\_thread\_id)**

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;platform\_id** — mesajın gönderileceği Telegram istemci kimliği [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

**emoji** - gönderilecek emoji. Parametreyi boş bırakırsanız, varsayılan olarak bir zar gönderilir. Hem emojinin kendisini bir dize olarak hem de onu temsil etmek için kullanılan anahtar kelimeyi gönderebilirsiniz

**reply\_markup** — düğme ayarı  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**disable\_notification** — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

**reply\_to\_message\_id -**&#x59;anıt verilecek mesajın kimliği (yani, alıntı)

**protect\_content** — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

**message\_thread\_id** — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz [küçük numara](/doc/tr/chatbot/mesajlasma-uygulamalari/telegram/buttons.md#telegram-web-application-button)&#x20;

&#x20;

**Olası emoji listesi:** \
1\) 'darts' veya '🎯', değerler 1’den 6’ya \
2\) 'dice' veya '🎲', değerler 1’den 6’ya \
3\) 'bowling' veya '🎳', değerler 1’den 6’ya \
4\) 'basketball' veya '🏀', değerler 1’den 5’e  \
5\) 'football' veya '⚽', değerler 1’den 5’e \
6\) 'slots' veya '🎰', değerler 1’den 64’e&#x20;

\
Ayrıca, bir istemci bu emojilerden birini bota gönderirse, puan ve hangi emojinin kullanıldığı hakkında bilgi içeren bir geri çağrı alırsınız.

</details>

<details>

<summary>Örnek</summary>

En basit seçenek, işlevi yalnızca gerekli tek parametreyle çağırmaktır:

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

Bu durumda, istemci bir zar alır:

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

İstemci zarı atarsa (alınan emojiye tıklayarak), bot atılan puan sayısını içeren bir geri çağrı alır:

<div data-with-frame="true"><figure><img src="/files/67fba98ab257605f65d349896a96fc68e12c64b0" alt="" width="553"><figcaption></figcaption></figure></div>

Bu işlevle deney yapabilirsiniz. Örneğin, bir slot makinesi oluşturalım ve bir **Puanlar** düğmesi ekleyelim. Düğmeye basıldığında, istemcinin toplam puanlarını alacağız:

<div data-with-frame="true"><figure><img src="/files/eed73be1609b3eec2bc29da9535c71a2ab294a02" alt="" width="563"><figcaption><p><strong>İlk mesaj:</strong> Oynamayı teklif et</p></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e02acf182b1a041dde3c86b84e20854c9930ad11" alt="" width="563"><figcaption><p>Bot örneği</p></figcaption></figure></div>

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

İlk örnek:

```
soob=tg_send_dice(platform_id)
```

İkinci örnek:

<pre><code>/* İlk örnek */
<strong>tg_send_message(platform_id,'Şansınızı denemek için slot makinesine tıklayın!')
</strong>opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* İkinci blok - Metin Mesajı */
<strong> #{res[1]} puan atıldı
</strong><strong>/* İkinci blok - Hesap makinesi */
</strong>res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Üçüncü blok - Metin Mesajı */
Toplam #{balls} puanınız var
</code></pre>

</details>

## Bir medya grubu nasıl gönderilir

<details>

<summary>Medya grubu gönder tg_send_media_group()</summary>

<mark style="color:varsayılan;background-color:green;">**! Telegram işletme hesabıyla çalışır**</mark>

Bir grup fotoğraf, video, belge veya ses dosyasını albüm olarak gönderme yöntemi. Başarılı olursa, gönderilen dosyaların bir dizisi döndürülür.

<mark style="color:turuncu;">**Not: belgeler ve ses dosyaları diğer dosya türleriyle birlikte gruplanamaz!**</mark>

tg\_send\_media\_group(platform\_id, media\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)

Parametreler:

<mark style="color:kırmızı;">!</mark> platform\_id — mesajın gönderileceği Telegram istemci kimliği

<mark style="color:kırmızı;">!</mark> media\_list - 2 ila 10 arasında fotoğraf, video, belge veya ses dosyası içeren bir dizi (detaylar aşağıda);

disable\_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).   \
1 — bildirim olmadan gönder, 0 — bildirimle gönder

protect\_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

reply\_to\_message\_id - yanıtlanacak mesajın kimliği (yani, alıntı)

message\_thread\_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir);

**media\_list dizisinin öğelerinin içeriği:**

<mark style="color:kırmızı;">!</mark> type - dosya türü, “photo”, “video”, “audio” veya ”document”

<mark style="color:kırmızı;">!</mark> media - gönderilecek dosya. Telegram sunucularında zaten bulunan bir dosyayı göndermek için bir file\_id gönderin (önerilir), dosyayı internetten almak için bir HTTP URL’si veya yeni bir dosya yüklemek için multipart/form-data ile \<file\_attach\_name> adını kullanarak «attach://\<file\_attach\_name>».

Daha fazlasını okuyun: <https://core.telegram.org/bots/api#sending-files>

caption — gönderilen dosyanın başlığı, 0–1024 karakter.

parse\_mode — başlıktaki metin biçimlendirmesi, kalın veya italik

Daha fazlasını okuyun: <https://core.telegram.org/bots/api#sending-files>

media\_list dizisi örneği:

\[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p\_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "ghosts video"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P\_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “hare video”}]

</details>

<details>

<summary>Örnek</summary>

Birden fazla görüntü göndermek için bir işlev örneğine bakalım:

önce bir görüntü dizisi oluşturun

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

Sonra işlev parametrelerini doldurun

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

Bloğu kendinize gönderin ve sonucun tadını çıkarın

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

</details>

<details>

<summary>Kopyalanacak kod örneği</summary>

<mark style="color:kırmızı;">Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden video için kendi bağlantılarınızı oluşturduğunuzdan emin olun</mark>

```
image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)
```

</details>

## Büyük dosya ekleri nasıl gönderilir

<details>

<summary>Örnek</summary>

Telegram’da (hem işletme hesapları hem de normal hesaplar için), ekleri bir bağlantı aracılığıyla gönderebilirsiniz:

1. Her boyutta eki, dosya boyutu sınırlarını aşarak gönderebilirsiniz.
2. İhtiyacınız olan herhangi bir tür eki de gönderebilirsiniz.

Nasıl yapılır:

Zaten herkese açık erişimi olan bir eke ait bağlantıyı kopyalayın:

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

Ardından, kopyalanan bağlantıyı bloğunuzdaki ek işlevine yapıştırın:

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

Bitti. Bu şekilde, herhangi bir tür ve boyutta eki gönderebilirsiniz.

</details>


---

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