ForHosting KIT · أدوات المطورين

تقدير مخاطر تجديد العقد من صحة العميل

تحوّل هذه الأداة مؤشرين شائعين لنجاح العميل إلى فئة متسقة لمخاطر التجديد: منخفضة أو متوسطة أو مرتفعة.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخل درجة صحة العميل بين 0 و100، والعدد الصحيح للأيام المتبقية حتى التجديد. تتبع النتيجة قاعدة عتبات واضحة، ولذلك تصلح لتحديد الأولويات وإعداد التقارير وتوجيه مسارات العمل ومراجعة المحافظ بصورة دورية. لا تدّعي الأداة حساب احتمال دقيق للتجديد، بل تقدم تصنيفاً تشغيلياً يمكنكم فهمه ومراجعته وتطبيقه بصورة موحدة.

فهم قاعدة التصنيف

تقيّم الأداة صحة العميل وقرب موعد التجديد معاً. تكون المخاطر مرتفعة إذا كانت درجة الصحة أقل من 50 أو إذا بقي على التجديد 30 يوماً أو أقل. وإذا لم تنطبق قاعدة المخاطر المرتفعة، تكون المخاطر متوسطة عندما تقل الدرجة عن 75 أو يتبقى 90 يوماً أو أقل. ولا تُصنف المخاطر على أنها منخفضة إلا إذا بلغت الدرجة 75 على الأقل وبقي أكثر من 90 يوماً. تحكم الإشارة الأكثر إلحاحاً النتيجة دائماً؛ فالصحة الممتازة لا تلغي ضرورة التعامل مع تجديد يحين خلال أسبوع، كما أن طول المهلة لا يخفي درجة صحة شديدة الضعف. هذه العتبات قاعدة بسيطة قابلة للتفسير وليست نموذجاً إحصائياً. لذلك يمكن إعادة إنتاج كل نتيجة من المدخلين من دون أوزان خفية أو بيانات تدريب تاريخية أو تفسير شخصي.

إعداد مدخلات موثوقة

استخدموا تعريفاً ثابتاً لدرجة الصحة من 0 إلى 100 لدى جميع العملاء الذين تجري مقارنتهم. فإذا كانت وحدة أعمال تقيس نشاط المنتج وحده بينما تمنح وحدة أخرى وزناً كبيراً لتجربة الدعم، فقد تبدو الفئات قابلة للمقارنة مع أن القياسات الأصلية مختلفة. وثّقوا طريقة الحساب وحدّثوا الدرجات وفق جدول منتظم. أدخلوا العدد الصحيح للأيام التقويمية حتى تاريخ التجديد التعاقدي؛ وتعني القيمة 0 أن التجديد يحين اليوم. تُرفض القيم السالبة لأنها تصف تاريخاً مضى وتحتاج إلى مسار مختلف لمعالجة التجديد المتأخر أو فقد العميل. كما تُرفض القيم المفقودة وغير الرقمية وغير المحدودة، والدرجات الواقعة خارج النطاق، وكسور الأيام. قبل معالجة محفظة، تحققوا من التاريخ الصحيح، ولا سيما في العقود المعدلة والتمديدات والاتفاقيات التي يختلف فيها تاريخ الإشعار عن تاريخ التجديد الفعلي.

استخدام الفئة كإشارة تشغيلية

تعاملوا مع المخرجات بوصفها أداة لتحديد الأولويات، لا توقعاً مضموناً ولا بديلاً عن معرفة فريقكم بالحساب. قد يحتاج العميل مرتفع المخاطر إلى مراجعة فورية أو خطة تجديد مؤكدة أو دعم تنفيذي أو معالجة مشكلات التبني والدعم. وغالباً ما يستفيد العميل متوسط المخاطر من تواصل مجدول ومراجعة خطة النجاح وإشراك الأطراف التجارية مبكراً. أما انخفاض المخاطر فلا يلغي إدارة التجديد المعتادة؛ بل يعني فقط أن أياً من العتبات لا يشير حالياً إلى خطر متزايد. ولأن القاعدة حتمية، يمكنكم تشغيلها مراراً وتتبع تغير الفئة مع تغير الصحة واقتراب الموعد. احتفظوا بالمدخلين بجانب الفئة في التقارير حتى يتضح سبب النتيجة. وإذا اعتمدت مؤسستكم لاحقاً نموذجاً تنبؤياً معايراً، فقارنوا نتائجه بهذا الخط الأساس ولا تفسروا هذه الفئات على أنها احتمالات مقاسة.

حالات الاستخدام

ترتيب أولويات محفظة التجديد

صنّفوا الحسابات قبل المراجعة الأسبوعية لتبدأوا بالحالات الأكثر إلحاحاً التي تجمع بين ضعف الصحة وقرب التجديد.

توجيه إجراءات مسار العمل

وجّهوا المخاطر المرتفعة إلى تدخل فوري، والمتوسطة إلى تواصل مخطط، والمنخفضة إلى دورة التجديد المعتادة.

إنشاء خط أساس قابل للتفسير

قارنوا أي نموذج تنبؤي مستقبلي بقاعدة شفافة يمكن دائماً إعادة بناء نتيجتها من قيمتين.

الأسئلة الشائعة

هل تعيد الأداة احتمالاً دقيقاً للتجديد؟

لا. إنها تعيد فئة تشغيلية تستند إلى عتبات صريحة، وليست نسبة احتمال معايرة إحصائياً.

ما الذي ينتج مخاطر مرتفعة؟

درجة صحة أقل من 50 أو بقاء 30 يوماً أو أقل حتى التجديد. يكفي تحقق أحد الشرطين.

ما الذي ينتج مخاطر متوسطة؟

إذا لم تنطبق قاعدة المخاطر المرتفعة، تنتج المخاطر المتوسطة عن درجة أقل من 75 أو بقاء 90 يوماً أو أقل.

لماذا تُرفض الأيام السالبة؟

لأنها تعني أن تاريخ التجديد قد مضى، وهذه الحالة تخص مسار التجديد المتأخر أو تحليل فقد العميل لا التصنيف المسبق.

هل يمكن استخدام درجة صحة عشرية؟

نعم. يُقبل أي عدد محدود من 0 إلى 100، بما في ذلك الكسور العشرية. ويجب أن يكون عدد الأيام صحيحاً.

ما تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن أيضاً تنفيذ الحساب الحتمي نفسه داخل المتصفح.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/biz/renewal-probability-estimate

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/biz/renewal-probability-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"health_score":82,"days_until_renewal":120}'

const res = await fetch("https://api.kit.forhosting.com/biz/renewal-probability-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "health_score": 82,
    "days_until_renewal": 120
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/renewal-probability-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "health_score": 82,
    "days_until_renewal": 120
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/renewal-probability-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"health_score":82,"days_until_renewal":120}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"health_score":82,"days_until_renewal":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/renewal-probability-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "health_score": 82,
  "days_until_renewal": 120
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.renewal_probability_estimate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←