> ## 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. # ITG Traceback: Kaynak Numaralar İçin İstekleri Ele Alma > Industry Traceback Group isteklerini kaynak numaralarınızın karıştığı durumlarda kaydedin, alındılayın ve yanıtlayın — vaka yaşam döngüsü, 24 saatlik yanıt SLA'sı ve dosyaladığınız disposition'lar. # ITG Traceback Vaka İşleme Giden ABD ses trafiğinizi STIR/SHAKEN attestation ile imzalamak, aşağı akış yükümlülüğü getirir: kaynak numaralarınızdan biri bir robocall şikayetinde karıştığında, Industry Traceback Group (ITG) size aramanın kaynağını belirtmenizi isteyen bir **traceback isteği** gönderebilir ve yanıt vermeniz beklenir, tipik olarak yaklaşık 24 saat (bir iş günü) içinde. Orbit bu yükümlülük için vaka-yönetimi yüzeyini sağlar: her gelen ITG isteğini kaydetmek, alındılamak, disposition'ınızı dosyalamak ve yanıt son tarihini izlemek için bir yer. Bu sayfadaki her kontrol **tenant-özgü** — isteği kayreden siz, disposition'a karar veren siz, ITG'ye dosyalayan siz. Aşağıdaki tüm endpoint'ler `https://api.orbit.devotel.io/api/v1/compliance` kökündedir. Traceback yanıtı, TRACED Yasası kapsamındaki FCC robocall azaltımının bir parçasıdır (ITG, FCC'nin çerçevesi altında USTelecom tarafından yürütülür). Traceback isteklerini sürekli görmezden gelmek, yaptırıma ve operatör de-peering'e tırmanabilen kendi başına bir uyumluluk kırmızı bayrağıdır. Bu sayfa hukuki tavsiye değildir — traceback yükümlülüklerinizi ve son tarihlerinizi hukuk danışmanınızla doğrulayın. *** ## Attestation neden bu yükümlülüğü yaratır STIR/SHAKEN, FCC'nin ABD ses trafiği için zorunlu kıldığı caller-ID kimlik doğrulama çerçevesidir. Orbit üzerinden yaptığınız her giden arama, imzalama anında bir attestation seviyesi (A, B veya C) alır — seviyelerin ne anlama geldiği ve Orbit'in bunlara nasıl ulaştığı için [STIR/SHAKEN attestation](/channels/voice/stir-shaken) sayfasına bakın. İmzalı trafiğiniz size geri attributlenebildiğinden, aşağı akış sağlayıcıları ve ITG (ATIS/FCC traceback çerçevesi), karışmış bir aramanın nereden geldiğini size sorabilir. Bu istekleri zamanında yanıtlamak ve bulduklarınızın kaydı tutmak, imzalı trafik kaynaklamayla birlikte gelen robocall azaltma görevlerinin parçasıdır. ## Vaka yaşam döngüsü Her traceback vakası dört durumdan geçer: | From \ To | `acknowledged` | `responded` | `closed` | | ------------------- | -------------- | ----------- | -------- | | `received` | Evet | Evet | Evet | | `acknowledged` | — | Evet | Evet | | `responded` | — | — | Evet | | `closed` (terminal) | — | — | — | * `received` — ITG isteği loglandı, henüz işlenmedi. * `acknowledged` — ITG'ye alındıyı doğruladınız. * `responded` — disposition'ınızı ITG'ye dosyaladınız. * `closed` — vaka çözüldü (terminal; başka geçiş yok). Geçersiz bir geçiş (örneğin `closed` bir vakayı alındılama veya iki kez yanıtlama), `TRACEBACK_INVALID_TRANSITION` ile bir `409` döndürür. ## Yanıt-son-tarihi SLA'sı Her vaka bir yanıt-son-tarihi saati taşır. Varsayılan pencere, `received_at`'ten **24 saat**tir — ITG'nin bir iş günü beklentisinin muhafazakar kodlaması. ITG farklı bir son tarih belirttiğinde, vaka başına `sla_hours` (en fazla 720) ile daha sıkı veya daha gevşek bir pencere ayarlayabilirsiniz. SLA durumunu asla doğrudan sorgulamazsiniz — traceback yüzeyindeki her `GET`, her vakayı okuma anında hesaplanan bir **canlı karar** ile etiketler: ```json theme={null} { "sla": { "due_at": "2026-08-27T09:15:00.000Z", "status": "due_soon", "hours_remaining": 3, "breached": false, "reason": "The ITG response window closes soon; respond to avoid breaching the traceback SLA." } } ``` | `status` | Anlam | | ---------- | --------------------------------------------------------------------------- | | `on_track` | Açık, son tarihten rahatça önce. | | `due_soon` | Açık, son tarihe 4 saat içinde. | | `met` | Son tarihinde veya öncesinde yanıtlandı. | | `breached` | Son tarih yanıtsız geçti veya yanıt geçti (`breached: true`). | | `unknown` | Alınma zaman damgası çözümlenemez, bu yüzden hiçbir son tarih hesaplanamaz. | ## Bir traceback isteğini ele alma, adım adım Aşağıdaki tüm yazışlar **owner veya admin** rolünü gerektirir; okumalar herhangi bir kimliği doğrulanmış üyeye açıktır. ### 1. Gelen isteği kaydedin Bir ITG traceback isteği geldiğinde, saati başlatmak için kaydedin. ITG'nin referansını, karışmış kaynak numarayı (E.164) ve isteğe bağlı olarak karışmış kampanyanın açıklamasını, o trafikte iddia edilen attestation seviyesini ve özel bir son tarih verin. ```bash theme={null} curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/traceback" \ -H "Authorization: Bearer $ORBIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "traceback_ref": "ITG-2026-11843", "source_number": "+14155550101", "campaign_description": "Outbound renewal-notice campaign flagged in a robocall complaint", "attestation": "A", "notes": "Received via the ITG portal on 2026-08-26" }' ``` Vaka `received` durumunda oluşturulur ve 24 saatlik son tarih, kayıt zamanından başlar. Yanıttan gelen `id`'yi sonraki adımlar için saklayın. ### 2. Alındıyı onaylayın ITG'ye isteğin işlenmekte olduğunu onaylayın. Bu, vakayı `acknowledged`'a taşır ve isteğe bağlıdır — doğrudan `received`'den yanıt verebilirsiniz. ```bash theme={null} curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/traceback/tb_a1b2c3d4/acknowledge" \ -H "Authorization: Bearer $ORBIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"notes": "Acknowledged to the ITG under their reference ITG-2026-11843"}' ``` ### 3. Yanıtınızı dosyalayın Soruşturduktan sonra disposition'ı kaydedin. Bu, yanıt-son-tarihi saatini durdurur ve `"close": true` ile vakayı aynı çağrıda kapatır. ```bash theme={null} curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/traceback/tb_a1b2c3d4/respond" \ -H "Authorization: Bearer $ORBIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "disposition": "source_identified", "notes": "Traffic traced to sub-account supplier-7; source identification supplied to the ITG.", "close": true }' ``` ### Disposition'lar "Karışmış trafik hakkında ne yaptınız?" sorusunu yanıtlayan disposition'ı seçin: | Disposition | Anlam | | --------------------- | ------------------------------------------------------------------- | | `source_identified` | Yukarı akış/müşteri kaynağını belirlediniz ve ITG'ye sağladınız. | | `customer_notified` | Karışmış müşteriyi uyardınız. | | `customer_terminated` | Karışmış müşteriyi veya kampanyayı kestiniz. | | `number_disabled` | Karışmış kaynak numarayı devre dışı bıraktınız. | | `not_originated_here` | Trafik hesabınızdan kaynaklanmadı. | | `no_action` | Gözden geçirdiniz ve hiçbir eylem almadınız (`notes`'da açıklayın). | ### 4. Vakaları gözden geçirin Her vakayı canlı SLA kararıyla listeleyin veya tek bir vakayı id ile getirin: ```bash theme={null} curl "https://api.orbit.devotel.io/api/v1/compliance/traceback" \ -H "Authorization: Bearer $ORBIT_API_KEY" ``` ```bash theme={null} curl "https://api.orbit.devotel.io/api/v1/compliance/traceback/tb_a1b2c3d4" \ -H "Authorization: Bearer $ORBIT_API_KEY" ``` Vakalar en yeni istek önce listelenir, böylece son tarihine yaklaşan herhangi bir açık vaka ilk sayfadan görünür. *** ## Yalnızca kayıt tutma yüzeyi Traceback yüzeyi **kaydeder, izler ve kayıt tutar** — başka bir şey yapmaz. Bir vaka kaydetmek, alındılamak ve bir yanıt dosyalamak durumu kalıcı yapar; asla bir arama yapmaz, bir mesaj göndermez veya ITG veya karışmış müşteriyle sizin adınıza iletişim kurmaz. Bir yanıt dosyalamak, seçtiğiniz disposition'ı kaydeder; bu yanıtı ITG'ye (onların portalı veya kanalı) iletmek ve herhangi bir aşağı akış müşteri bildirimi, bu yüzeyin dışındaki eylemlerinizdir. Bu sınır kasıtlıdır: uyumluluk vaka-izleme asla bir giden yolu haline gelmemelidir. ## Erişim kontrolü, denetim ve depolama * **Roller.** Yazışlar (`POST /traceback`, `/acknowledge`, `/respond`) **owner veya admin** rolünü gerektirir, uyumluluk yazma yüzeyinin geri kalanıyla aynı. Okumalar herhangi bir kimliği doğrulanmış organizasyon üyesine açıktır. * **Denetim izi.** Her durum değişikliği kalıcı bir [denetim log](/compliance/consent-management) girişi yazar — `compliance.traceback.received`, `compliance.traceback.acknowledged` ve `compliance.traceback.responded` — etkileyen kullanıcı, ITG referansı ve (bir yanıtta) disposition ve son tarihin karşılanıp karşılanmadığı ile birlikte. Karışmış numara denetim detaylarında maskelidir. * **Depolama.** Vakalar, organizasyonunuzun ayarlarında sunucu tarafından üretilen, vaka başına bir anahtarla saklanır; böylece farklı vakalarda (veya diğer ayarlarında) eşzamanlı çalışan iki ekip üyesi birbirini ezmez. ## SLA'yı izleme Liste endpoint'ini operasyon döngünüze dahil edin, böylece bir ihlal asla sürpriz olmaz: 1. `GET /traceback` çağrısını düzenli aralıklarla yoklayın (bir iş günü penceresi için saatlik yeter). 2. Herhangi bir açık vaka `sla.status: "due_soon"` veya `sla.status: "breached"` ya da `sla.breached: true` raporladığında uyarı verin. 3. Bir ihlal görünürse uyumluluk sahibini çağırın — gecikmiş bir traceback, operatörlerin ve FCC'nin en ağır değerlendirdiği işarettir. [Uyumluluk Sağlık Skorları](/compliance/compliance-health) yüzeyini güçlendiren aynı `GET`-anında karar deseni burada da geçerlidir: skorlar sizi operatör kısmasından önce uyarır ve traceback kararları sizi bir tırmanıştan önce uyarır — her ikisini de uyumluluk duruşunuza erken uyarı beslemeleri olarak ele alın. *** ## İlgili referanslar * [Panelde ITG traceback iş akışı](/guides/compliance-traceback-itg) — **Ayarlar → Uyumluluk → ITG Traceback** konsolunun operatör kılavuzu. * [STIR/SHAKEN attestation](/channels/voice/stir-shaken) — traceback yükümlülüğünü yaratan imzalama, attestation seviyeleri ve sahip olduğunuz kontroller. * [Gönderim Kapıları](/compliance/send-gates) — gönderim anında çalışan sessiz saatler, DNC, RND ve RMD kontrolleri. * [Uyumluluk Sağlık Skorları](/compliance/compliance-health) — organizasyonunuz, gönderenleriniz ve kampanyalarınız için 0–100 risk skorları. * [Uyumluluk Duruşu Genel Bakış](/compliance/posture-overview) — bireysel uyumluluk yüzeylerinin nasıl bir araya geldiği. * [API Başvurusu → Uyumluluk](/api-reference/endpoints/compliance) — tam istek/yanıt şemaları (canlı API'den yeniden üretilir).