أداة الدعم
Embeddable support widget for customer websites.
برنامج الأداة النصي
Section titled “برنامج الأداة النصي”GET /widget.js
Script to include in your website. It injects a floating support button that opens
the ticket form (/widget.html) in an iframe.
<script src="https://exocortex-api.ai-exo-cortex.com/widget.js?tenant=ACME&key=pk_live_3f9a1c2e" async></script>المصادقة: لا يوجد: تتم مصادقة الطلب بالتوقيع الموضح أعلاه.
المعاملات
Section titled “المعاملات”| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
tenant |
query | string | نعم | |
key |
query | string | نعم | Public widget key. |
الاستجابات
Section titled “الاستجابات”| الحالة | الوصف |
|---|---|
200 |
JavaScript loader. |
مثال 200
(function(){ /* exoCortex widget loader */ })();مثال باستخدام curl
Section titled “مثال باستخدام curl”curl -X GET "https://exocortex-api.ai-exo-cortex.com/widget.js?tenant=ACME&key=pk_live_3f9a1c2e"نموذج الأداة
Section titled “نموذج الأداة”GET /widget.html
The HTML form rendered inside the widget iframe. You normally don’t call it directly; /widget.js loads it.
المصادقة: لا يوجد: تتم مصادقة الطلب بالتوقيع الموضح أعلاه.
المعاملات
Section titled “المعاملات”| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
tenant |
query | string | نعم | |
key |
query | string | نعم | Public widget key. |
الاستجابات
Section titled “الاستجابات”| الحالة | الوصف |
|---|---|
200 |
HTML document. |
مثال 200
<!DOCTYPE html><html>…</html>مثال باستخدام curl
Section titled “مثال باستخدام curl”curl -X GET "https://exocortex-api.ai-exo-cortex.com/widget.html?tenant=ACME&key=pk_live_3f9a1c2e"إرسال طلب من الأداة
Section titled “إرسال طلب من الأداة”POST /api/v1/widget/submit
Used by the widget form. Limited to 30 submissions per hour per client IP and tenant.
If the tenant enabled Cloudflare Turnstile, a valid cf_turnstile_token is required.
المصادقة: المفتاح العام للأداة: X-NH-Widget-Key: pk_…
محتوى الطلب
Section titled “محتوى الطلب”application/json
| الاسم | النوع | إلزامي | الوصف |
|---|---|---|---|
tenant |
string | نعم | Must match the widget key’s tenant. |
email |
string (email) | نعم | |
name |
string | لا | |
subject |
string | نعم | |
description |
string | نعم | |
category |
string | لا | |
origin |
string | لا | Page URL where the widget was used. |
cf_turnstile_token |
string | لا | Cloudflare Turnstile token. Required if the tenant enabled Turnstile. You can also send it in the X-NH-Turnstile header. |
{ "tenant": "ACME", "name": "Maria Rossi", "subject": "Cannot download my invoice", "description": "The invoice page shows an empty PDF for October.", "category": "Billing", "origin": "https://www.example.com/account", "cf_turnstile_token": "0.xY2fake-turnstile-token"}الاستجابات
Section titled “الاستجابات”| الحالة | الوصف |
|---|---|
200 |
Ticket created. |
400 |
Invalid request. |
401 |
Not authenticated. |
403 |
Authenticated but not allowed (role, tenant or key). |
429 |
Too many submissions from this IP (30 per hour). |
500 |
Unexpected server error. |
مثال 200
{ "ok": true, "ticket_key": "ACME-1043", "ingestion_id": "ing_2c71f0aa"}مثال باستخدام curl
Section titled “مثال باستخدام curl”curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/v1/widget/submit" \ -H "X-NH-Widget-Key: $EXO_WIDGET_KEY" \ -H "Content-Type: application/json" \ --data '{"tenant":"ACME","email":"[email protected]","name":"Maria Rossi","subject":"Cannot download my invoice","description":"The invoice page shows an empty PDF for October.","category":"Billing","origin":"https://www.example.com/account","cf_turnstile_token":"0.xY2fake-turnstile-token"}'صفحة مُنشأة من مواصفة OpenAPI لواجهة التكامل، الإصدار 1.1.0.