---
title: "Anahtar kelime eşleşme kuralları"
description: "Bir koşul düğümünün bir yorumu veya ÖM'yi bir anahtar kelime listesine veya yapılandırılmış metne karşı nasıl karşılaştırdığı, boş bir listenin neyle eşleştiği ve her sonucun hangi dalı aldığı."
canonical: https://docs.afp.monster/tr/reference/keyword-matching
updated: 2026-08-19
pageType: reference
---

Bir koşul düğümü, ona ulaşan mesajın metnini o düğümde yapılandırılmış kelimelerle karşılaştırır, sonra çalıştırmayı **Eşleşme**'den (çıktı 0) veya **Eşleşme Yok**'tan (çıktı 1) gönderir. **Anahtar kelime listesi** eşleşme türüyle, bir mesaj listeden en az bir anahtar kelime içerdiğinde eşleşir. Ters eşleşme bu sonucu tersine çevirir ve anahtar kelimesi olmayan — veya silinmiş — bir liste her mesajla eşleşir.

## Özet

| Eşleşme türü | Okuduğu ayarlar | Bir mesaj ne zaman eşleşir |
|---|---|---|
| `any` | yok | Her zaman. Düğüm tek bir çıktı tutar ve her mesaj onu izler |
| `contains` | `text` | Mesaj yapılandırılmış metni içerdiğinde |
| `exact` | `text` | Mesaj yapılandırılmış metnin ta kendisi olduğunda ve başka hiçbir şey olmadığında |
| `keyword_list` | `keyword_list_id`, `reverse_keywords` | Mesaj listeden en az bir anahtar kelime içerdiğinde, veya ters eşleşme açıksa hiçbirini içermediğinde |

## Eşleşme algoritması

1. Koşul, çalıştırmayı başlatan mesajın metnini alır — yorum veya özel mesaj.
2. Bir yanıt beklemeye ayarlanmış bir koşul, herhangi bir şeyi karşılaştırmak yerine çalıştırmayı park eder ve yanıt geldiğinde onun metnini karşılaştırır. Basılan bir düğme metin olarak sayılır: koşulun karşılaştırdığı şey düğmenin etiketidir.
3. Eşleşme türü karşılaştırmaya karar verir. `keyword_list`, kaydedilmiş listeyi tanımlayıcısıyla yükler ve mesajı o listenin anahtar kelimelerine karşı test eder.
4. Ters eşleşme bir `keyword_list` karşılaştırmasının sonucunu tersine çevirir, bu yüzden anahtar kelimelerin hiçbirini içermeyen bir mesaj eşleşir.
5. İçinde anahtar kelime olmayan bir anahtar kelime listesi ve artık var olmayan bir listeye referans, ikisi de hiçbir şeyi karşılaştırmadan bir eşleşme üretir.
6. Sonuç çıktıyı seçer. Eşleşme çıktı 0, Eşleşme Yok çıktı 1'dir ve çalıştırma hangisi bir bağlantı taşıyorsa onu izleyerek devam eder. Bağlantısı olmayan bir çıktı çalıştırmayı koşulda sona erdirir.
7. Aynı düğümdeki medya filtreleri — görüntüler, GIF'ler ve bağlantılar — ayrı ayarlardır ve anahtar kelime karşılaştırmasında rol almazlar, ancak birinde başarısız olan bir mesaj yine de **Eşleşme Yok**'tan ayrılır.

```d2 title="How a condition node picks the text to match, applies the match type, and chooses its output"
direction: down
arrives: "Mesaj koşula ulaşır"
waits: "Bir yanıt bekliyor mu?" {shape: diamond}
parks: "Çalıştırma bir yanıt gelene kadar park eder"
replyText: "Yanıt metnini al"
triggerText: "Tetikleyen mesaj metnini al"
matchType: "Eşleşme türü" {shape: diamond}
matched: "Eşleşme, çıktı 0"
nodeText: "Düğümün metnine karşı karşılaştır"
listWords: "Listenin anahtar kelimelerine karşı karşılaştır"
reverse: "Ters eşleşme açık mı?" {shape: diamond}
invert: "Sonucu tersine çevir"
keep: "Sonucu koru"
decide: "Eşleşti mi?" {shape: diamond}
unmatched: "Eşleşme Yok, çıktı 1"
arrives -> waits
waits -> parks: evet
parks -> replyText
waits -> triggerText: hayır
replyText -> matchType
triggerText -> matchType
matchType -> matched: any
matchType -> nodeText: "içerir veya tam"
matchType -> listWords: keyword_list
listWords -> reverse
reverse -> invert: evet
reverse -> keep: hayır
nodeText -> decide
invert -> decide
keep -> decide
decide -> matched: evet
decide -> unmatched: hayır
```

