واجهة برمجة تطبيقات الإشارات (Signals API) · الإصدار الأول v1

إشارات الشراء الفندقية، تُسلَّم كبيانات

نفس إشارات المشتريات المتحقَّق منها بشرياً والتي تعتمد عليها تقاريرنا ربع السنوية — الافتتاحات، وأعمال التجديد، والتغييرات في الإدارة العليا — نقدمها بصيغة JSON مهيكلة يمكن لنظام CRM لديكم التعامل معها: للتحقق من التكرارات، وتوزيع العملاء المحتملين على المناطق البيعية، وإنشاء العملاء المحتملين تلقائياً.

طلب الوصول إلى واجهة برمجة التطبيقات (API) ← عرض التقرير المجاني

GET https://www.innlead.ai/api/v1/signals?since=2026-06-01&market=Saudi%20Arabia

{
  "meta": {
    "provider": "InnLead.ai",
    "schema_version": "1.0",
    "verified_signal_count": 33,
    "dedupe_key": ["property", "market",
                   "event_type", "source_url"]
  },
  "signals": [{
    "signal_id": "INL-2026Q3-001",
    "event_type": "NEW_OPENING",
    "market": "Saudi Arabia",
    "property": "NH Riyadh Prime Square",
    "event_date": "2026-06-29",
    "buying_window_note": "Design and casegoods
      specification is years out — the earliest
      relationship window for FF&E suppliers.",
    "source_url": "https://...",
    "rating": null
  }]
}

المرجع

نقطة نهاية واحدة، وثلاثة فلاتر

قوموا بالمصادقة باستخدام مفتاح API الخاص بكم في ترويسة Authorization: Bearer. يمكنكم الاستعلام وفقاً لجدولكم الزمني — تتحدث تغذية البيانات (Feed) فور اجتياز دفعة جديدة من الإشارات للتحقق البشري، كما يسهل معامل since عملية سحب البيانات التدريجية بشكل كبير.Authorization: Bearersince

المعامل الشكل آلية العمل
since YYYY-MM-DD فقط الإشارات التي يقع تاريخ حدثها في هذا التاريخ أو بعده.
market e.g. Saudi Arabia تحديد سوق واحد أو أكثر. قابل للتكرار.
event_type NEW_OPENING · RENOVATION · MANAGEMENT_CHANGE تحديد نوع إشارة واحد أو أكثر. قابل للتكرار.

كل إشارة تتضمن

signal_id

معرّف فريد ثابت — استخدموه لتتبع عمليات التسليم وتجنّب إعادة المعالجة.

event_type

NEW_OPENING (افتتاح جديد) أو RENOVATION (تجديد) أو MANAGEMENT_CHANGE (تغيير في الإدارة).

market / territory

السوق محدد مسبقًا؛ ويتم ربط المنطقة بهيكل مبيعاتكم أثناء التهيئة الأولية.

property, event_date, detail

الحقيقة المتحقَّق منها: أي منشأة، ومتى، وما الذي حدث بالضبط.

buying_window_note

ما تعنيه الإشارة بالنسبة للمورّد — أي فئة يجري تحديد مواصفاتها ومتى ينبغي التحرك.

source_name / source_url

كل إشارة مرتبطة بمصدرها العام الأصلي. لا صفوف مبنية على النمذجة ولا تخمينات مستخلَصة آليًا.

rating

مُحدَّدة بالتعاون مع فريقكم وفق معاييركم الخاصة (مرحلة المشروع، الحجم، مدى صلة الفئة).

التسليم

اختاروا الوحدات البرمجية التي تناسب بنيتكم التقنية

نطاق العمل قائم على وحدات — ابدؤوا ببيانات الإشارات، ثم أضيفوا وحدات التسليم وربط أنظمة CRM مع تطور عملياتكم. لا توجد قائمة أسعار معلنة: أخبرونا بطبيعة أنظمتكم وسنقدم لكم عرض سعر مخصصاً لنطاق العمل المطلوب بدقة.

بيانات JSON Feed

مُدرَج ضمن الباقة

