# Bot kullanımı

## Telegram bot açıklamasıyla (tam ve kısa) nasıl çalışılır

### Karşılama mesajını yapılandırmak için

**tg\_set\_bot\_description(description, language\_code)** - botla yapılan sohbet boşken gösterilen bot açıklaması

Parametreler:

<table><thead><tr><th width="315.25">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>description</strong></td><td>Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldırır.</td></tr><tr><td><strong>language_code</strong></td><td><p>Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.</p><p></p><p>Boş bırakılırsa, kısa açıklama kısa açıklaması olmayan tüm kullanıcılara uygulanır.</p></td></tr></tbody></table>

<details>

<summary>Örnek</summary>

Karşılama mesajı ve bot menüsünü yapılandırma örneği:

<div data-with-frame="true"><figure><img src="/files/df8d11df13cce33d6cc9dd3182c2c1a36e1d95e1" alt="" width="563"><figcaption><p>MaviBot'ta bir bloğu yapılandırma: komutları ve açıklamaları ayarlamak için işlevleri kullanma</p></figcaption></figure></div>

Başlatmadan sonra (bu, bir yönetici komutu kullanılarak bir kez yapılmalıdır):

<div data-with-frame="true"><figure><img src="/files/45d091b9f9c8703e51fc15c4b9aa4e39139241ac" alt="" width="375"><figcaption><p>Karşılama mesajı ve bot menüsü</p></figcaption></figure></div>

Kopyalamak için kod örneği:

`tg_set_bot_description('Hoş geldiniz! Ben sanal asistanınız Yurgram.🤖') command = [["private_office", "Kişisel Hesap"]] tg_set_command(command, '', 'default')`

</details>

### Kısa önizleme açıklamasını yapılandırmak için

**tg\_set\_bot\_short\_description(description, language\_code)** - botun profil sayfasında görünen ve kullanıcılar botu paylaştığında bağlantıyla birlikte gönderilen botun kısa açıklaması.

Parametreler:

<table><thead><tr><th width="315.25">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>description</strong></td><td>Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldırır.</td></tr><tr><td><strong>language_code</strong></td><td><p>Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.</p><p></p><p>Boş bırakılırsa, kısa açıklama kısa açıklaması olmayan tüm kullanıcılara uygulanır.</p></td></tr></tbody></table>

### Mevcut açıklamayı almak için

**tg\_get\_bot\_description(language\_code)** - belirtilen kullanıcı dili için mevcut bot açıklamasını almak için bu yöntemi kullanın.

<table><thead><tr><th width="315.25">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>language_code</strong></td><td><p>Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.</p><p></p><p>Boş bırakılırsa, kısa açıklama kısa açıklaması olmayan tüm kullanıcılara uygulanır.</p></td></tr></tbody></table>

### Mevcut kısa açıklamayı almak için

**tg\_get\_bot\_short\_description(language\_code)** - belirtilen kullanıcı dili için botun mevcut kısa açıklamasını almak için bu yöntemi kullanın.

<table><thead><tr><th width="315.25">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>language_code</strong></td><td><p>Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.</p><p></p><p>Boş bırakılırsa, kısa açıklama kısa açıklaması olmayan tüm kullanıcılara uygulanır.</p></td></tr></tbody></table>

## Bot için komutlar nasıl yapılandırılır

### Komutları yapılandırmak için

**`tg_set_command(commands, language, scope, platform_id, user_id)`**

