DNC Taraması: Kaynaklar, Güncellik ve Kontrol Ucu
DNC taraması, gönderimden önce tek bir soruyu yanıtlar: bu numara, kendisiyle iletişime geçilmesini engelleyen veya kısıtlayan bir listede mi? Orbit; kendi listelerinizi (kişi işaretleri, DNC kayıtları, suppression, consent), platform genelindeki listeyi, ABD federal/eyalet/TCR feed’lerini ve birkaç uluslararası ulusal kaydı kontrol eder — ve gönderim yolunun uyguladığı zincirin aynısı bir API olarak okunabilirdir; böylece soğuk bir listeyi ihlal riskli bir gönderim olmadan ön uçuştan geçebilirsiniz. Bu sayfa uçtan uca resimdir: tarama ne zaman önemlidir, nasıl etkinleştirilir, senkronize veriler nereden gelir, kontrol ucununsource ve
last_synced_at alanları nasıl okunur ve yönetmeniz gereken tek fail-open
uyarısı. Sonucu tüketen gönderim-zamanı kapıları için bkz.
Gönderim Kapıları.
Aşağıdaki tüm uçlar şu kök üzerindedir:
https://api.orbit.devotel.io/api/v1/compliance.
DNC taraması ne zaman önemlidir
DNC yükümlülükleri birden fazla kayıttan gelir ve katmanlanır:- ABD federal DNC (FTC Ulusal Kaydı). Federal kayıtlı bir numaraya yapılan telemarketing aramaları ve pazarlama metinleri kısıtlıdır; herhangi bir giden kampanyadan önce federal kayda karşı tarama temel savunmadır.
- ABD eyalet kayıtları. Birçok eyalet, federal listenin üzerine kendi DNC listelerini işletir. Bir numara federal olarak yok olabilir ancak örneğin Pensilvanya’da kayıtlı olabilir — bu yüzden yalnız federal tarama ABD trafiği için eksiktir.
- TCR Universal Opt-Out. The Campaign Registry’nin evrensel opt-out listesi, kayıt düzeyinde A2P mesajlaşmasından vazgeçmiş numaraları yakalar. Bunu uymak, kendi suppression listenizden bağımsız olarak ABD 10DLC mesajlaşma hijyeninin bir parçasıdır.
- Uluslararası ulusal kayıtlar. ABD dışında, eşdeğer ulusal listeler
uygulanır — Birleşik Krallık TPS ve CTPS, Avustralya’nın Do Not Call
Register, Hindistan’ın NDNC’si. Bunlar yetki alanına göre: İngiltere
kampanyasını İngiliz kayıtları karşısında tararsınız; bu yüzden kontrol
ucu
countryfiltresi kabul eder (aşağıda).
Kiracı (tenant) toggle’ını etkinleştirin
Kontrol ucu, organizasyon başına varsayılan olarak kapalıdır. Opt-in yapılıncaya — veya Orbit’in platform için senkronize bir feed’i oluncaya kadar — uc şunu döner:403 DNC_SYNC_NOT_ENABLED:
dnc_sync_enabled ayarı — bu toggle’ı ve varsayılanını listeleyen
duruş haritasına bakın). Tek bir çevirme
hem tek-numara kontrolünü hem de toplu taramayı etkinleştirir.
Feed’ler senkronize edildikten sonra kapı otomatik olarak devre dışı
kalır. Organizasyon toggle’ı, federal bir feed senkronize edilene kadar
Orbit’in FTC kaydına karşı tarama yapmadığının kabulüdür. Platformun bir
federal/eyalet/TCR (veya uluslararası) snapshot’ı senkronize edildikten
sonra uç doğrudan hizmet verir ve 403 kapısı artık uygulanmaz — her
yanıttaki
federal_feeds_synced alanı hangi durumda olduğunuzu söyler.
Gönderim yolundaki kendi DNC, suppression ve consent uygulamanız her iki
durumda da etkilenmez.Liste nereden gelir (feed bağlantısı)
Senkronize DNC verileri, platform genelindeki DNC listesine günlük olarak yenilenen yukarı akış feed’lerinden gelir. Bir operatörün yapılandırdığı şey, kontrol ucundan geri gördüğünüzsource değerlerinin hangilerini göreceğinizi
belirler.
Bunlar operatör düzeyinde çevre değişkenleridir. Orbit’in barındırılan
(SaaS) platformunda sizin için ayarlanır; SaaS operatörü hangi feed’lerin
canlı olduğunu kontrol eder. Yalnızca Orbit’i kendi kendinize barındırıyorsanız
size doğrudan ilgilidir — bu durumda bunları dağıtımınızda yapılandırın:
DEVOTEL_DNC_FEED_FILE— tedarik edilen bir federal/eyalet/TCR snapshot’ı içeren bir bağlı volume. Günlük senkronizasyon bunu okur, her opt-out olan numarayı ayrıştırır ve onu kaynağıyla (federal_dnc,state_dnc:XXveyatcr) etiketleyerek platform DNC listesine upsert eder.DEVOTEL_DNC_FEED_URL— bağlı dosyaya alternatif olarak aynı snapshot’ın kimliği doğrulanmış indirmesi. Her ikisi de ayarlandığında dosya öncelik alır.
DEVOTEL_TCR_API_KEY
ile birlikte DEVOTEL_TCR_PARTNER_ID — günlük senkronizasyon TCR Universal
Opt-Out kaydını doğrudan ortak API’den çeker ve onu source: "tcr" olarak
upsert eder. Bu, out-of-band CSV olmadan mevcut TCR aboneliğinden TCR taramasını
sağlar.
Günlük senkronizasyonun platform DNC listesine yazdığı snapshot’ın aynısı,
API tarafından da önyükleme sırasında belleğe yüklenir, böylece kontrol ucu
federal/eyalet/TCR aramasını sonraki günlük yazmayı beklemeden yanıtlayabilir.
Yanıttaki
federal_feeds_synced: true bu bellek-içi feed’in canlı olduğunu
gösterir.Kontrol ucunu okuyun
GET /compliance/dnc/check, bir E.164 numarasının gönderim yolunun
uyguladığı herhangi DNC kaynağında olup olmadığını bildirir. Yalnız okumadır —
gönderim yapmaz.
"on_dnc": false, "source": "none" ve
boş bir jurisdictions.
Duruşu taşıyan alanlar:
source— ilk isabeti üreten kaynak; şunlardan biri:federal_dnc,state_dnc(bir ABD eyalet kaydı),tcr(TCR Universal Opt-Out),intl_dnc(bir uluslararası ulusal kayıt),suppression(kendi suppression katmanınız) veyanone(hiçbir listede değil).jurisdictions, tüm eşleşen kökenleri listeler, yani hem federal kayıtta hem de eyalet kaydında olan bir numara her ikisini de gösterir.last_synced_at— eşleşen kaynağın tazelik zaman damgası: federal/ eyalet/TCR snapshot’ı (veya isabet eden satır) en son ne zaman senkronize edildi. Günlük senkronizasyon her çalışmada bir heartbeat satırı damgasını atar, böylece bu alan feed-destekli kaynaklar için her zaman bir “son senkronize” sinyali taşır ve hiçbir satır eşleşmediğinde susmaz. Kendi suppression/consent kaynaklarınızın senkronizasyonu yoktur, bu yüzden yalnız suppression isabeti için alan opt-out olayının kendisini yansıtır.federal_feeds_synced/intl_feeds_synced— API’nin gerçekten bir ABD federal/eyalet/TCR snapshot’ı ve uluslararası ulusal-kayıt snapshot’ı ingest etmiş olup olmadığı, sırasıyla. Bunları her yanıtta okuyun: “numara temiz” ile “numara temiz ve federal tarama bu yanıtı destekledi” arasında ayrım yaparlar.
country (ISO alpha-2) ekleyin:
country=GB ile yalnızca İngiltere kayıtları (TPS/CTPS) uluslararası eşleşme
üretebilir — İngiltere’ye yönelik bir kampanya ilgisiz bir ülkenin kaydında
asla işaretlenmez.
Toplu. Tüm bir listeyi veya kampanya izleyicisini tek bir çağrıda
taramak için POST /compliance/dnc/scrub ile bir phones dizisi kullanın
(istek başına en fazla 500 numara; mükerrerler kaldırılır). Numara başına
aynı zinciri çalıştırır ve numara başına yanıtlarla birlikte on_dnc /
clear sayılarını döner. Aynı organizasyon kapısı uygulanır.
Gönderim tarafı bunu nasıl tüketir
Kontrol ucu, gönderim yolunun uyguladığı zincirin aynısının bir okumasıdır. Taramayı gönderimlerinize siz bağlamazsınız — Orbit zaten bağlar:- Mesajlaşma (SMS / MMS / WhatsApp / …). Gönderimden önce, gönderim yolu “bu alıcı opt-out mu?” sorusunu aynı DNC kaynakları karşısında yanıtlar — kişi DNC işaretiniz, DNC listeniz, suppression listesi (kanallar-arası STOP sinyali), platform genelindeki DNC listesi (günlük federal/eyalet/TCR feed’in indiği yer) ve kayıtlı consent opt-out’ları. Bir isabet gönderimi düşürür.
- Ses / arayan. Arayan, bir aramayı başlatmadan önce aynı uyum zincirini çalıştırır — kanallar-arası STOP, kişi DNC, platform DNC ve consent — böylece SMS ile opt-out yapan bir numara sonra sesle aranmaz. Gönderim yolu kapalı şekilde başarısız olur: uyum kontrolunu kendisi tamamlanamazsa, arama aranmadan önce ertelenir.
Fail-open uyarısı
Okuma ucu kaynak katmanında fail-open’dır: bir DNC kaynağı sorgulanamadığı zaman, kontrol diğerlerine devam eder ve elde edebildiği en iyi yanıtı döner. Anlamanız gereken somut sonuç:
Federal feed senkronize edilene kadar, yalnızca FTC federal kaydında olan
bir numara temiz olarak okunur (on_dnc: false).
Ucu neden siz opt-in yapıncaya kadar kapılandırılmıştır ve
federal_feeds_synced neden her yanıtta gezilir budur. İki operasyonel kural
izler:
federal_feeds_synced: trueolmadıkça temiz bir sonucu federal safe-harbor olarak görmeyin.federal_feeds_synced: falseile temiz bir yanıt yalnızca kendi listelerinizin, suppression’in, consent’in ve platform listesinin numarayı işaretlemediği anlamına gelir.- Katı kapı gönderim yoludur. Okuma yolu tasarım olarak fail-open’dır; gönderim yolu değildir. Ön-uçuş sorgusundan gelen yanlış negatif asla bir gönderime dönüşmez — gönderim-zamanı zincir aynı kaynakları yeniden kontrol eder ve bulduğunu engeller.
federal_feeds_synced: false’u “henüz federal tarama bu
yanıtı desteklemiyor” olarak değerlendirin ve bunu ABD kampanyasınız için
ön-uçuşa ne kadar güvendiğinizi tartırken göz önünde bulundurun. Kendi
kendine barındıranlar, bir feed yapılandırarak (yukarıda) boşluğu kapatır.
Kampanyadan önce doğrulama
Kampanya izleyicisini toplu taramayla ön-uçuştan geçirin, sonra yanıtlara göre hareket edin:on_dnc: true olan numaraları izleyiciden kaldırın. Hangi
kayıtların yanıtları gerçekten desteklediğini bilmek için aynı yanıttaki
federal_feeds_synced / intl_feeds_synced alanlarını kontrol edin ve verinin
taze olduğunu doğrulamak için sonuç başına last_synced_at alanına bakın.
Daha büyük bir liste için, 500 numaralık parçalar halinde sayfalayın.
Ayrıca bakınız:
- Gönderim Kapıları — sessiz-saatler / DNC / RND / RMD gönderim-zamanı kapıları ve acil durum durdurması.
- TCPA Bilinen-Davacı Kapısı — ABD TCPA riski için DNC taramasını tamamlayan alıcı-köken kontrolu.
- Toplu DNC Ön-Uçuş Taraması — toplu tarama etrafındaki kampanya iş akışı: kapılama, parçalama ve işaretlenen numaraların yönlendirilmesi.
- Opt-Out ve Suppression Listeleri — bir alıcının STOP’unun DNC zincirinin okuduğu suppression katmanına nasıl indiğini.
- Kiracınızın Uyum Duruşu — toggle haritası,
bu sayfanın
dnc_sync_enabledsatırı dahil.