# Bağlantılarla çalışma

## Tıklama bildirimi olan bağlantılar <a href="#dlya-raboty-s-ssylkami" id="dlya-raboty-s-ssylkami"></a>

proxy() | proxy\_date() | proxy\_timeout()

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

<mark style="color:kırmızı;">**!**</mark> - Gerekli parametreler

**proxy(lnk, one-shot)** - tıklama bildirimi olan bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** -bağlantı \
**tek kullanımlık** -bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 değerini iletin.

**proxy\_date(lnk, date, time)** - tıklama bildirimi ve belirtilen bir son kullanma süresi olan bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** - bağlantı\ <mark style="color:kırmızı;">!</mark> **date** - bağlantının son kullanma tarihi \ <mark style="color:kırmızı;">!</mark> **time** - bağlantının son kullanma saati\
**tek kullanımlık** - bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 iletin.

**proxy\_timeout(lnk, minutes, one-shot)** - tıklama bildirimi ve belirtilen bir erişim zamanlayıcısı olan bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** - bağlantı\ <mark style="color:kırmızı;">!</mark> **minutes** - bağlantının etkin kalacağı dakika sayısı.\
**tek kullanımlık** - bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 iletin.

<details>

<summary>Örnek</summary>

Basit bir örneğe bakalım:

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

İki proxy bağlantısı oluşturduk ve bunları düğmelere ve mesaj metnine yerleştirdik. Telegram'da test ettiğimiz için, Markdown kullanarak bağlantıların nasıl doğru biçimde biçimlendirileceğini hatırlamak için iyi bir fırsat. Özel karakterleri işlemek için tg\_escape() fonksiyonunu kullandık.

Müşteri bunları örneğin Telegram'da şöyle görür:

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

Müşteri bağlantıya tıkladığında, bir geri çağrı alırız:

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

Bu etkinlik için bir yanıt yapılandıralım:

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

Şimdi, bağlantı kaldırma işlevlerini test edelim:

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

Böylece, müşteri tek kullanımlık bağlantıyı silindikten sonra kullanmaya çalışırsa, bağlantı artık mevcut olmadığından bir hata alacaktır.

Süre sınırlı bağlantıyı silelim:

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

Fonksiyon çalıştırıldıktan sonra, müşteri kartında hiçbir proxy bağlantısı kalmaz ve bağlantıyı takip etmeye yönelik herhangi bir girişim aynı hatayı döndürür.

</details>

<details>

<summary>Kopyalama için kod örneği</summary>

"Mesaj" alanı için kod örneği (açmayı unutmayın **Markdown** Telegram ile çalışıyorsanız):

```
*Bağlantıları test et:*
[Tıkla](#{link3})
```

veya aşağıdaki çıktı biçimini kullanarak test edin:

<pre><code><strong>Bağlantıları test et:
</strong>#{link2}
</code></pre>

"Hesaplayıcı" alanı için kod örneği:&#x20;

```
link1=proxy('https://mavibot.ai/', 1) 
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm') 
link3=tg_escape(link2)
```

</details>

{% hint style="info" %}
Bir müşteri bir proxy bağlantısına tıkladığında, şu biçimde bir geri çağrı alırsınız **link\_was\_pressed** . Bu, bağlantı tıklamasına bir tepki yapılandırmanıza olanak tanır.

Bunu yapmak için, alınan geri çağrıyı "Koşul" alanına girin ve eşleşme türünü Tam Eşleşme olarak ayarlayın.
{% endhint %}

## Bağlantı kısaltma

short() | short\_date() | short\_timeout()

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

<mark style="color:kırmızı;">**!**</mark> - Gerekli parametreler

**short(lnk, one-shot)** - tıklama bildirimi olmadan bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** -bağlantı \
**tek kullanımlık** -bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 değerini iletin.

**short\_date(lnk, date, time)** - tıklama bildirimi olmadan ve belirtilen bir son kullanma süresiyle bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** - bağlantı\ <mark style="color:kırmızı;">!</mark> **date** - bağlantının son kullanma tarihi \ <mark style="color:kırmızı;">!</mark> **time** - bağlantının son kullanma saati\
**tek kullanımlık** - bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 iletin.