Anahtar kelime ayarları koşul düğümünde yaşar. Bir tetikleyici düğüm hangi olayların bir kampanyayı başlattığına karar verir ve hiçbir anahtar kelime yapılandırması taşımaz, bu yüzden bir kampanya metni yalnızca çalıştırması bir koşula ulaştığında filtreler. [Düğüm türleri](/tr/reference/node-types) ikisinin de yapılandırmasını listeler.

## `any`

- **Okuduğu:** hiçbir şey
- **Çıktılar:** 1

Hiçbir karşılaştırma yapılmadan her mesaj eşleşir. Bir koşulu `any`'e geçirmek düğümün ikinci çıktısını düşürür ve ondan ayrılan herhangi bir bağlantıyı kaldırır, bu yüzden bu eşleşme türü seçiliyken Eşleşme Yok dalı var olamaz.

## `contains`

- **Okuduğu:** `text`
- **Çıktılar:** 2

Mesaj, yapılandırılmış metin içinde göründüğünde eşleşir. `text` bir alternatifler kümesi yerine tek bir dize tutar — birkaçına ihtiyacınız olduğunda bir anahtar kelime listesi kullanın.

## `exact`

- **Okuduğu:** `text`
- **Çıktılar:** 2

Mesaj, yapılandırılmış metnin ta kendisi olduğunda ve başka hiçbir şey olmadığında eşleşir. 

## `keyword_list`

- **Okuduğu:** `keyword_list_id`, `reverse_keywords`
- **Çıktılar:** 2

Mesaj, düğümün açılır menüsünden seçilen kaydedilmiş bir anahtar kelime listesine karşı karşılaştırılır ve o listenin anahtar kelimelerinden en az birini içerdiğinde eşleşir. Liste, eşleşme anında tanımlayıcısıyla okunur, bu yüzden listeyi düzenlemek kampanyayı yeniden kaydetmeden bu düğümün neyle eşleştiğini değiştirir. [Anahtar kelime listeleriyle yorumları eşleştirin](/tr/guides/keyword-lists) bir liste oluşturmayı ve onu bağlamayı kapsar.

```json
{
  "type": "condition",
  "config": {
    "match_type": "keyword_list",
    "keyword_list_id": 41,
    "reverse_keywords": false,
    "wait_for_reply": false,
    "filter_images": false,
    "filter_gifs": false,
    "filter_links": false
  }
}
```

Anahtar kelimeler mesaj geldiğinde değil liste kaydedildiğinde temizlenir: baştaki ve sondaki boşluklar kırpılır, boş girdiler düşürülür ve tekrarlayan girdiler tekilleştirilir. Anahtar kelimesi olmadan gönderilen bir liste reddedilir.

Bir liste, kampanyalar ve sayfalar genelinde herhangi bir sayıda koşul düğümünü destekleyebilir, çünkü düğüm kelimelerinin bir kopyasını değil listenin tanımlayıcısını saklar.

## Ters eşleşme

`reverse_keywords`, `keyword_list` eşleşme türüne uygulanır ve karşılaştırmanın sonucunu tersine çevirir. **Eşleşme** o zaman anahtar kelimelerin hiçbirini içermeyen mesajları taşır ve **Eşleşme Yok** en az birini içerenleri taşır. Karşılaştırma hakkında başka hiçbir şey değişmez.

## Boş veya silinmiş bir anahtar kelime listesi

| Durum | Koşulun ne yaptığı |
|---|---|
| Listenin içinde anahtar kelime yok | Her mesajla eşleşir |
| Düğümün işaret ettiği liste silinmiş | Her mesajla eşleşir |

Aniden her şeye yanıt veren bir koşulun genellikle bu iki nedenden biri vardır. Bir koşul düğümünün bir listeye referansı kampanyanın kaydedilmiş grafiğinin içinde yaşar, bu yüzden bir liste ona hala işaret eden bir düğümün altından kaybolabilir — [Anahtar kelime listeleriyle yorumları eşleştirin](/tr/guides/keyword-lists) silmenin neyi reddettiğini ve neyi reddetmediğini kapsar.

## İşlenmiş örnekler

| Yorum metni | Koşul ayarı | Ters eşleşme | Alınan dal |
|---|---|---|---|
| `How much is shipping?` | `shipping` ve `price` tutan anahtar kelime listesi | kapalı | Eşleşme |
| `How much is shipping?` | `shipping` ve `price` tutan anahtar kelime listesi | açık | Eşleşme Yok |
| `Beautiful, congratulations` | `shipping` ve `price` tutan anahtar kelime listesi | kapalı | Eşleşme Yok |
| `Beautiful, congratulations` | `shipping` ve `price` tutan anahtar kelime listesi | açık | Eşleşme |
| `Beautiful, congratulations` | İçinde anahtar kelime olmayan anahtar kelime listesi | kapalı | Eşleşme |
| `Beautiful, congratulations` | Silinmiş bir anahtar kelime listesi | kapalı | Eşleşme |
| `{{sticker}}` olarak gelen, metni olmayan bir çıkartma | `shipping` ve `price` tutan anahtar kelime listesi | kapalı | Eşleşme Yok |
| `{{sticker}}` olarak gelen, metni olmayan bir çıkartma | `{{sticker}}` tutan anahtar kelime listesi | kapalı | Eşleşme |
| `How much is shipping?` | `text`'i `shipping` olarak ayarlanmış `contains` | geçerli değil | Eşleşme |
| `Anything at all` | `any` | geçerli değil | Eşleşme, düğümün tek çıktısında |