<table><thead><tr><th width="239.27734375">Parametre </th><th>Açıklama</th></tr></thead><tbody><tr><td><mark style="color:kırmızı;"><strong>!</strong></mark><strong> commands</strong></td><td><p>Komutlar, liste listesi biçiminde bot komutlarıdır; her iç liste 2 öğeden oluşur:
<br></p><p>1 – komut adı, 2 – açıklaması (100 komut sınırı vardır).</p></td></tr><tr><td><strong>language</strong></td><td><p>ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en'.</p><p></p><p>Belirtilmezse, komutlar dili için özel olarak atanmış komutları olmayan tüm kullanıcılara uygulanır.</p></td></tr><tr><td><strong>scope</strong></td><td>Komutların oluşturulacağı kullanıcı kapsamını tanımlayan bir parametre. Varsayılan değer <em><strong>'default'</strong></em>.</td></tr><tr><td><strong>platform_id</strong></td><td><p>Telegram içindeki sohbet kimliği <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>. </p><p></p><p>Yalnızca <strong>scope</strong> parametresinin belirli değerleri için geçerlidir.</p></td></tr><tr><td><strong>user_id</strong></td><td><p>Telegram içindeki kullanıcı kimliği <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>. </p><p></p><p>Yalnızca <strong>scope</strong> parametresinin belirli değerleri için geçerlidir.</p></td></tr></tbody></table>

<details>

<summary>Örnek</summary>

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

**command = \[\["count", "kullanıcının sayısını döndür"],\["unpin", "tüm mesajların sabitlemesini kaldır"]] tg\_set\_command(command, '', 'all\_chat\_administrators')**

Bu örnekte komutlar ayrı bir değişkende tutulur. Bu komutları doğrudan işlevin içine de ekleyebilirsiniz.

**tg\_set\_command('\[\["count", "kullanıcının sayısını döndür"],\["unpin", "tüm mesajların sabitlemesini kaldır"]]', '', 'all\_chat\_administrators')**

{% hint style="warning" %}
Komutları çağırmak için mesaj giriş alanına '/' simgesini yazın. Her şey doğru şekilde yapılandırıldıysa, kullanılabilir komutların bir öneri listesini göreceksiniz. Komutlar kalın olarak görünecek, açıklamaları ise sağ tarafta gösterilecektir.
{% endhint %}

Komutları kullanmak için, komut içeren mesajlara bir tepki yapılandırın.

</details>

## **Bot için komutlar nasıl görüntülenir**

### **tg\_get\_command()** &#x20;

<mark style="color:varsayılan;background-color:blue;">**Komutları görüntülemek için**</mark>

**`tg_get_command(language, scope, platform_id, user_id)`**

<table><thead><tr><th width="262.8671875">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>language</strong></td><td>ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en'.
<br>Belirtilmezse, belirli diline özel komutları olmayan ve verilen alan içindeki tüm kullanıcılara uygulanan komutlar gösterilir.</td></tr><tr><td><strong>scope</strong></td><td>Komutların hangi kullanıcı kapsamı için gösterileceğini tanımlayan bir parametre (isteğe bağlı parametre; kullanılmazsa, varsayılan değer <em><strong>'default'</strong></em> uygulanır).</td></tr><tr><td><strong>platform_id</strong> </td><td><p>Telegram içindeki sohbet kimliği <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>. <br></p><p>Yalnızca <strong>scope</strong> parametresinin belirli değerleri için geçerlidir.</p></td></tr><tr><td><strong>user_id</strong></td><td><p>Telegram içindeki kullanıcı kimliği <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a>. <br></p><p>Yalnızca <strong>scope</strong> parametresi.</p></td></tr></tbody></table>

{% hint style="info" %}
Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, ilk parametreyi boş olarak belirttiğinizden emin olun, örnekte olduğu gibi:

**tg\_get\_command('', scope)**
{% endhint %}

<details>

<summary>Örnek</summary>

***command = tg\_get\_command('', 'all\_chat\_administrators')***

Bu işlevi bir değişkene atayın; değişken, parametrede belirtilen kullanıcı kapsamı için komutlarla birlikte sunucunun yanıtını içerecektir.

***{"ok":true,"result":\[{"command":"count","description":"kullanıcının sayısını döndür"},{"command":"unpin","description":"tüm mesajların sabitlemesini kaldır"}]}***

İşlev parametresiz çağrılırsa, scope şu değere ayarlanır: ***'default'***.

***command = tg\_get\_command()***

</details>

## **Botta komutlar nasıl silinir**

### **tg\_delete\_command()**

<mark style="color:varsayılan;background-color:blue;">**Komutları silmek için**</mark>

