Skip to main content

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 ucunun source 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.
Bu sayfa Orbit’in platform kontrollerini açıklar. Yasal tavsiye değildir. Belirli bir numaranın sizin için yasak olup olmadığı; yetki alanınızı, alıcılarınızı ve gönderdiğiniz şeyi bağlıdır. Nitelikli danışmanla doğrulayın.

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 country filtresi kabul eder (aşağıda).
Bunların hiçbiri kendi suppression katmanınızın yerine geçmez — bizzat size STOP yanıtı vermiş bir alıcı, herhangi bir ulusal kayıt ne olursa olsun kısıtlıdır. Tarama zinciri, suppression’nızı, consent opt-out’larınızı ve ulusal kayıtları tek bir birleşik yanıt olarak ele alır.

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:
Bunu organizasyonunuzun uyum ayarlarında açın (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üz source 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:XX veya tcr) 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.
Senkronizasyon UTC gününde bir kez çalışır (feed’ler iş gününde bir kez yayınlanır; çalışma 03:00 UTC’yi hedefler, böylece sabah gönderim penceresi taze veri görür). Aynı snapshot’ın yeniden çalıştırılması, zaman damgasını yenilemekten öte bir no-op’tur — upsert idempotent’tır. Geri dönüş: doğrudan TCR çekim. Snapshot dosyası/URL’si yapılandırılmadığı ancak ücretli TCR ortak kimlik bilgileri ayarlandığı zaman — 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.
Bir isabet şunu döner:
Temiz bir numara şunu döner: "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) veya none (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.
Yetki alanına göre filtre. Uluslararası kayıt aramasını tek bir yetki alanıyla sınırlandırmak için 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.
Yani uçun işi zorlama değil, ön-uçuştur: soğuk bir listeyi kampanyadan önce (veya toplu taramayı) sorgulayın, kapı zaten engelleyeceği numaraları kaldırmak için — ve kendi kayıtlarınız için onları yüzeye çıkarmak için.

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:
  1. federal_feeds_synced: true olmadıkça temiz bir sonucu federal safe-harbor olarak görmeyin. federal_feeds_synced: false ile temiz bir yanıt yalnızca kendi listelerinizin, suppression’in, consent’in ve platform listesinin numarayı işaretlemediği anlamına gelir.
  2. 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.
Orbit’in SaaS’ında 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:
Gönderimden önce 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: