يمكن لتطبيقاتك الخاصة، مثل إضافة أو تطبيق سطح مكتب أو موقع ويب، فتح تذاكر لمستخدميها وإرسال تفاصيل تقنية معها، مثل إصدار التطبيق أو الخادم. يحصل كل تطبيق على مفتاحه الخاص. وعند إلغاء مفتاح، يتوقف ذلك التطبيق فورًا.
أين تجده: الإعداد ← الدعم ← مفاتيح التطبيقات (للمسؤولين فقط).
إنشاء مفتاح تطبيق
- افتح الإعداد ← الدعم ← مفاتيح التطبيقات.
- أدخل اسم التطبيق، مثل
WordPress plugin. يرى الموظفون هذا الاسم كقناة للتذاكر التي يفتحها. - اختر المنتج عندما لا يحدد الطلب منتجًا، أو يجب أن يحدد الطلب المنتج.
- انقر على إنشاء مفتاح.
- انسخ المفتاح الآن واحفظه في إعدادات التطبيق. يُعرض المفتاح هذه المرة فقط؛ إذ لا يحتفظ 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"
}
}
| الحقل | مطلوب | المعنى |
|---|---|---|
| نعم | عنوان البريد الإلكتروني للعميل؛ يُنشأ عميل جديد إذا كان العنوان غير معروف | |
| 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.