**tg\_delete\_command(language, scope, platform\_id, user\_id),** burada

<table><thead><tr><th width="308.98828125">Parametre</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>language</strong></td><td>ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en' (isteğe bağlı parametre; belirtilmezse, verilen kapsam içindeki ve dilleri için özel komutları olmayan tüm kullanıcılara uygulanan komutlar silinir).</td></tr><tr><td><strong>scope</strong></td><td>Komutların silineceği kullanıcı kapsamını tanımlayan bir parametre.
<br>Belirtilmezse, varsayılan değer <em><strong>'default'</strong></em> uygulanır.</td></tr><tr><td><strong>platform_id</strong></td><td>Sohbet kimliği (isteğe bağlı parametre, yalnızca scope parametresinin belirli değerleri için geçerlidir).</td></tr><tr><td><strong>user_id</strong></td><td>Kullanıcı kimliği (isteğe bağlı parametre, yalnızca scope parametresinin belirli değerleri için geçerlidir).</td></tr></tbody></table>

{% hint style="info" %}
Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, ilk parametre için boş bir değer belirttiğinizden emin olun, örnekte olduğu gibi:

**tg\_delete\_command('', scope)**
{% endhint %}

{% hint style="info" %}
tg\_delete\_command() gibi bir komut, varsayılan kapsam değerini kullanarak dil parametresini belirtmeden komutları siler.
{% endhint %}

<details>

<summary>Örnek</summary>

Hesap makinesinde parametrelerle işlevi çağırarak ayarlanan komutları silebilirsiniz:

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

**Kopyalamak için kod örneği:**

**`tg_delete_command('', 'all_chat_administrators')`**

</details>

## Komutlara tepkiler nasıl yapılandırılır

Botla özel sohbetteki komutlar için şu tür mesajlara tepki vermeniz gerekir: **'/command\_name'** – burada **command\_name** komuttur.

Gruplar ve sohbetlerde, mesajlar şu şekilde görünür: **'/command\_name\@bot\_username'** – burada **command\_name** komut ve **@bot\_username** botun kullanıcı adıdır.

**Kapsam değerleri listesi:**

<table><thead><tr><th width="214.984375">Parametre</th><th>Değer</th></tr></thead><tbody><tr><td><strong>'default'</strong></td><td>Varsayılan parametre, komutların botla olan özel mesajlarda çalışacağı anlamına gelir.</td></tr><tr><td><strong>'all_private_chats'</strong></td><td>Tüm özel sohbetler: komutlar, botun eklendiği özel sohbetlerde herkes için kullanılabilir.</td></tr><tr><td><strong>'all_group_chats'</strong></td><td>Tüm grup ve süper grup sohbetleri: komutlar, botun eklendiği bu tür sohbetlerde herkes için kullanılabilir.</td></tr><tr><td><strong>'all_chat_administrators'</strong> </td><td>Botun eklendiği tüm grup ve süper grup sohbetlerinin yöneticileri için komutlar.</td></tr><tr><td><strong>'chat'</strong></td><td>Belirli bir sohbet için komutlar (bu seçeneği seçerseniz, belirtmeniz gerekir <strong>platform_id</strong>).</td></tr><tr><td><strong>'chat_administrators'</strong></td><td>Belirli bir sohbetin yöneticileri için komutlar (bu seçeneği seçerseniz, belirtmeniz gerekir <strong>platform_id</strong>).</td></tr><tr><td><strong>'chat_member'</strong></td><td>Belirli bir sohbetin belirli bir üyesi için komutlar (bu seçeneği seçerseniz, her ikisini de belirtmeniz gerekir <strong>platform_id</strong> ve <strong>user_id</strong>; belirtilen kullanıcı, verilen sohbetin bir üyesi olmalıdır).</td></tr></tbody></table>

{% hint style="info" %}
Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, ilk parametre için boş bir değer belirttiğinizden emin olun, örnekte olduğu gibi:

**tg\_delete\_command('', scope)**
{% 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/api/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.