> ## 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: معالجة طلبات أرقام الأصل > سجّل وأقر وأعلم طلبات مجموعة استكشاف الصناعة الملتصقة بأرقام الأصل — دورة حياة القضية، وموعد الاستجابة SLA 24 ساعة، والتعهدات التي تقدمها. # معالجة قضايا استكشاف ITG توقيع حركة الصوت الأمريكية الصادرة بـSTIR/SHAKEN الاعتماد يحمل التزاماً صادراً: عندما يكون أحد أرقام الأصل ملتصقاً بشكوى مكالمات آليّة، يمكن لـ ITG (مجموعة استكشاف الصناعة) أن ترسلك **طلب استكشاف** يطلب منك تحديد مصدر المكالمة، وأنت متوقع أن تستجيب، عادةً في حدود 24 ساعة تقريباً (يوم عمل واحد). Orbit توفر سطح إدارة القضية لذلك التزام: مكان لتسجيل كل طلب ITG صادر، والإقرار به، وتقديم تعهدك، ومراقبة موعد الاستجابة. كل تحكم في هذه الصفحة **مملوك للمستأجر** — أنت تسجل الطلب، وأنت تقرر التعهد، وأنت تقدمه مع الـITG. جميع نقاط النهاية أدناه متجذرة في `https://api.orbit.devotel.io/api/v1/compliance`. استجابة الاستكشاف هي جزء من تخفيف المكالمات الآلية التابع لـFCC تحت TRACED Act (ITG تشغلها USTelecom تحت إطار FCC). التجاهل المستمر لطلبات الاستكشاف هو بذاته علم امتثال أحمر يمكن أن يؤدي إلى تنفيذ وقطع الاتصال عن الشركات. هذه الصفحة ليست مشورة قانونية — أكِّد التزاماتك ومواعدك للاستكشاف مع مستشارك القانوني. *** ## لماذا الاعتماد يُنشئ هذه التزام STIR/SHAKEN هو إطار مصادقة هوية المتصل الذي تفرضه FCC لحركة الصوت الأمريكية. كل مكالمة صادرة تُقدمها عبر Orbit يُعيّن لها مستوى اعتماد (A، أو B، أو C) عند التوقيع — انظر [اعتماد STIR/SHAKEN](/channels/voice/stir-shaken) لما تعنيه تلك المستويات وكيف تصل إليها Orbit. لأن حركتك الموقعة يمكن إرجاعها إليك، يمكن للمزوّدين المنسوب و ITG (إطار ATIS/FCC للاستكشاف) أن يسألوا من أين جاءت مكالمة ملتصقة من. الرد على تلك الطلبات سريعاً والحفاظ على سجل لما وجدت هو جزء من واجبات تخفيف المكالمات الآلية الملتزمة مع إنشاء حركة موقعة. ## دورة حياة القضية كل قضية استكشاف تتحرك في أربع حالات: | من \ إلى | `acknowledged` | `responded` | `closed` | | ---------------- | -------------- | ----------- | -------- | | `received` | نعم | نعم | نعم | | `acknowledged` | — | نعم | نعم | | `responded` | — | — | نعم | | `closed` (نهائي) | — | — | — | * `received` — طلب ITG مسجل، غير مُعمل بعد. * `acknowledged` — أنت أكّدت العناية لـITG. * `responded` — أنت قدمت تعهدك مع ITG. * `closed` — القضية منتهية (نهائي؛ لا يوجد مزيد من الانتقالات). انتقال غير صالح (مثل إطاقة `closed` قضية إقرار، أو استجابة مرتين) يُرجع `409` مع `TRACEBACK_INVALID_TRANSITION`. ## موعد الاستجابة SLA كل قضية تحمل ساعة موعد استجابة. النافذة الافتراضية هي **24 ساعة** من `received_at`، التي هي الترميز المحافظ لتوقع ITG ليوم عمل واحد. يمكن ضبط نافذة أضيق أو أوسع لكل قضية بـ`sla_hours` (حتى 720) عندما يذكر ITG موعداً مختلفاً. أنت لا تستعلم حالة SLA مباشرة أبداً — كل `GET` على سطح الاستكشاف يُلحق كل قضية بحكم **حي** محسوب وقت القراءة: ```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` | المعنى | | ---------- | ----------------------------------------------------------------------- | | `on_track` | مفتوح، معارض مريح للموعد. | | `due_soon` | مفتوح، بضمن 4 ساعات من الموعد. | | `met` | استجاب على الموعد أو قبلها. | | `breached` | الموعد انقضى بدون استجابة، أو الاستجابة كانت متأخرة (`breached: true`). | | `unknown` | طابع وقت الاستلام غير قابل للتحليل، لذا لا يمكن حساب الموعد. | ## معالجة طلب استكشاف، خطوة بخطوة كل كتابة أدناه تتطلب دوراً **مالك أو مسؤول**؛ القراءة متاحة لأي مستخدم مصدق عضوي. ### 1. سجّل الطلب الصادر عندما يصل طلب ITG للاستكشاف، سجّله لبدء الساعة. قدّم مرجع ITG، رقم الأصل الملتصق (E.164)، واختيارياً وصف حملة منشورة، ومستوى الاعتماد معلن على تلك الحركة، وموعد مخصص. ```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" }' ``` القضية نُنشِئت في حالة `received` وموعد 24 ساعة يبدأ من وقت التسجيل. احفظ `id` من الاستجابة للخطوات التالية. ### 2. إقر أنك استلمتها أكِّد لـITG أن الطلب يُعمَل. هذا يُحرّك القضية إلى `acknowledged` وهو اختياري — يمكن الاستجابة مباشرة من `received`. ```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. قدّم استجابتك ممر واحتكت، سجّل التعهد. هذا يُوقف ساعت موعد الاستجابة ومع `"close": true` يُغلق القضية في نفس المكالمة. ```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 }' ``` ### التعهدات اختر التعهد الذي يجيب على "ماذا فعلت مع الحركة الملتصقة؟": | تعهد | المعنى | | --------------------- | --------------------------------------------- | | `source_identified` | حدّدت المصدر الأصلي/الزبون وقدمته إلى ITG. | | `customer_notified` | أزعجت العميل الملتصق. | | `customer_terminated` | قطّعت العميل أو الحملة الملتصقة. | | `number_disabled` | عطّلت رقم الأصل الملتصق. | | `not_originated_here` | الحركة لم تنشئ في حسابك. | | `no_action` | راجعتها وولّيتها بدون إجراء (شرح في `notes`). | ### 4. راجع القضايا اعرض كل قضية بحكم SLA الحي، أو اجلب قضية واحدة بمعرف: ```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" ``` تُعرض القضايا بأحدث طلب أولاً، لذا أي قضية مفتوحة تقترب من موعدها مرئية من الصفحة الأولى. *** ## سطح أرشفة السجلات فقط سطح الاستكشاف **يتلقى ويقترف ويسجل** — لا شيء آخر. تسجيل قضية، والإقرار بها، وتقديم استجابة يُحفظ حالة؛ لا تُقدم مكالمات، ولا تُرسل رسائل، ولا تُتصل بـITG أو العميل الملتصق لك. تقديم استجابة يسجّل التعهد الذي اخترته؛ توصيل تلك الاستجابة إلى ITG (مدخلهم أو قناتهم) وأي تبليغ للعميل يبقى إجراءاتك، خارج هذا سطح. هذا الحدود هو مقصود: tracking قضية امتثال لا يجب أن تصبح مساراً إخراجاً. ## التحكم في الوصول، التدقيق، والتخزين * **الأدوار.** كتابة (`POST /traceback`، و`/acknowledge`، و`/respond`) تتطلب دوراً **مالك أو مسؤول**، يحاكي بقية سطح امتثال كتابة. القراءة متاحة لأي عضو مصدق. * **مسار التدقيق.** كل تغيير في الحالة يكتب إدخال سجل التدقيق دائم — `compliance.traceback.received`، و`compliance.traceback.acknowledged`، و`compliance.traceback.responded` — مع المستخدم الذي يعمل، والمرجع ITG، و(عند الاستجابة) التعهد وهل الموعد نُفي. الرقم الملتصق مُخفّ في تفاصيل التدقيق. * **التخزين.** القضايا تُخزّن على إعدادات منظمتك بحرف خادم-مولّد لكل قضية، لذا زملاء يعملون قضايا مختلفة أو إعدادات أخرى لا يتجاسون أحد الآخر. ## مراقبة SLA بنّي نقطة العرض في حلقة ops الخاصة بك حتى لا تُفاجئك خروق: 1. استعلم `GET /traceback` على إيقاع كوي (كل ساعة كافية لنافذة يوم عمل). 2. أشعر عندما تقرأ أي قضية في `sla.status: "due_soon"` أو `sla.status: "breached"`، أو `sla.breached: true`. 3. أذعّل مالك الامتثال عندما يظهر خروق — الاستكشاف المٌbakك هو الإشارة التي تزنها الشركات وFCC بأثنى. نفس نمط الحكم وقت القراءة الذي يُشغّل صفحة [درجات صحة الامتثال](/compliance/compliance-health) يُطبق هنا: الدرجات تحذرك قبل الازدحام الشركات، والحكمات الاستكشافية تحذرك قبل التصعيد — عمِل كلاهما كتغذيات تحذير مبكري في وضع امتثالك. *** ## المرتبط * [سير عمل الاستكشاف ITG في لوحة](/guides/compliance-traceback-itg) — دليل العامل للكونسول في **الإعدادات → الامتثال → الاستكشاف ITG**. * [اعتماد STIR/SHAKEN](/channels/voice/stir-shaken) — التوقيع الذي يُنشئ التزام الاستكشاف، ومستويات الاعتماد والتحكمات التي تمتازك. * [بوابات الإرسال](/compliance/send-gates) — أوقات الهدوء وDNC وRND و RMD التي تُفحص وقت الإرسال. * [درجات صحة الامتثال](/compliance/compliance-health) — درجات المخاطر 0–100 لمنظمتّك ومرسلتك والحملاتك. * [نظرة عامة لوضع الامتثال](/compliance/posture-overview) — كيف تُتنسّق surfaces امتثال الفرعية. * [مرجع API → الامتثال](/api-reference/endpoints/compliance) — مخططات الطلب/الاستجابة (وُلّدت من API الحية).