Ö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 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 (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 eklemelidir. 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

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 bağlandıktan sonra etkili olur — bir kampanya veya akışın aslında üzerinden gönderdiği kimlik:

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 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 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 — yeniden hiçbir zaman mesaj gönderilmemesi gereken adresler için toplu bastırma listesi içe aktarımı
DNC Tarama — kampanya gönderiminden önce kişileri ulusal Aranmama Kayıtlarına karşı tarayın
Opt-Outs API referansı — kişi başına opt-out kayıtları
Mesajlaşma kimlikleri & servisleri — opt_out_list_id üzerinden bir liste bağlama
SMS gönderim servisleri — listenin bağlandığı servis, uçtan uca

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Brand & press

Changelog

Özel Opt-Out Anahtar Kelime Listeleri

Özel Opt-Out Anahtar Kelime Listeleri

Ne zaman gerekli

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

Liste oluşturma

Desteklenen dil kodları

Yaygın takma adlar (dile göre)

Listeyi bir mesajlaşma servisine bağlama

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

Uç noktalar

Ayrıca bakınız

​Özel Opt-Out Anahtar Kelime Listeleri

​Ne zaman gerekli

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

​Liste oluşturma

​Desteklenen dil kodları

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

​Listeyi bir mesajlaşma servisine bağlama

​Opt-out listeleri vs. bastırma listeleri vs. kişi opt-out’ları

​Uç noktalar

​Ayrıca bakınız

Özel Opt-Out Anahtar Kelime Listeleri

Ne zaman gerekli

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

Liste oluşturma

Desteklenen dil kodları

Yaygın takma adlar (dile göre)

Listeyi bir mesajlaşma servisine bağlama

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

Uç noktalar

Ayrıca bakınız