# Butonlar ve ekler

## Butonlarla nasıl çalışılır

{% hint style="info" %}
Instagram, satır içi ve yanıt butonlarının aynı anda gönderilmesini desteklemez
{% endhint %}

### Klavye **(yanıt)**

Instagram en fazla 11 yanıt butonunu destekler. Butonlar yalnızca tek sıra halinde düzenlenebilir

Örnek:

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

Sonuç:

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

### Metin içinde (satır içi)

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

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

{% hint style="danger" %}
Instagram en fazla 3 satır içi butonu destekler
{% endhint %}

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

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

Butonlar üçüncü taraf kaynaklara bağlantı verebilir. Görsel olarak bu butonlar aynıdır.

Butonları yapılandırma talimatları için şu bölüme bakın: **Düğmeler** bölümünde görünecektir.

## Eklerle nasıl çalışılır

Mesajda ek gönderebilirsiniz. Hangi eklerin desteklendiği ve bunların nasıl ekleneceği hakkında daha fazla bilgi için dokümantasyondaki [Ek gönderme](/doc/tr/chatbot/builder/attachments/tab.md) bölümüne bakın.

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

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

{% hint style="warning" %}
Ekleri bir bloğa dosya olarak yükleyebilir veya dosyaya bir bağlantı sağlayarak ekleyebilirsiniz.

Yüklenen video dosyaları 20 MB'ı aşmamalı, ses ve görüntü dosyaları ise 5 MB'tan büyük olmamalıdır.
{% endhint %}

**Ek gereksinimleri:**

| Medya dosyası türü | Desteklenen format | Maksimum boyut |
| ------------------ | ------------------ | -------------- |
| Ses                | M4A                | 5 MB           |
| Görsel             | JPEG, PNG          | 5 MB           |
| Video              | MP4                | 20 MB          |

{% hint style="warning" %}
Bu **NOT** ses ekleri için MP4 formatının kullanılması önerilir. Ayrıca, **MP3 formatında hiçbir ses gönderilmeyecektir**.
{% endhint %}

## Carousel nasıl oluşturulur

Carousel 2 ila 10 kart (slayt) içerebilir.

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

Örnek olarak 3 kartlı bir carousel kullanalım. Kartları oluşturmak için aşağıdakileri şu alana girmeniz gerekir: **Hesaplayıcıda** alanını bulun:

p = \[{"title":"BAŞLIK", "description": "GÖRSEL AÇIKLAMASI 1", "image": "GÖRSELE BAĞLANTI 1", "buttons":\[{"text":"BUTON METNİ 1"}]},{"title":"BAŞLIK", "description": "KART AÇIKLAMASI 2", "image": "GÖRSELE BAĞLANTI 2", "buttons":\[{"text":"BUTON METNİ 2"}]}, {"title":"BAŞLIK", "description": "KART AÇIKLAMASI 3", "image": " GÖRSELE BAĞLANTI 3", "buttons":\[{"text":"BUTON METNİ 3"}]}]                                              &#x20;

r = send\_carousel(p, '')

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

Bağlantıyı kopyalayın:

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

Sonuç:

<div data-with-frame="true"><figure><img src="/files/0fb960951abbeb12917c1a0f4b6a3b7cba96f36e" alt="" width="383"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Lütfen dikkat: `r = send_carousel(p, '')` ifadesi Hesaplayıcıda yeni bir satırda başlamalıdır.
{% endhint %}

Bu, başlık, açıklama, görsel ve butonları içeren bir dizi tanımlamanız ve bunu bir değişkene atamanız gerektiği anlamına gelir `p` (isterseniz değişkenin adını farklı verebilirsiniz). Ardından bu değişkeni şu alanda kullanın: `send_carousel(p, "")` yöntemini kullanarak çıkarabilirsiniz.

Şunu bırakır `#{None}` alanına **"Yanıt"** alanına yapıştırın.

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

{% hint style="info" %}
Carousel kartlarındaki butonlara bağlantı ekleyebilirsiniz. Kullanıcı butona tıkladığında bağlantıya yönlendirilir.
{% endhint %}

Karta bir butona bağlantı eklemek için bunu dizinin içine ekleyin:

p = \[{"title":"başlık", "description": "KART AÇIKLAMASI 1", "image": "GÖRSELE BAĞLANTI 1", "buttons":\[{"text":"BUTON METNİ 1", "url":"BUTON İÇİN BAĞLANTI" }]}]

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

{% hint style="info" %}
Bir diğer isteğe bağlı parametre, `payload`carousel kartı butonlarına eklendi. Bu, müşteriye gösterilmez ancak müşterinin seçimini analiz etmenize olanak tanır.
{% endhint %}

Carousel kartları çoğu zaman aynı metne sahip butonlar gerektirdiğinden, ek bir `payload` parametresi getirildi. Bu parametre müşteriye görünmez ancak seçimini analiz etmenizi sağlar.

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

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

Doğru kullanımına dikkat edin:

p = \[{"title":"başlık", "description": "KART AÇIKLAMASI 1", "image": " 1", "buttons":\[{"text":"BUTON METNİ 1","payload":"1"}]},{"title":"başlık", "description": "KART AÇIKLAMASI 2", "image": "GÖRSELE BAĞLANTI 2", "buttons":\[{"text":"BUTON METNİ 1","payload":"2"}]}, {"title":"başlık", "description": "KART AÇIKLAMASI 3", "image": "GÖRSELE BAĞLANTI 3", "buttons":\[{"text":"BUTON METNİ 1"}]}]

Düğmenin `payload` parametresi, yukarıdaki Şekilde gösterildiği gibi atlanabilir.

## Tanıtım ifadeleri nasıl ayarlanır

