أرسل أي نص، واحصل على درجة مشاعر من 1 إلى 10
مصمَّمة للمطوّرين الذين يدمجون مكتب المساعدة أو نظام CRM أو منتجهم الخاص: أرسل حدثًا واحدًا عبر POST إلى واجهة /ingest الخاصة بـ SentiTrack، فينساب إلى مخطط الشبكة ومخطط الزمن والتقارير والتنبيهات نفسها التي تستخدمها كل قناة أخرى. إن كان نصًا، فبإمكان SentiTrack تقييمه.
واجهة استقبال البيانات في SentiTrack هي نقطة نهاية REST خاصة بكل مؤسسة ومُصادَق عليها بمفتاح API (POST /api/v1/ingest/sentiments) تقبل أي رسالة نصية من مكتب المساعدة أو نظام CRM أو منتجك الخاص وتحوّلها إلى حدث مشاعر من 1 إلى 10. يصبح كل استدعاء واحد سجلًّا واحدًا ينساب إلى مخطط الشبكة ومخطط الزمن والتقارير والتنبيهات لديك.
أصدق إشاراتك محتجزة داخل أنظمة مخصّصة
البريد الإلكتروني والمكالمات والمحادثات مغطّاة جاهزة من دون إعداد — لكن النبرة داخل تذاكر مكتب المساعدة الخاصة بك وملاحظات CRM والرسائل داخل المنتج لا تصل أبدًا إلى لوحات معلوماتك. ومن دون وسيلة لدفع تلك الرسائل، تبقى كل قناة مخصّصة نقطة عمياء، ولا يظهر التوتر المتنامي فيها إلا بعد أن يكلّفك عميلًا أو زميلًا في الفريق.
نقطة نهاية واحدة لأي شيء نصّي
تمنح واجهة /ingest المطوّرين وسيلة محصورة بالمستأجر لتغذية أي رسالة إلى SentiTrack. صادِق باستخدام مفتاح API خاص بالمؤسسة، وأرسل عبر POST حدثًا يتضمّن قناة المصدر، والمُرسِل، والمُستقبِل، والنص، فيقيّمه SentiTrack من 1 إلى 10 ويوجّهه إلى مسار التحليلات نفسه الذي يستخدمه البريد الإلكتروني والصوت والمحادثة. تُقيَّم النصوص ثم تُتلَف — ولا يُحتفظ إلا بالدرجة والمشاركين والطابع الزمني والاتجاه وتجزئة الموضوع.
- المصادقة بمفتاح API خاص بكل مؤسسة — كل حدث محصور بمستأجرك، ولا يُربط أبدًا بمعرّف org_id مقدَّم من العميل
- اختر أي قناة مصدر: البريد الإلكتروني أو الهاتف أو slack أو مفتاحًا مخصّصًا تحدّده مؤسستك
- أرسِل external_id لإعادة المحاولة بأمان ودون تكرار — تُزال التكرارات ولا تُحتسب مرتين
- أحداث مفردة أو دفعات مجمّعة تصل حتى 500، بحيث تكون إعادة التعبئة مهمة واحدة لا آلاف الاستدعاءات
من نظامك إلى مخططك في ثلاث خطوات
في الإعدادات، أنشئ مفتاح استقبال خاصًا بمؤسستك. يُعرض النص الصريح مرة واحدة فقط؛ ولا يخزّن SentiTrack سوى بادئة وتجزئة. استدعِ GET /api/v1/ingest/whoami للتأكد من أن المفتاح يحيل إلى مؤسستك قبل ربطه.
أرسل حدثًا واحدًا إلى /api/v1/ingest/sentiments يتضمّن قناة المصدر، والمُرسِل، والمُستقبِل (و cc اختياريًا)، ونص الرسالة، و external_id اختياريًا. يقيّم SentiTrack النص من 1 إلى 10 بمحرّك SentiAI المضمّن، أو يمكنك تمرير درجة حسبتها مسبقًا.
يصبح الحدث سجلًّا واحدًا له موضوع واتجاه ومشاركون — ظاهر فورًا في مخطط الشبكة ومخطط الزمن وعناقيد المواضيع وتقارير PDF المجدولة والتنبيهات، جنبًا إلى جنب مع البريد الإلكتروني والصوت والمحادثة. من دون لوحة معلومات منفصلة ولا إعداد إضافي.
تذاكر مكتب المساعدة، وملاحظات CRM، والرسائل داخل المنتج، والمراجعات، ونصوص الدعم — أي محتوى نصّي يصبح حدث مشاعر من 1 إلى 10. عقد واحد يغطّي كل مصدر مخصّص يخطر ببالك.
تنساب الأحداث المُستقبَلة عبر المسار ذاته الذي يستخدمه البريد الإلكتروني والصوت والمحادثة، فتظهر في مخطط الشبكة ومخطط الزمن وعناقيد المواضيع والتقارير والتنبيهات دون أي تهيئة إضافية.
المصادقة تتم بمفتاح API خاص بكل مؤسسة، وكل حدث محصور من جهة الخادم بتلك المؤسسة. ولا يُوثَق أبدًا بمعرّفات المؤسسة المقدَّمة من العميل، فيستحيل بنيويًّا تسرّب البيانات بين المستأجرين.
مرّر external_id فتصبح إعادة المحاولة آمنة — إذ يعيد الاستدعاء المتكرر السجلَّ الموجود بدلًا من تكراره. أعِد تعبئة السجل التاريخي بدفعات مجمّعة تصل حتى 500 حدث في الطلب الواحد.
ينطبق التقييم الأصلي نفسه بسبع لغات — الإنجليزية والألمانية والفرنسية والإيطالية والإسبانية والروسية والتركية، إضافةً إلى العربية — دون إعداد أو توجيه لكل لغة من جانبك.
تُقيَّم النصوص ثم تُتلَف. لا يحتفظ SentiTrack إلا بالدرجة والمشاركين والطابع الزمني والاتجاه وتجزئة الموضوع — ولا يحتفظ أبدًا بنص الرسالة أو الموضوع أو المرفقات التي أرسلتها.
نقيّم النص، ثم نتخلّص منه
ترث واجهة الاستقبال موقف الخصوصية على مستوى المنصة بأكملها في SentiTrack. فأيًّا كانت الرسالة التي ترسلها عبر POST تُقيَّم ثم تُتلَف — ولا تُحفظ أبدًا. لا نحتفظ إلا بالدرجة من 1 إلى 10، والمشاركين، والطابع الزمني، والاتجاه، والموضوع، وتجزئة الموضوع، فلا تحمل بيانات قناتك المخصّصة مخاطر أكبر من البريد الإلكتروني.
- لا تُخزَّن أي نصوص رسائل أو نصوص مواضيع أو مرفقات — الدرجة والبيانات الوصفية فقط
- مفاتيح API الخاصة بكل مؤسسة مشفَّرة بـ Fernet أثناء التخزين؛ ولا يُحتفظ إلا ببادئة وتجزئة بعد الإنشاء
- تنطبق على الأحداث المُستقبَلة أيضًا مدة احتفاظ قابلة للتهيئة (افتراضيًا 365 يومًا) ونقطة نهاية للحذف النهائي
- قد يشكّل تخزين المشاعر مع السمات الديموغرافية بيانات تندرج تحت المادة 9 من اللائحة العامة لحماية البيانات GDPR — ويبقى تقييم أثر حماية البيانات DPIA والأساس القانوني والموافقة من مسؤولية العميل بموجب شروط الخدمة
واجهة الاستقبال للمطوّرين — الأسئلة الشائعة
كيف أرسل بيانات المشاعر إلى SentiTrack برمجيًّا؟
أرسل حدث JSON عبر POST إلى /api/v1/ingest/sentiments مصادَقًا عليه بمفتاح API خاص بكل مؤسسة. ضمِّن قناة المصدر، والمُرسِل، والمُستقبِل، ونص الرسالة، فيقيّمه SentiTrack من 1 إلى 10 ويوجّهه إلى لوحات معلوماتك. أما للسجل التاريخي، فتقبل /ingest/sentiments/bulk حتى 500 حدث في دفعة واحدة بأفضل جهد ممكن.
هل تخزّن واجهة الاستقبال نص الرسالة؟
لا. تتّبع واجهة الاستقبال موقف الخصوصية نفسه الذي تتّبعه كل قناة في SentiTrack: يُقيَّم النص ثم يُتلَف. ولا تُخزَّن إلا الدرجة من 1 إلى 10، والمشاركون، والطابع الزمني، والاتجاه، والموضوع، وتجزئة الموضوع — أما نص الرسالة أو نص الموضوع أو المرفقات التي ترسلها فلا تُخزَّن أبدًا.
كيف تتم مصادقة واجهة الاستقبال؟
بمفتاح API خاص بكل مؤسسة تنشئه في الإعدادات. يُعرض المفتاح بنصه الصريح مرة واحدة عند الإنشاء؛ ولا يخزّن SentiTrack سوى بادئة إضافةً إلى تجزئة. وكل حدث محصور من جهة الخادم بالمؤسسة المالكة للمفتاح، فلا يُوثَق أبدًا بمعرّف org_id مقدَّم من العميل، ولا يمكن للمستأجرين أن يتسرّبوا إلى بعضهم.
هل يمكنني إعادة محاولة طلب بأمان من دون إنشاء تكرارات؟
نعم. مرّر external_id مع كل حدث فيصبح الاستقبال غير قابل للتكرار: يُزال الاستدعاء المتكرر الذي يحمل {org, external_id} نفسه ويعيد السجلَّ الموجود بدلًا من إنشاء سجل ثانٍ. وهذا يجعل إعادة المحاولة وإعادة التشغيل والتسليم مرة واحدة على الأقل من طابور المهام لديك آمنًا للربط.
ما أنواع الرسائل التي يمكنني دفعها إلى واجهة الاستقبال؟
أي محتوى نصّي. تذاكر مكتب المساعدة، وملاحظات CRM، والمحادثة داخل المنتج، ونصوص الدعم، والمراجعات، والقنوات المخصّصة — كلها تعمل؛ إن كان نصًا، فبإمكان SentiTrack تقييمه. وسِم كل حدث بقناة مصدر (البريد الإلكتروني أو الهاتف أو slack أو مفتاح مخصّص) ليُجمَّع بشكل صحيح في مخطط الشبكة ومخطط الزمن لديك.
هل تظهر الأحداث المُستقبَلة في المخططات نفسها التي يظهر فيها البريد الإلكتروني؟
نعم. يصبح كل حدث مُستقبَل سجلًّا واحدًا ينساب عبر المسار ذاته الذي يستخدمه بريد IMAP والصوت والمحادثة. ويظهر في مخطط الشبكة ومخطط الزمن وعناقيد المواضيع والعروض المحفوظة وتقارير PDF المجدولة والتنبيهات، دون لوحة معلومات منفصلة ودون أي تهيئة إضافية من جانبك.
اربط رسالتك الأولى اليوم
أنشئ مفتاح API خاصًا بمؤسستك، وأرسل حدثًا واحدًا عبر POST، وشاهده يصل إلى مخطط الشبكة ومخطط الزمن لديك. أو افتح العرض التوضيحي المباشر ببيانات نموذجية — دون حاجة إلى تسجيل — لترى بالضبط أين تظهر رسائلك المُستقبَلة.