تكامل Zendesk

كيفية دمج Zendesk مع OpenReplay.

التثبيت

إن أسهل طريقة لدمج Zendesk مع OpenReplay هي إنشاء تطبيق خاص صغير للشريط الجانبي باستخدام Zendesk Apps Framework (ZAF). يضيف هذا التطبيق رابطًا مباشرًا إلى ملف تعريف المستخدم في OpenReplay الخاص بمقدم الطلب داخل كل تذكرة، حيث يمكنك مراقبة أحداثه وجلساته (بشرط أن تقوم بوسم الجلسات بالبريد الإلكتروني كمعرّف للمستخدم).

1. إنشاء ملفات التطبيق

أنشئ مجلدًا بالبنية التالية:

openreplay-zendesk-app/
├── manifest.json
└── assets/
    └── iframe.html

manifest.json

{
  "name": "OpenReplay",
  "author": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "defaultLocale": "en",
  "private": true,
  "version": "1.0.0",
  "frameworkVersion": "2.0",
  "location": {
    "support": {
      "ticket_sidebar": {
        "url": "assets/iframe.html",
        "flexible": true
      }
    }
  }
}

assets/iframe.html

تأكد من استبدال OPENREPLAY_DOMAIN و PROJECT_ID بالقيم الصحيحة. إذا لم تكن متأكدًا من القيم التي يجب اختيارها، فتحقق من عنوان URL لأي تسجيل موجود — الجزء الأول هو النطاق والرقم الذي يليه هو معرّف المشروع (Project ID).

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <script src="https://static.zdassets.com/zendesk_app_framework_sdk/2.0/zaf_sdk.min.js"></script>
  <style>
    body { font-family: sans-serif; padding: 12px; margin: 0; }
    a { color: #1f73b7; text-decoration: none; font-size: 14px; }
    a:hover { text-decoration: underline; }
    #status { color: #999; font-size: 13px; }
  </style>
</head>
<body>
  <p id="content">Loading...</p>
  <script>
    const client  = ZAFClient.init();
    const DOMAIN  = '<OPENREPLAY_DOMAIN>';
    const PROJECT = '<PROJECT_ID>';

    client.get('ticket.requester.email').then(data => {
      const userId = data['ticket.requester.email'];

      if (!userId) {
        document.getElementById('content').innerHTML =
          '<span id="status">No OpenReplay user ID found for this requester.</span>';
        return;
      }

      const url = `https://${DOMAIN}/${PROJECT}/data-management/user/${encodeURIComponent(userId)}`;
      document.getElementById('content').innerHTML =
        `<a href="${url}" target="_blank">👤 View User in OpenReplay</a>`;

      client.invoke('resize', { width: '100%', height: '50px' });
    }).catch(() => {
      document.getElementById('content').innerHTML =
        '<span id="status">Could not load requester data.</span>';
    });
  </script>
</body>
</html>

2. حزم التطبيق وتثبيته

اضغط مجلد openreplay-zendesk-app/ في ملف zip (تأكد من أن manifest.json موجود في جذر ملف zip، وليس متداخلًا داخل مجلد فرعي).
في Zendesk، انتقل إلى مركز الإدارة ← التطبيقات والتكاملات ← تطبيقات Support.
انقر على رفع تطبيق خاص في الزاوية العلوية اليمنى.
امنح التطبيق اسمًا (مثل “OpenReplay”) وارفع ملف zip.
انقر على تثبيت.

3. عرض الرابط

انتقل إلى أي تذكرة وافتح لوحة التطبيقات بالنقر على زر التطبيقات في الزاوية العلوية اليمنى. سترى رابطًا مباشرًا إلى ملف تعريف المستخدم الخاص بمقدم الطلب في OpenReplay.

هل لديك أسئلة؟

إذا واجهت أي مشكلات، فتواصل معنا عبر Slack أو تفقّد المنتدى واحصل على المساعدة من مجتمعنا.