---
title: "ربط التذاكر: دليل المطوّرين | خدمات الحوسبة"
description: "عملاؤك يفتحون تذاكر الدعم ويتابعونها من تطبيقك وموقعك، وفريقك يعمل عليها من لوحة التذاكر بدخول من لوحة منصتك، وتصل منصتك إشعارات كل تغيير."
canonical_url: "https://alhawsaba.com/docs/tickets"
meta:
  "og:description": "عملاؤك يفتحون تذاكر الدعم ويتابعونها من تطبيقك وموقعك، وفريقك يعمل عليها من لوحة التذاكر بدخول من لوحة منصتك، وتصل منصتك إشعارات كل تغيير."
  "og:title": "ربط التذاكر: دليل المطوّرين | خدمات الحوسبة"
---

> Index of every page on this site: [llms.txt](https://alhawsaba.com/llms.txt)

[كل أدلة الربط](https://alhawsaba.com/docs)

# ربط التذاكر

عملاؤك يفتحون تذاكر الدعم ويتابعونها من تطبيقك وموقعك، وفريقك يعمل عليها من لوحة التذاكر بدخول من لوحة منصتك، وتصل منصتك إشعارات كل تغيير.

### العناوين

- واجهة API `https://api-support-ticket.alhawsaba.com/api`
- لوحة التذاكر `https://support-tickets.alhawsaba.com`

### المفاتيح

- **مفتاح المشروع**`project_key`يسمّي مشروعك في كل توكن وكل نداء.
- **سر التوقيع (JWT)**`jwt_secret`يوقّع به سيرفرك توكنات الناس.
- **مفتاح API**`api_key`يصل مع إشعارات التذاكر ونداءاتها إلى سيرفرك لتتحقق منه، وترسله مع تحديثات الناس.

تظهر المفاتيح مرة واحدة عند إضافة الخدمة إلى المشروع، وتجدها بعد ذلك داخل الخدمة في إعدادات المشروع.

0

### توكن الشخص

سيرفرك يوقّع توكن JWT بخوارزمية HS256 وسر التوقيع لكل شخص. حقل exp مطلوب.

| الحقل | مطلوب | المعنى |
| --- | --- | --- |
| `project_key` | نعم | مفتاح مشروعك. |
| `user_id (أو sub)` | نعم | رقم الشخص عندك. |
| `role` | نعم | user للعميل، admin لموظفك، guest لزائر دون حساب (يرى تذاكره فقط). |
| `exp` | نعم | وقت الانتهاء. |

```
// npm i jsonwebtoken
import jwt from 'jsonwebtoken'

export function serviceToken(user, role) {
  return jwt.sign({
    project_key: process.env.ALHAWSABA_PROJECT_KEY,
    user_id: String(user.id),
    role,                      // 'user' | 'admin' | 'guest'
    name: user.name,
    email: user.email,
  }, process.env.ALHAWSABA_JWT_SECRET, { algorithm: 'HS256', expiresIn: '7d' })
}
```

### تطبيقك وموقعك

1. 1

   #### اطلب التوكن من سيرفرك

   بالدور user للعميل المسجّل، أو guest لزائر لا حساب له.
2. 2

   #### التذاكر

   كلها بالترويسة Authorization: Bearer {JWT}.
   - GET `/api/integration/me`الشخص الحالي.
   - GET `/api/integration/ticket-types`أنواع التذاكر.
   - GET `/api/integration/ticket-categories`التصنيفات.
   - GET `/api/integration/tickets`تذاكر العميل.
   - POST `/api/integration/tickets`تذكرة جديدة.
   - GET `/api/integration/tickets/{id}`تذكرة وردودها.
   - POST `/api/integration/tickets/{id}/reply`رد العميل.
   - PUT `/api/integration/tickets/{id}/close`إغلاق.
   - PUT `/api/integration/tickets/{id}/reopen`إعادة فتح.
   - POST `/api/integration/tickets/{id}/rate`تقييم بعد الحل.
   - POST `/api/integration/tickets/{id}/attachments`مرفقات.
   - POST `/api/integration/tickets/{id}/escalation-request`طلب تصعيد.
   - POST `/api/integration/files`رفع ملف.
3. 3

   #### قاعدة المعرفة قبل التذكرة

   تُقرأ دون توكن بالترويسة X-Project-Key، لتعرض إجابات قبل أن يفتح العميل تذكرة.
   - GET `/api/integration/kb/categories`الأقسام.
   - GET `/api/integration/kb/articles`المقالات.
   - GET `/api/integration/kb/suggest`مقالات مقترحة لما يكتبه العميل.

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://alhawsaba.com/#website","@type":"WebSite","description":"المحادثات والتذاكر والمقترحات والاستبيانات في منظومة واحدة، بحساب واحد وفاتورة واحدة.","inLanguage":"ar-EG","name":"خدمات الحوسبة","url":"https://alhawsaba.com/","workTranslation":[]},{"@id":"https://alhawsaba.com/docs/tickets#webpage","@type":"WebPage","description":"عملاؤك يفتحون تذاكر الدعم ويتابعونها من تطبيقك وموقعك، وفريقك يعمل عليها من لوحة التذاكر بدخول من لوحة منصتك، وتصل منصتك إشعارات كل تغيير.","name":"ربط التذاكر: دليل المطوّرين","url":"https://alhawsaba.com/docs/tickets","isPartOf":{"@id":"https://alhawsaba.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://alhawsaba.com/docs/tickets"]}]}]}
```

## Sitemap

See the full [sitemap](https://alhawsaba.com/sitemap.md) for all pages.
