أداة الدعم (Widget)
تضيف الأداة (widget) إلى موقعكم الإلكتروني زر دعم عائمًا. يفتحه زائر الموقع، ويملأ النموذج، فيتحول الطلب إلى تذكرة لدى المستأجر (tenant) الخاص بكم في exoCortex.
تثبيت الأداة
Section titled “تثبيت الأداة”- احصلوا على المفتاح العام للأداة (
pk_…) الخاص بمستأجركم: ⟦DA FORNIRE⟧ المسار في exoCortex Core لإنشائه. - أضيفوا هذا النص البرمجي إلى صفحات موقعكم، مع استبدال رمز المستأجر والمفتاح:
<script src="https://exocortex-api.ai-exo-cortex.com/widget.js?tenant=ACME&key=pk_live_3f9a1c2e" async></script>يُدرج النص البرمجي الزر؛ ويُفتح النموذج في إطار iframe يقدّمه exoCortex.
يمكن أن يبقى المفتاح العام في شيفرة الصفحة: فهو لا يسمح إلا بإرسال الطلبات من الأداة إلى مستأجرها. لا تستخدموا أبدًا مفتاح API من نوع nhk. بدلًا منه.
إذا كان لموقعكم سياسة أمان المحتوى (Content Security Policy)، فاسمحوا بـ https://exocortex-api.ai-exo-cortex.com للنصوص البرمجية (script-src) ولإطارات iframe (frame-src).
ما الذي يملؤه الزائر
Section titled “ما الذي يملؤه الزائر”| الحقل | إلزامي | ملاحظات |
|---|---|---|
| البريد الإلكتروني | نعم | |
| الاسم | لا | |
| الموضوع | نعم | حتى 200 حرف |
| الوصف | نعم | حتى 4000 حرف |
| الفئة | لا |
ترسل الأداة أيضًا عنوان الصفحة التي انطلق منها الطلب.
الحماية من إساءة الاستخدام
Section titled “الحماية من إساءة الاستخدام”- يمكن لكل عنوان IP إرسال 30 طلبًا في الساعة كحد أقصى لكل مستأجر. وبعد ذلك تتلقى الأداة الخطأ
429. - إذا فعّل مستأجركم Cloudflare Turnstile، يطلب النموذج تحققًا من أن المستخدم ليس روبوتًا قبل الإرسال.