> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Özel Opt-Out Anahtar Kelime Listeleri

> Orbit'te marka bazlı STOP, HELP ve START anahtar kelimeleri ile otomatik yanıt metinlerini yapılandırın ve opt-out listesini bir mesajlaşma servisine bağlayın.

# Özel Opt-Out Anahtar Kelime Listeleri

Her Orbit kiracısı, operatörlerce zorunlu kılınan STOP / HELP / START işlemini kutudan çıktığı gibi alır. Birden fazla marka veya dilde gönderim yaptığınızda bir opt-out listesi daha ileri gider: ek anahtar kelime takma adları ve özel otomatik yanıt metni tanımlayın, sonra bu listeyi onu kullanması gereken belirli [mesajlaşma servisine](/api-reference/messaging-credentials) bağlayın. Listeye bağlı olmayan bir mesajlaşma servisi platform varsayılanlarını kullanmaya devam eder.

Uç noktaların tam listesi aşağıda; bu sayfa kavramları ve alanların nasıl kullanıldığını kapsar.

> İngilizce asıl: [Custom Opt-Out Keyword Lists](/guides/opt-out-lists) (bu sayfanın İngilizce sürümü).

## Ne zaman gerekli

Şu durumlarda özel bir opt-out listesine başvurun:

* Tek bir Orbit hesabından **birden fazla marka** ile gönderim yapıyorsunuz ve her markanın STOP yanıtının kendi sesiyle gelmesini istiyorsunuz ("Acme Travel bildirimlerinden aboneliğiniz iptal edildi." vs. "Acme Pharmacy hatırlatmalarından aboneliğiniz iptal edildi.").
* Hedef kitleniz, platform varsayılanları kapsamında olmayan bir **dil veya lehçe** ile opt-out kelimesi yazıyor — zorunlu kelimeleri kaybetmeden yerel takma adlar ekleyebilirsiniz.
* **Markalı HELP metni** istersiniz ("Destek için HELP yazın, veya 1-800-… numarasını arayın") genel varsayılan yerine.

## Neyi değiştirebilir, neyi değiştiremezsiniz

Liste başına anahtar kelime dizileri **yalnızca eklemeli**dir. Orbit'in eşleştiricisi, listenizin kelimelerini operatörlerce zorunlu kılınan platform varsayılan setiyle birleştirir — tetikleme yüzeyini genişletebilirsiniz (`STOP` yanında `"CANCEL"` veya yerel bir dil kelimesi ekleyerek) ama `STOP`'u kendisi kaldıramazsınız. TCPA ve CTIA bunu gerektirir ve Orbit bunu, kiracının ne yapılandırdığından bağımsız olarak platform seviyesinde zorlar.

## Liste oluşturma

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messaging/opt-out-lists \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Acme Travel — ES",
    "stop_keywords": ["BAJA", "CANCELAR"],
    "help_keywords": ["AYUDA"],
    "stop_response": "Has cancelado las alertas de Acme Travel. Responde AYUDA para soporte.",
    "help_response": "Acme Travel: responde BAJA para cancelar, o llama al 1-800-555-0100.",
    "default_lang": "es",
    "brand": "Acme Travel"
  }'