## Büyük/küçük harf, tam kelimeler, noktalama işaretleri ve emoji

Bir mesaj bir anahtar kelime içererek eşleşir, ancak bu testten önce iki dizginin nasıl hazırlandığı onaylanmamıştır. Aşağıdaki her ifadeyi bir garanti yerine beklenen davranış olarak ele alın ve kampanyanızın bağlı olduklarını test edin:

- Harf büyüklüğü yok sayılır, bu yüzden `Shipping` yazan bir yorum `shipping` anahtar kelimesiyle eşleşir. 
- Bir anahtar kelime daha uzun bir kelimenin içinde eşleşir, bu yüzden `ship`, `shipping` yazan bir yorumla eşleşir. 
- Bir anahtar kelimenin yanındaki noktalama işareti bir eşleşmeyi engellemez, bu yüzden `shipping?`, `shipping` anahtar kelimesiyle eşleşir. 
- Emoji sıradan karakterler olarak karşılaştırılır, bu yüzden bir emoji tutan bir anahtar kelime, o emojiyi içeren bir yorumla eşleşir. 

Karşılaştırmanın ne yaptığı ne olursa olsun, bir anahtar kelime listesinin ne sakladığı bellidir: bir girdinin etrafındaki boşluklar kaydedilirken kırpılır, bu yüzden bir anahtar kelime bir karşılaştırmaya asla baştaki veya sondaki boşluğu taşıyamaz.

Geri kalanı onaylanana kadar, her anahtar kelimeyi tuvalden bir test çalıştırmasıyla netleştirin: kampanyayı almayı beklediğiniz tam metne karşı çalıştırın ve koşulun hangi çıktıyı aldığını okuyun. [Bir kampanyayı test et ve hata ayıkla](/tr/guides/test-and-debug-campaigns) bölümüne bakın.

## Notlar

- Metin taşımayan bir yorum, mesajın yerine bir yer tutucuyla gelir — Facebook'ta `{{sticker}}`, bir Instagram yanıtında `{{media}}` — bu yüzden bir koşulun karşılaştıracak her zaman bir şeyi vardır. O tam dizgiyi tutan bir anahtar kelime listesi bu yorumlarla eşleşir.
- Bir yanıt bekleyen bir koşulda park edilmiş bir çalıştırma, başladığı anahtar kelime kümesini tutar. Listeyi düzenledikten sonra gelen bir yanıt eski anahtar kelimelere karşı eşleştirilir; bir sonraki çalıştırma yenilerini kullanır.
- Görüntü filtresi açık olan bir koşul, görüntü taşımayan bir yanıtla eşleşmez ve anahtar kelimeler ne derse desin onu **Eşleşme Yok**'a yönlendirir.
- Tuvalde bir koşulun eşleşme türünü veya metnini değiştirmek kampanyayı yalnızca tarayıcınızda değiştirir. Canlı bir çalıştırma başladığı grafiğin kaydedilmiş sürümüne karşı karşılaştırır, bu yüzden değişiklik siz kaydettikten sonra yeni çalıştırmalara uygulanır.
- Bir koşul asla başka bir koşula bağlanmaz, bu yüzden bir dal mesaj metnini bir kez test eder. Bir yoldaki iki test iki dala, veya her iki kelime kümesini de kapsayan bir anahtar kelime listesine ihtiyaç duyar.

## İlgili

- [Anahtar kelime listeleriyle yorumları eşleştirin](/tr/guides/keyword-lists) — bir liste oluşturma, onu bir düğüme bağlama ve birini düzenlediğinizde veya sildiğinizde ne olduğu.
- [Düğüm türleri](/tr/reference/node-types) — koşul düğümünün tam yapılandırması, diğer her düğümün yanında.
- [Kampanya grafiği şeması](/tr/reference/campaign-graph-schema) — bir koşulun yapılandırmasının kaydedilmiş bir grafikte nerede durduğu.
- [Tetikleyici olaylar](/tr/reference/trigger-events) — bir koşulun karşılaştırdığı metni üreten olaylar.
- [Kişi alanları](/tr/reference/contact-fields) — bir çalıştırmanın **Eşleşme** çıktısından ayrıldıktan sonra bir kişi hakkında neyi değiştirebileceği.