ARN Smart Support
اللغة: العربية

فتح التذاكر من تطبيقاتك الخاصة (واجهة API للتذاكر)

تحديث 19 نوفمبر 2026 قراءة في 1 دقيقة
تصفح مقالات Ticketix

يمكن لتطبيقاتك الخاصة، مثل إضافة أو تطبيق سطح مكتب أو موقع ويب، فتح تذاكر لمستخدميها وإرسال تفاصيل تقنية معها، مثل إصدار التطبيق أو الخادم. يحصل كل تطبيق على مفتاحه الخاص. وعند إلغاء مفتاح، يتوقف ذلك التطبيق فورًا.

أين تجده: الإعداد ← الدعم ← مفاتيح التطبيقات (للمسؤولين فقط).

إنشاء مفتاح تطبيق

  1. افتح الإعداد ← الدعم ← مفاتيح التطبيقات.
  2. أدخل اسم التطبيق، مثل WordPress plugin. يرى الموظفون هذا الاسم كقناة للتذاكر التي يفتحها.
  3. اختر المنتج عندما لا يحدد الطلب منتجًا، أو يجب أن يحدد الطلب المنتج.
  4. انقر على إنشاء مفتاح.
  5. انسخ المفتاح الآن واحفظه في إعدادات التطبيق. يُعرض المفتاح هذه المرة فقط؛ إذ لا يحتفظ Ticketix إلا بقيمة مُجزّأة (hash) منه.

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

فتح تذكرة

أرسل طلب POST بمحتوى JSON إلى /api/ticket-create.php ضمن عنوان التثبيت لديك، على سبيل المثال https://support.example.com/api/ticket-create.php. أرسل المفتاح في الترويسة Authorization: Bearer، أو في X-Ticketix-Key إذا كان خادمك يحذف الترويسة Authorization.

POST /api/ticket-create.php
Authorization: Bearer tkx_…
Content-Type: application/json

{
  "email": "customer@example.com",
  "name": "Customer Name",
  "product": "helpdesk",
  "subject": "Licence shows Inactive after moving the site",
  "message": "We moved the site to a new domain …",
  "priority": "normal",
  "technical_details": {
    "WordPress": "6.8",
    "PHP": "8.3",
    "Plugin version": "2.0.2"
  }
}
الحقلمطلوبالمعنى
emailنعمعنوان البريد الإلكتروني للعميل؛ يُنشأ عميل جديد إذا كان العنوان غير معروف
nameلااسم العميل، حتى 120 حرفًا
productلامفتاح منتج؛ وفي حال غيابه يُستخدم منتج المفتاح
subjectنعمحتى 200 حرف
messageنعمنص عادي، حتى 20,000 حرف
priorityلاlow أو normal (الافتراضي) أو high
technical_detailsلاحتى 30 اسمًا وقيمة؛ الاسم حتى 60 حرفًا والقيمة حتى 500 حرف؛ والقيم نصوص أو أرقام أو true وfalse

يمكن أن يصل حجم محتوى الطلب إلى 64 كيلوبايت.

ما يحدث للتذكرة

  • تُفتح التذكرة فورًا؛ فالمفتاح يضمن موثوقية الطلب، ولذلك لا يوجد تحقق عبر البريد الإلكتروني.
  • يتلقى العميل رسالة تم إنشاء التذكرة المعتادة مع رابط التذكرة، ويتلقى فريق العمل الإشعارات المعتادة.
  • تُطبَّق قواعد التوجيه وسير العمل وسياسات SLA والفرز بالذكاء الاصطناعي كما في أي تذكرة جديدة.
  • تعرض شاشة التذكرة اسم التطبيق بوصفه القناة، مع عبارة "مع تفاصيل تقنية"، وتظهر التفاصيل التقنية أسفل الرسالة الأولى ("أُرسلت بواسطة" واسم التطبيق). ويرى العميل التفاصيل نفسها في تذكرته.

الاستجابات

الحالةالمعنى
201فُتحت التذكرة؛ وتتضمن الاستجابة ticket_no وstatus
401المفتاح مفقود أو خاطئ أو ملغى
405الطلب ليس من نوع POST
413حجم المحتوى أكبر من 64 كيلوبايت
415المحتوى ليس بصيغة JSON (Content-Type: application/json)
422أحد الحقول غير صحيح؛ يذكر fields كل حقل مع السبب
429عدد كبير جدًا من التذاكر: 60 في الساعة لكل تطبيق و10 في الساعة لكل عميل

على خادم Nginx، يجب أن يشغّل الخادم PHP في المجلد api؛ راجع متطلبات خادم Ticketix.

مقالات ذات صلة

في هذه الصفحة

إرسال طلب

أنشئ طلب دعم جديدًا دون الحاجة إلى حساب.

الأولوية
المرفقات
لا يرى الطلب إلا أنت وفريقنا. لا ترسل كلمات المرور أو رموز الترخيص.

تتبع الطلب

استخدم رقم الطلب وكلمة المرور من رسالة التأكيد.

الرقم وكلمة المرور في رسالة التأكيد.

تسجيل الدخول

ادخل إلى حساب بوابة الدعم الخاص بك.

جديد هنا؟

إنشاء حساب

أنشئ حسابك في بوابة الدعم.

لديك حساب بالفعل؟

نسيت كلمة المرور؟

نرسل إليك رابطًا لاختيار كلمة مرور جديدة.

المحادثة

هل كان هذا مفيدًا؟
فتح المقالة كاملة
↑ ↓ للتنقلEnter للفتحEsc للإغلاق