​

Vazgeçme ve Bastırma Listeleri

​

Bastırma nasıl gerçekleşir

• Bir kişi SMS/WhatsApp’ta bir STOP anahtar sözcüğü ile yanıt verir.
• Bir kişi Tercih Merkezi üzerinden vazgeçer.
• Consent API (opt_in: false) üzerinden bir vazgeçme kaydedersiniz.
• Bir listeyi toplu içe aktarırsınız (bu sayfa).

• Toplu CSV içe aktarımı kapsamı her satırın adres türünden çıkarır: telefon ve WhatsApp adresleri varsayılan olarak all kapsamına girer — bir telefon numarasındaki STOP sinyali o numarada ulaşılabilen tüm kanalları bastırır — e-posta adresleri ise email kapsamına alınır. Bir channel sütunu bunu satır başına geçersiz kılar (bkz. Toplu CSV içe aktarımı).
• Consent API ve Tercih Merkezi her zaman all kapsamını bastırır; kaydedilen tanımlayıcının telefon numarası mı yoksa e-posta adresi mi olduğuna bakılmaksızın. Bu giriş noktalarından birinden gelen bir vazgeçme, kişiyi her kanaldan kaldırır.

​

Toplu CSV içe aktarımı

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/suppression-list/import \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -F "file=@suppressions.csv" \
  -F "default_country=US" \
  -F "default_reason=migrated_from_legacy_platform" \
  -F "dry_run=false"

​

Form alanları

​

CSV biçimi

phone,email,reason
+14155550101,,replied STOP
,jordan@example.com,unsubscribed via email
+442071838750,sam@example.co.uk,complaint

​

Satır başına sonuçlar

{
  "data": {
    "run_id": "supimp_4d…",
    "total_rows": 1000,
    "accepted": 950,
    "duplicates": 30,
    "intra_file_duplicates": 15,
    "invalid": 5,
    "errors": [
      { "status": "invalid", "reason": "invalid_phone", "raw_line": 42 }
    ],
    "by_channel": { "all": 800, "email": 150 },
    "file_sha256": "9b2e…"
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

​

Doğrulama nedenleri

​

Sınırlar

​

İçe aktarım başarısız olduğunda

​

Panodan içe aktarma

1. CSV dosyası seçin — 25 MB altında bir .csv seçin. Önceden biçimlendirilmiş bir başlangıç dosyası için iletişim kutusundaki Örnek CSV indir seçeneğini kullanın.
2. Varsayılanları ayarlayın (isteğe bağlı) — ulusal biçimdeki numaraları normalleştirmek için bir Varsayılan ülke (ISO alpha-2) ve her kabul edilen satıra damgalanan serbest metin bir Neden.
3. Önizleme — içe aktarımı sunucu tarafında bir kuru çalıştırma olarak çalıştırır: hiçbir şey yazılmaz ve siz işlemeden önce iletişim kutusu kabul edilen / zaten listede / dosyada tekrar / geçersiz dökümünü gösterir.
4. İçe aktarımı onaylayın — işleyen yazmayı gerçekleştirir. Herhangi bir satır geçersizse, onları düzeltip yeniden içe aktarmak için skipped.csv dosyasını indirin.

​

Bastırma listesini dışa aktarma

curl "https://api.orbit.devotel.io/api/v1/compliance/suppression-list/export?format=csv&status=active" \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -o suppression-list.csv

​

Bastırmanın etkili olduğunu doğrulama

1. Bastırılmış adrese bir test mesajı gönderin. Bastırılmış bir alıcıya doğrudan API gönderimi, HTTP 422 ve RECIPIENT_OPTED_OUT hata koduyla eşzamanlı olarak başarısız olur. Kum havuzu modunda hiçbir taşıyıcıya dokunulmaz ve bakiye düşülmez; 8 ile biten herhangi bir alıcı ayrıca simüle edilmiş blocked teslimat makbuzuna çözümlenir, bu da aynı engelin taşıyıcı tarafı görünümüdür.
   curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
     -H "X-API-Key: $ORBIT_SANDBOX_KEY" \
     -H "Content-Type: application/json" \
     -d '{"to": "+14155550101", "from": "+15005550101", "body": "gate check"}'
   
   {
     "error": {
       "code": "RECIPIENT_OPTED_OUT",
       "message": "Recipient has opted out of this channel"
     }
   }
   
   Aynı adrese bir kampanya gönderimi, tasarım gereği farklı davranır: alıcı sessizce atlanır (status: "skipped", reason: "opted_out") böylece toplu iş ilerlemeye devam eder — hata beklemek yerine kampanyanın alıcı başına raporunu denetleyin.
2. Girişin defterde olduğunu doğrulayın. Yukarıdaki sorguyla dışa aktarın (status=active varsayılandır) ve adresin beklenen channel kapsamıyla göründüğünü denetleyin. Dışa aktarım, her gönderi kapısının okuduğu gerçeğin kaynağıdır — satır orada active ise, engel dikidir.

​

Bastırmayı kaldırma (yeniden katılım)

​

İlgili başvurular

• İzin Yönetimi — kanal başına izni kaydedin ve arayın.
• Send Gates — sessiz saatler, DNC, RND, RMD, acil durdurma ve tercih merkezi.
• DSAR — delete / opt_out isteklerinin bastırmaya nasıl ulaştığı.
• API Başvurusu → Vazgeçmeler — vazgeçme ve bastırma uç nokta şemaları.