```

| Alan                                                 | Notlar                                                                                                                      |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `label`                                              | Listenizin adı, kontrol panelinde gösterilir.                                                                               |
| `stop_keywords` / `help_keywords` / `start_keywords` | Her biri en fazla 32 girdi, platform varsayılanlarına eklemeli.                                                             |
| `stop_response` / `help_response` / `start_response` | Eşleşen anahtar kelime tetiklendiğinde gönderilen otomatik yanıt metni, en fazla 1.600 karakter (yaklaşık 10 SMS segmenti). |
| `default_lang`                                       | Şunlardan biri: `en`, `tr`, `de`, `es`, `fr`, `pt`, `it`, `ar`, `nl`.                                                       |
| `brand`                                              | Kendi referans ve raporlamanız için serbest metin marka etiketi.                                                            |

## Desteklenen dil kodları

`default_lang` alanı bir ISO 639-1 kodu kabul eder ve otomatik yanıt şablonunun dilini, ayrıca gelen kişinin dili başka türlü bilinmiyorsa kullanılacak yerel ayarı belirler. Platform dokuz dili destekler:

| Kod  | Dil        |
| ---- | ---------- |
| `en` | İngilizce  |
| `tr` | Türkçe     |
| `de` | Almanca    |
| `es` | İspanyolca |
| `fr` | Fransızca  |
| `pt` | Portekizce |
| `it` | İtalyanca  |
| `ar` | Arapça     |
| `nl` | Flemenkçe  |

Liste bağlı değilse ve dil bilinmiyorsa, her dilin anahtar kelime seti ardışık eşleştirilir — gelen bir opt-out yanıtının aşırı eşleşmesi kasıtlıdır (en kötü durum: meşru bir "DUR" mesajının opt-out olarak işlenmesi; bu, düzenleyici açısından güvenlidir).

## Yaygın takma adlar (dile göre)

Hedef kitleniz bunları kullandığında, listenizin `stop_keywords` (veya `help_keywords` / `start_keywords`) dizisine bu ek girdileri ekleyin. Bunlar kiracı tarafı eklemeleri örnekleridir; yukarıdaki platform varsayılanları her durumda uygulanır.

| Dil        | Dikkate alınabilecek kiracı tarafı takma adlar          |
| ---------- | ------------------------------------------------------- |
| Türkçe     | `CIKIS` (ASCII varyantı), `IPTAL`, `IPTAL ET`, `DURDUR` |
| Almanca    | `ABMELDEN`, `STOPP`, `ABBESTELLEN`, `ENDE`              |
| Fransızca  | `STOP`, `ARRET`, `ARRÊT`, `ANNULER`                     |
| Arapça     | `إلغاء`, `أوقف`, `توقف`, veya İngilizce `STOP`          |
| Flemenkçe  | `STOPPEN`, `UITSCHRIJVEN`, `OPZEGGEN`                   |
| İspanyolca | `BAJA`, `CANCELAR`, `SALIR`                             |
| Portekizce | `PARAR`, `CANCELAR`, `SAIR`                             |
| İtalyanca  | `FERMA`, `CANCELLA`, `FINE`                             |

Eşleştirme büyük/küçük harfe duyarsızdır ve NFC normalizasyonuyla çalışır — aksanlar ve diyakritikler aynı anahtar kelime hedefine daralır ve karşılaştırma öncesinde iç boşluklar daraltılır.

## Listeyi bir mesajlaşma servisine bağlama

Bir liste ancak bir [mesajlaşma servisine](/api-reference/messaging-credentials) bağlandıktan sonra etkili olur — bir kampanya veya akışın aslında üzerinden gönderdiği kimlik:

```bash theme={null}
curl -X PATCH https://api.orbit.devotel.io/api/v1/messaging/services/msvc_abc123 \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "opt_out_list_id": "ool_abc123" }'
```

Aynı markalı anahtar kelimeleri ve metni kullanması gereken her mesajlaşma servisi, `opt_out_list_id`'sini aynı listeye yöneltir. `opt_out_list_id`'yi `null`'a ayarlayarak bağlantıyı kaldırın; bu, o servis için platform varsayılanlarına geri döner.

## Opt-out listeleri vs. bastırma listeleri vs. kişi opt-out'ları

Bunlar üç farklı katmandır ve karıştırılması kolaydır:

* **Opt-out listeleri (bu sayfa)** bir STOP/HELP/START yanıtının *nasıl tanındığını ve yanıtlandığını* yapılandırır — anahtar kelime eşleştirme ve otomatik yanıt katmanı.
* **[Opt-out & bastırma listeleri](/compliance/opt-out-suppression)** uyum tarafı toplu bastırma listesini kapsar — yeniden hiçbir zaman mesaj gönderilmemesi gereken adresleri toplu içe aktarma, örneğin başka bir platformdan geçiş yaparken.
* **[Opt-Outs API'i](/api-reference/optouts)** gerçekte kimin opt-out yaptığının kişi başına, kanal başına kaydıdır — gönderimden önce her gönderimin karşısında kontrol edilen şey.

Daha geniş bir STOP anahtar kelime seti (bu sayfa) kaç gelen yanıtın opt-out olarak *tanındığını* artırır; asıl engelleme, yazdığı kişi opt-out kaydı üzerinden olur.

## Uç noktalar

| Yöntem   | Yol                                    | Amaç                             |
| -------- | -------------------------------------- | -------------------------------- |
| `GET`    | `/api/v1/messaging/opt-out-lists`      | Opt-out listelerinizi listeleyin |
| `POST`   | `/api/v1/messaging/opt-out-lists`      | Liste oluşturun                  |
| `GET`    | `/api/v1/messaging/opt-out-lists/{id}` | Bir liste getirin                |
| `PATCH`  | `/api/v1/messaging/opt-out-lists/{id}` | Bir liste güncelleyin            |
| `DELETE` | `/api/v1/messaging/opt-out-lists/{id}` | Bir liste silin                  |

## Ayrıca bakınız

* [Opt-Out & Bastırma Listeleri](/compliance/opt-out-suppression) — yeniden hiçbir zaman mesaj gönderilmemesi gereken adresler için toplu bastırma listesi içe aktarımı
* [DNC Tarama](/compliance/dnc-scrub) — kampanya gönderiminden önce kişileri ulusal Aranmama Kayıtlarına karşı tarayın
* [Opt-Outs API referansı](/api-reference/optouts) — kişi başına opt-out kayıtları
* [Mesajlaşma kimlikleri & servisleri](/api-reference/messaging-credentials) — `opt_out_list_id` üzerinden bir liste bağlama
* [SMS gönderim servisleri](/guides/sms-services) — listenin bağlandığı servis, uçtan uca