تتبّع التحليلات والمساعد الذكي

ما الذي يمكنك فعله

تتيح لك نقاط النهاية الأربع هذه ضبط مزايا التتبّع والذكاء الاصطناعي على كتيّب مُستضاف واحد، وكلها مفهرَسة عبر {flipbookId} الخاص به:

• أضِف مُعرّفات تتبّع التحليلات — أكواد Google Analytics وGoogle Tag Manager وFacebook Pixel.
• حدّد مزوّد الذكاء الاصطناعي — اسم المزوّد ومفتاح API الخاص به المُستخدَم لمزايا الذكاء الاصطناعي.
• اضبط المساعد الافتراضي — الإعدادات الأساسية لمساعد المحادثة/المساعدة داخل العارض (نص الزر، والألوان، والتوجيه، والتضمينات).
• حدّد نص حالة المساعد — النصوص المعروضة أثناء إنصات المساعد، وتسجيله، ومعالجته، وتحدّثه.

قبل أن تبدأ

• مفتاح API — يُرسَل في ترويسة X-Api-Key، أو ضمن Authorization: Bearer YOUR_API_KEY، مع كل طلب.
• الـ {flipbookId} — المُعرّف الرقمي للكتيّب/المستند. يُعيده create-by-file / create-by-url (بوصفه ID) أو تُعيده list. وتأخذه نقاط النهاية الأربع أدناه بوصفه معطى مسار.
• تذهب جميع الطلبات إلى الرابط الأساسي https://go.fliplink.me.
• جسم الطلب في كل نقطة نهاية هنا يكون بصيغة form-urlencoded (لا JSON) — أرسِل كل حقل بـ --data-urlencode.

أضِف مُعرّفات تتبّع التحليلات

يضيف PUT /api/set-analytics-tracking/{flipbookId} مُعرّفات تتبّع التحليلات الخاصة بك (مثل Google Analytics وGTM وFacebook Pixel) إلى الكتيّب المُستضاف.

curl -X PUT 'https://go.fliplink.me/api/set-analytics-tracking/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'FacebookAnalyticsCode=' \
  --data-urlencode 'GoogleAnalyticsCode=' \
  --data-urlencode 'GoogleTagManager='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

حدّد مزوّد الذكاء الاصطناعي

يضبط PUT /api/set-ai-provider/{flipbookId} مزوّد الذكاء الاصطناعي المُستخدَم لمزايا الذكاء الاصطناعي — اسم المزوّد (AIProvider) ومفتاح API الخاص به (AIKey).

curl -X PUT 'https://go.fliplink.me/api/set-ai-provider/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'AIProvider=' \
  --data-urlencode 'AIKey='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

اضبط المساعد الافتراضي

يضبط PUT /api/set-virtual-assistant/{flipbookId} الإعدادات الأساسية للمساعد الافتراضي داخل العارض (المحادثة/المساعدة). يبدّل IsVA المساعد بين التشغيل والإطفاء، ويحمل VAText توجيه المساعد / تعليماته، ويحمل VAEmbeddings كتلة التضمينات (سلسلة).

curl -X PUT 'https://go.fliplink.me/api/set-virtual-assistant/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'IsVA=false' \
  --data-urlencode 'VAButtonText=' \
  --data-urlencode 'VAButtonColor=' \
  --data-urlencode 'VAButtonTextColor=' \
  --data-urlencode 'VAText=' \
  --data-urlencode 'VAEmbeddings='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

حدّد نص حالة المساعد

يحدّد PUT /api/set-virtual-assistant-status-text/{flipbookId} نص الحالة/الترحيب المعروض من المساعد الافتراضي داخل العارض. الحقول الأربعة هي نصوص كل حالة: VAButtonStatus1 (الإنصات)، وVAButtonStatus2 (التسجيل)، وVAButtonStatus3 (المعالجة)، وVAButtonStatus4 (التحدّث).

curl -X PUT 'https://go.fliplink.me/api/set-virtual-assistant-status-text/96216' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  --data-urlencode 'VAButtonStatus1=' \
  --data-urlencode 'VAButtonStatus2=' \
  --data-urlencode 'VAButtonStatus3=' \
  --data-urlencode 'VAButtonStatus4='

الاستجابة:

{
  "Result": "OK",
  "Message": "Updated successfully"
}

الأخطاء المحتملة

تتشارك نقاط النهاية الأربع سلوك الأخطاء نفسه:

• مفتاح API مفقود أو غير صالح ← HTTP 401. تُعيد هذه الحالة صفحة HTML عادية لعدم التصريح — دون أي جسم JSON. تحقّق من وجود ترويسة X-Api-Key (أو Authorization: Bearer) وصحّتها.
• مُعرّف العنصر غير موجود أو غير مملوك لمفتاحك ← HTTP 200 مع Message: "Item not found".
• حقل مجهول أو مكتوب خطأً في الجسم ← HTTP 200 مع Message: "Unknown field(s) '…'. Expected: …".