نقطة نهاية REST مؤمَّنة بالمصادقة تستعلم منها أنظمتكم وفقاً لجدولكم الزمني. تتضمن فلاتر حسب السوق، ونوع الإشارة، والتاريخ. مع مفتاح مُعلَن لإزالة التكرار (Dedupe Key) للتحقق من التكرارات في نظام CRM لديكم.

التسليم عبر Webhook

متوفر

دفعات موقَّعة رقمياً لإشارات جديدة كلياً ومتحقَّق منها، تصل إلى نقطة النهاية لديكم فور اجتياز الدفعة للتحقق البشري. متوافق مع أي برمجيات وسيطة للربط والتكامل.

HubSpot / Salesforce

عند الطلب

إنشاء العملاء المحتملين مباشرة مع معالجة تلقائية مدمجة للتكرار — إدراج/تحديث (Upsert) عبر المعرّف الخارجي (external-ID)، وتعيين الحقول وفق مخططكم، ومرحلة مسار المبيعات لديكم.

SAP Sales Cloud

شريك تطوير

إنشاء تلقائي للعملاء المحتملين عبر OData، مع التحقق من صحة عملية الإنشاء في بيئة الاختبار (Sandbox Tenant) لديكم قبل ترحيل أي شيء إلى بيئة الإنتاج الفعلية. تم تطويره بالتعاون مع فريق التكامل لديكم.

جودة البيانات

متحقَّق منها بشرياً، ومربوطة بالمصدر، ومحددة الإصدار

يقوم محركنا بمسح أكثر من 65 مصدراً في قطاع الضيافة يومياً، ولكن لا شيء يصل إلى واجهة برمجة التطبيقات (API) بشكل تلقائي بالكامل — حيث يتم التحقق من كل إشارة بمراجعة بشرية قبل تسليمها، ويرتبط كل صف بمصدره العام. هيكل البيانات (schema) محدد الإصدار، مما يضمن استمرارية عمل عمليات التكامل الحالية لديكم دون انقطاع.

  • مفتاح مُعلَن لإزالة التكرار (Dedupe Key) في كل حزمة بيانات، مصمم للتحقق من التكرارات مقابل سجلات CRM الحالية لديكم.
  • حقول التصنيف والمناطق البيعية محددة بالتعاون مع فريق المبيعات لديكم، لكي تتحدث البيانات بلغة مسار المبيعات لديكم.
  • لا توجد أرقام وهمية أو مبالغ فيها. إذا كان الربع يحتوي على 33 إشارة متحقَّق منها، فإن واجهة برمجة التطبيقات (API) ستعرض 33 فقط.

التقييم

كيف يعمل المشروع التجريبي

يتم الاتفاق على معايير النجاح قبل البدء لضمان موضوعية التقييم — بما في ذلك نسبة العملاء المحتملين الجدد كلياً، ودقة البيانات، وتغطية المناطق البيعية.

01

اختبار رجعي على البيانات التاريخية (Back-test)

نحو أسبوعين

تختارون المناطق البيعية وفئات المشاريع المطلوبة، ونقوم بتسليم مجموعة الإشارات الكاملة لآخر 90 يوماً بصيغة JSON. يقوم فريقكم بالتحقق من التكرارات مقابل نظام CRM لديكم، ونقيس معاً نسبة العملاء الجدد كلياً، والدقة، والتغطية.

02

التشغيل التجريبي

4–6 أسابيع

تسليم أسبوعي للإشارات المتحقَّق منها حديثاً مع تحديد التصنيف والمنطقة البيعية وفقاً للتعريفات المتفق عليها. مع إمكانية الإنشاء التلقائي للعملاء المحتملين في بيئة الاختبار (sandbox) لنظام CRM لديكم.

هل أنتم مستعدون لاختباره مع نظام CRM لديكم؟

أخبرونا بالمناطق البيعية وفئات المشاريع ونظام CRM المستخدم لديكم. وسنقوم باقتراح مشروع تجريبي محدد النطاق وإصدار مفتاح واجهة برمجة التطبيقات (API) الخاص بكم.

طلب الوصول إلى واجهة برمجة التطبيقات (API) ←