Tanıtım ifadeleri, bir kişinin sık sorulan istekler listesini kullanarak bir şirketle sohbet başlatmasına olanak tanır. En fazla dört istek ayarlayabilirsiniz.

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

Tanıtım ifadelerini ayarlamak için bağlı Instagram hesabında "Kanallar" bölümündeki bir kaydırıcıyı etkinleştirmeniz gerekir.

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

Bu kaydırıcıya tıkladıktan sonra, gerekli tanıtım ifadelerini ayarlayabileceğiniz bir açılır pencere görünür.

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

Ardından şu adımları izleyin:

1. Funnelnizde belirli ifadelere yanıtlar ayarlayın.
2. Gerekli blokları "Başlangıç" durumuna yerleştirin.
3. Tanıtım ifadesi metnini tetikleyiciye girin.

{% hint style="warning" %}

#### Lütfen dikkat edin!&#x20;

Tanıtım ifadeleri, daha önce Instagram hesabınızla iletişime geçmemiş kullanıcılar için görünür (veya önceki tüm sohbet geçmişi silinmişse).
{% endhint %}

## Direct'te anahtar kelime yanıtı ayarlayın

Direct Mesajlarda müşterilere anahtar kelimelere göre yanıt vermek için, bir Tetikleyici içeren bir blok (Başlangıç ve Tetikleyici blokları) kullanabilir ve botunuzun yanıt vermesini istediğiniz kelimeleri Tetikleyici alanına girebilirsiniz:

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

Eşleşme seçimi, anahtar kelimelerin varlığına veya Tam eşleşmeye (önerilen seçenekler) dayanır.

içinde **"Mesaj metni"** alanına, kullanıcının alacağı bot yanıtını girin. Ekler, düğmeler ve bağlantılar da ekleyebilirsiniz.

## **Bir kullanıcının hesabınıza abone olup olmadığını nasıl kontrol edersiniz**

Bunu yapmak için iki yöntem **kontrol etmek** abonelik durumunu:

1\. Hesaplayıcıyı kullanarak aboneliği kontrol etme

**result = check\_insta\_subscription()**

`fonksiyonun` değişken adı olup **kontrol etmek** sonucun saklanacağı yerdir (gerekirse yeniden adlandırabilirsiniz).

Fonksiyon şunu döndürür:

* **`True`** kullanıcı abone ise.
* **`False`** kullanıcı abone değilse.

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

Kontrol, **"Değişken"** alanında, hem okta hem de blokta yapılmalıdır.

* `result == True` – ifadesi, **"Değişken"** alanında müşterinin hesaba abone olması durumunda kullanılır.
* `result == False` – müşteri abone değilse kullanılan ifadedir.

Başka karşılaştırma ifadeleri de kullanabilirsiniz, örneğin:\
`result != False` (result, False'a eşit değil; yani kullanıcı hesaba abonedir).

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

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

2. Müşteri kartı doğrulama verileri

Bir kullanıcı botla etkileşime girdiğinde, `follow` ve `followers` değişkenleri müşteri kartında görüntülenir ve doğrulanır ( **Müşteri Değişkenleri** alt bölümünde).

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

**`follow` variable** – abonelik durumunu doğrular. Şu değeri alır: `True` müşteri hesaba abone ise, `False` abone değilse ve `None` müşterinin hesabı kapalıysa.

**`verified`** – kullanıcının doğrulanmış bir hesabı (mavi onay işareti) olup olmadığını gösterir. Şu değerdedir: `True` doğrulanmışsa ve `False` aksi halde.

**`followers`** – müşterinin sahip olduğu abone/takipçi sayısını gösterir.

Abonelik durumunu kontrol etmek veya funnel ilerlemesini kısıtlamak için, **`follow`** değişkenini koşul bloklarında veya ok bağlantılarında, **"Değişken"** alanına yapıştırın.

Örnek:

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

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

içinde **Tetikleyici** alanında funnel'ınızı başlatacak herhangi bir kelime girin.

içinde **karşılaştırma için değişken**, şöyle yazın:\
`follow == True`\
VEYA\
`follow != False`

* İlk durumda, kişinin hesabınıza abone olup olmadığını kontrol edersiniz.
* İkinci durumda, kişinin **yapılmaz** hesabınıza abone olup olmadığını kontrol edersiniz.

{% hint style="warning" %}
Lütfen `True` ve `False` durumların büyük harfle yazılması gerektiğini unutmayın. Aksi halde kontrol düzgün çalışmaz.
{% endhint %}

Abonelik durumuna göre farklı mesajlar iletmek için, zıt koşullara sahip iki blok oluşturmanız gerekir. Daha düzenli bir yaklaşım tercih ediyorsanız, koşulları bunun yerine bağlantılar (oklar) üzerinde tanımlamanızı öneririz.

**Bağlantılardaki tetikleyiciler:**

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

Tetikleyiciyi okun **"Değişken"** satırına girin:\
`follow == True` veya `follow != False`

Tetikleyici koşulu karşılanırsa, müşteri funnel'da daha ileriye gider.

Müşteri abone değilse, doğrulama koşullarının karşılanmadığı bloğa gider (`follow == False` veya `follow != True`).

Kontrolün dinamik olmasını istiyorsanız, bir buton eklemenizi öneririz—örneğin, **"Abone oldum"**—böylece kontrol gerçekleştirilebilir ve kişi bir sonraki aşamaya geçebilir.

{% hint style="danger" %}

#### Dikkat

Kapalı bir ok üzerinde butonsuz bir zamanlayıcı ayarlamanızı **NOT** öneririz, çünkü kişi sürekli mesaj alır ve mesaj limitinizi hızla tüketir.
{% 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/instagram/buttons.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.