**short\_timeout(lnk, minutes, one-shot)** - tıklama bildirimi olmadan ve belirtilen bir erişim zamanlayıcısıyla bir bağlantı oluşturur. Fonksiyon aşağıdaki parametreleri alır:\ <mark style="color:kırmızı;">!</mark> **bağlantısı** - bağlantı\ <mark style="color:kırmızı;">!</mark> **minutes** - bağlantının etkin kalacağı dakika sayısı.\
**tek kullanımlık** - bağlantının tek kullanımlık olduğunu gösteren belirteç. Sadece 1 iletin.

## **Bağlantı kaldırma**

remove\_links() | remove\_one\_time\_links()| remove\_timer\_links()

<mark style="color:kırmızı;">**LEJANT:**</mark>

<mark style="color:kırmızı;">**!**</mark> - Gerekli parametreler

**remove\_links()** - müşteriye gönderilen tüm kısaltılmış bağlantıların devre dışı bırakılması

\
**remove\_one\_time\_links()** - müşteriye gönderilen tüm tek kullanımlık bağlantıların devre dışı bırakılması<br>

**remove\_timer\_links()** - müşteriye gönderilen tüm süre sınırlı bağlantıların devre dışı bırakılması

## Telegram botu bilgi yarışması bağlantısı

quiz\_link\_timeout() | quiz\_link\_date() | quiz\_link()

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

Bağlantının geçerliliği için 21 günlük bir sınır vardır, bu nedenle yenilenmesi gerekir!
{% endhint %}

Telegram'da bilgi yarışması görüntülemeyi etkinleştirmek için şunları yapmanız gerekir:

1\. Bir web sitesi sayfa kimliğini kopyalayın. Bunu yapmak için "Web Siteleri" bölümüne gidin ve istediğiniz web sitesini seçin:

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

Metnin ilerleyen kısmında buna **mini\_landing\_page\_id** değişken adı olarak atıfta bulunacağız.

2\. "Hesaplayıcı" alanında aşağıdaki fonksiyonlardan birini kullanın:

<mark style="color:kırmızı;">**LEJANT:**</mark>

<mark style="color:kırmızı;">**!**</mark> - Gerekli parametreler

**quiz\_link\_timeout(mini\_landing\_page\_id, minutes)  -** dakika cinsinden ayarlanmış bir ömür sınırı olan bir bağlantı oluşturur

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;mini\_landing\_page\_id** - web sitesi sayfa kimliği\
**minutes -** bağlantı ömrü dakika cinsinden (tür: sayı)

**quiz\_link\_date(mini\_landing\_page\_id, date, time) -** belirli bir tarih ve saat ile sınırlı bir son kullanma süresine sahip bir bağlantı oluşturur

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;mini\_landing\_page\_id** - web sitesi sayfa kimliği\
**date** - bağlantının etkin olduğu tarih (format: gg.aa.yyyy)\
**time** - bağlantının etkin olduğu saat (format: ss:dd)

&#x20;**quiz\_link(mini\_landing\_page\_id)** - son kullanma süresi olmayan bir bağlantı oluşturur

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;mini\_landing\_page\_id** - web sitesi sayfa kimliği

<details>

<summary>Örnek</summary>

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

3\. Bir **Telegram Web App** düğmesi ve değişken adını # sembolü ile süslü parantez içinde belirtin.

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

<mark style="color:kırmızı;">**Önemli!**</mark> \
Değişken değerinin gelişmiş ayarlarda doğru şekilde kaydedildiğinden emin olun.

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

Eğer **quiz\_link\_timeout** fonksiyonunu bir müşteriyi bir web sayfasına yönlendirmek için kullanırsanız, sayfa başlığı ve açıklaması içinde müşteri değişkenlerini kullanabilirsiniz. Örneğin, müşterinin değeri "John" olan bir değişkeni varsa ve sayfa açıklaması **name** ile başlıyorsa **"Merhaba #{name}, nasılsın?"**&#xE7;ıktı "Merhaba John, nasılsın?" olur. Ancak, müşteride o değişken yoksa, değer projenin genel değişkenlerinden alınır.

{% hint style="warning" %}
**Not!** Son kullanma süresi olmayan bağlantıları kullanırken dikkatli olun. Bağlantı başka biriyle paylaşılır ve onlar bilgi yarışmasını tamamlarsa, sonuçlar bağlantının ilk oluşturulduğu müşteri altında kaydedilir.
{% endhint %}

</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/functions/hesap-makinesi/links.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.