---
name: Helpdesk Integrations
priority: 2
keywords: zendesk, intercom, freshdesk, crisp, helpscout, helpdesk, ticket, تذكرة, تذاكر, دعم فني, helpdesk, ticket system, kayako, drift, tawk, chat support
---

# Helpdesk Platforms — Zendesk, Intercom, Freshdesk, Crisp

## متى تستخدم
ربط Muassis مع نظام دعم فني خارجي لإنشاء/تحديث/قراءة tickets، استخراج SLA reports، إلحاق محادثات WhatsApp بـtickets.

## Zendesk
Auth: API token + email. Base: `https://$ZD_SUBDOMAIN.zendesk.com/api/v2`
```bash
# إنشاء ticket
exec_command "curl -s -X POST -H 'Content-Type: application/json' \
  -u '$ZD_EMAIL/token:$ZD_TOKEN' \
  -d '{\"ticket\":{\"subject\":\"شكوى توصيل متأخر\",\"comment\":{\"body\":\"العميل يقول الطلب وصل بعد 5 أيام\"},\"requester\":{\"name\":\"Ahmed\",\"email\":\"ahmed@example.com\"},\"priority\":\"high\",\"tags\":[\"saudi\",\"shipping\"]}}' \
  'https://$ZD_SUBDOMAIN.zendesk.com/api/v2/tickets.json'"

# قائمة tickets المفتوحة
exec_command "curl -s -u '$ZD_EMAIL/token:$ZD_TOKEN' \
  'https://$ZD_SUBDOMAIN.zendesk.com/api/v2/search.json?query=type:ticket status<solved'"

# إضافة comment لـticket
exec_command "curl -s -X PUT -H 'Content-Type: application/json' \
  -u '$ZD_EMAIL/token:$ZD_TOKEN' \
  -d '{\"ticket\":{\"comment\":{\"body\":\"تم التواصل، الطلب قيد الشحن مرة ثانية مجاناً\",\"public\":true},\"status\":\"pending\"}}' \
  'https://$ZD_SUBDOMAIN.zendesk.com/api/v2/tickets/$TICKET_ID.json'"

# SLA breaches
exec_command "curl -s -u '$ZD_EMAIL/token:$ZD_TOKEN' \
  'https://$ZD_SUBDOMAIN.zendesk.com/api/v2/views/$VIEW_ID/tickets.json'"
```

## Intercom
Auth: Access Token. Base: `https://api.intercom.io`
```bash
# إنشاء conversation (initiate)
exec_command "curl -s -X POST -H 'Authorization: Bearer $INTERCOM_TOKEN' -H 'Content-Type: application/json' \
  -d '{\"from\":{\"type\":\"admin\",\"id\":\"$ADMIN_ID\"},\"body\":\"<p>أهلاً Ahmed، تابعت طلبك...</p>\",\"message_type\":\"inapp\",\"to\":{\"type\":\"user\",\"id\":\"$USER_ID\"}}' \
  'https://api.intercom.io/messages'"

# إنشاء/تحديث contact
exec_command "curl -s -X POST -H 'Authorization: Bearer $INTERCOM_TOKEN' -H 'Content-Type: application/json' \
  -d '{\"role\":\"user\",\"email\":\"ahmed@example.com\",\"name\":\"Ahmed\",\"phone\":\"+966500000000\"}' \
  'https://api.intercom.io/contacts'"

# قائمة conversations مفتوحة
exec_command "curl -s -X POST -H 'Authorization: Bearer $INTERCOM_TOKEN' -H 'Content-Type: application/json' \
  -d '{\"query\":{\"field\":\"open\",\"operator\":\"=\",\"value\":true}}' \
  'https://api.intercom.io/conversations/search'"
```

## Freshdesk
Auth: API key. Base: `https://$FD_DOMAIN.freshdesk.com/api/v2`
```bash
# إنشاء ticket
exec_command "curl -s -X POST -u '$FD_KEY:X' -H 'Content-Type: application/json' \
  -d '{\"subject\":\"...\",\"description\":\"...\",\"email\":\"a@b.com\",\"priority\":2,\"status\":2}' \
  'https://$FD_DOMAIN.freshdesk.com/api/v2/tickets'"

# قائمة tickets المفتوحة
exec_command "curl -s -u '$FD_KEY:X' \
  'https://$FD_DOMAIN.freshdesk.com/api/v2/tickets?filter=new_and_my_open&per_page=100'"
```

## Crisp (يقدّم free tier جيد، شائع لـSMB)
Auth: identifier + key. Base: `https://api.crisp.chat/v1`
```bash
exec_command "curl -s -u '$CRISP_ID:$CRISP_KEY' \
  'https://api.crisp.chat/v1/website/$WEBSITE_ID/conversations'"
```

## أنماط شائعة (تنطبق على أي helpdesk)

### 1. WhatsApp → Helpdesk ticket
لما يجي شكوى عبر WhatsApp:
```
1. اقرأ المحادثة (آخر 5-10 رسائل)
2. خلّصها (summary 3 أسطر)
3. POST ticket مع customer info + تقدير priority
4. خزّن ticket ID في customer metadata في Muassis
5. كل رد لاحق من العميل يضيف comment للـticket
```

### 2. Auto-priority بناءً على الـsentiment
- نص فيه "غاضب" / "أسوأ" / "نصاب" → priority HIGH/URGENT.
- VIP customer (tag في Muassis) → priority HIGH.
- شكوى refund > 1000 ر.س → priority URGENT.

### 3. SLA tracking
- Zendesk تدعم native SLA policies — استخدمها.
- Freshdesk: response_time_in_minutes في الـticket payload.
- ابعث تنبيه لو ticket open > 4 ساعات بدون رد.

### 4. Knowledge Base auto-resolve
بدل إنشاء ticket فوري، Muassis يقدر:
- يقرا articles من KB (curl على `/help_center/articles`).
- يجاوب العميل من المقال.
- لو ما عجبه، إنشاء ticket.

## أمثلة
- "أنشئ ticket في Zendesk للعميل أحمد عن تأخير الشحن" → POST ticket بـpriority=high, tags=shipping.
- "كم ticket مفتوح هذا الأسبوع" → search type:ticket created>=7days.
- "ابعث رد على ticket #123: 'تم الحل'" → PUT comment + status=solved.
- "ايش الـSLA breaches اليوم" → views API بـsla_breached=true.

## القواعد الذهبية
- ❌ **ممنوع** إغلاق ticket بدون موافقة العميل ("هل المشكلة انحلّت؟").
- ❌ **لا ترسل bulk replies** — كل ticket فيه context مختلف.
- ✅ **اربط tickets بـcustomers في CRM** — Hubspot/Salesforce association عشان history واحد.
- ✅ **استخدم tags ثابتة** — `shipping`, `payment`, `product`, `complaint`, `vip` — للـreporting.
- ✅ **CSAT survey بعد كل ticket مغلق** — Helpdesk معظمها يدعم native.
