Biz1 Embed Chat

آخر تحديث: 2026-06-01

Biz1 Embed Chat هي أداة دردشة للموقع الإلكتروني تضيفها إلى موقعك الخاص. ينقر الزوار على أيقونة الدردشة، ويدخلون تفاصيلهم، ويرسلون رسالة إلى عملك — دون الحاجة لتسجيل الدخول إلى Biz1.

يقرأ فريقك الرسائل ويرد عليها من Biz1 (ملف تعريف العميل ← علامة تبويب الدردشة).

ما هي

تضع Embed Chat فقاعة دردشة مباشرة على أي موقع ويب تتحكم فيه — موقع تسويقي، صفحة هبوط، متجر إلكتروني، إلخ.

لا يحتاج الزوار إلى حساب Biz1. يرون نافذة دردشة ودودة، ويملأون الاسم / البريد الإلكتروني / الهاتف مرة واحدة، ويبدأون التحدث.

طريقتان لتقديمها:

| الوضع | التجربة |

|------|------------|

| أداة عائمة | أيقونة صغيرة في الزاوية؛ تفتح لوحة دردشة عند النقر |

| دردشة بصفحة كاملة | صفحة دردشة مخصصة (رابط أو إطار iframe) |

أين تراها

| الموقع | الغرض |

|----------|---------|

| موقعك الإلكتروني | أداة مباشرة أو صفحة دردشة يستخدمها زوارك |

| مُكوّن التضمين | `https://your-domain.com/chat/embed.php` — اختر الخيارات وانسخ الكود |

| صفحة الاختبار | `https://your-domain.com/chat/test.html` — معاينة قبل النشر |

| Biz1 ← العميل ← علامة تبويب الدردشة | حيث يرى فريقك رسائل الزوار ويرد عليها |

الميزات

لزوار الموقع الإلكتروني

| الميزة | التفاصيل |

|---------|---------|

| بدء الدردشة | نموذج الاسم والبريد الإلكتروني والهاتف عند الزيارة الأولى |

| الرسائل النصية | رسائل الدردشة القياسية |

| تحميل الملفات | PDF، Word، صور |

| الرسائل الصوتية | مسجل صوت مدمج |

| الكاميرا | التقاط صورة على الهاتف المحمول |

| الزيارات المتكررة | يتذكر المتصفح الزائر لمدة ~30 يومًا |

| سجل الدردشة | يتم تحميل الرسائل السابقة عند العودة (عند تمكين السجل) |

| التحية | "مرحباً {الاسم}" تظهر محلياً عند فتح الدردشة |

التخصيص (علامتك التجارية)

| الخيار | الخيارات |

|--------|---------|

| اللغة | الإنجليزية، العبرية، العربية، التايلاندية، البورمية |

| الاتجاه | من اليسار إلى اليمين أو من اليمين إلى اليسار |

| اللون | أي لون سداسي عشري لرأس الصفحة وفقاعات رسائل الزوار |

| الحالة الافتراضية | الدردشة مفتوحة أو مغلقة عند تحميل الصفحة |

| السجل | تحميل الرسائل السابقة عند الزيارة المتكررة (تشغيل/إيقاف) |

تستخدم العلامة التجارية الافتراضية ألوان وشعار Biz1؛ يمكنك تجاوز اللون الأساسي بلونك الخاص.

لفريقك

- تنشئ رسائل الزوار أو تربط سجل عميل في Biz1. - يتم إرسال الردود من ملف تعريف العميل ← علامة تبويب الدردشة أو الدردشة الجانبية. - يمكنك المتابعة لاحقًا عبر البريد الإلكتروني أو واتساب أو قنوات أخرى من نفس سجل العميل.

كيفية إعدادها

الخطوة 1 — احصل على رمز API المميز الخاص بك

1. سجل الدخول إلى Biz1 بصفتك مالك الحساب. 2. انتقل إلى الإعدادات. 3. في قسم حسابك / ملفك الشخصي، ابحث عن رمز API المميز. 4. انسخ الرمز — ستحتاجه في كود التضمين.

> تستخدم دردشة التضمين رمز API المميز لحسابك. قد يتطلب الوصول إلى API خطة مدفوعة — انظر FREE_PLAN_MAP.md.

الخطوة 2 — بناء الأداة (موصى به)

1. افتح `https://your-domain.com/chat/embed.php` في متصفحك. 2. اضبط: - اللغة والاتجاه - لون العلامة التجارية - مفتوحة أو مغلقة افتراضيًا - ما إذا كان سيتم تحميل السجل - رمز API المميز الخاص بك 3. انقر على نسخ نص التضمين. 4. الصق النص في HTML موقعك الإلكتروني، قبل `</body>` مباشرة.

يوفر المُكوّن أيضًا:

- رابط المعاينة — افتحه في علامة تبويب جديدة لترى كيف يبدو - معاينة مباشرة — اختبر الأداة بإعداداتك

الخطوة 3 — أداة عائمة (يدوي)

إذا كنت تفضل كتابة الكود بنفسك، أضف علامة نص برمجي واحدة:

<script src="https://your-domain.com/chat/chat.php"
  data-lang="en"
  data-direction="ltr"
  data-color="#021225"
  data-default="close"
  data-api_hash_token="YOUR_API_TOKEN"
  data-history="1">
</script>

| السمة | المعنى |

|-----------|---------|

| `data-lang` | لغة واجهة المستخدم |

| `data-direction` | `ltr` أو `rtl` |

| `data-color` | لون العلامة التجارية (بصيغة Hex) |

| `data-default` | `open` أو `close` عند تحميل الصفحة |

| `data-api_hash_token` | رمز API المميز الخاص بك من الإعدادات |

| `data-history` | `1` = تحميل الرسائل السابقة عند العودة |

الخطوة 4 — دردشة بصفحة كاملة (بديل)

اربط مباشرة بصفحة دردشة بدلاً من أداة عائمة:

https://your-domain.com/chat/index.php?lang=en&api_hash_token=YOUR_API_TOKEN

حسابات النطاقات الفرعية: إذا كنت تستخدم نطاقًا فرعيًا شخصيًا (مثل `yourname.biz1.co.il`)، يمكن أن تعمل الدردشة بصفحة كاملة على النطاقات المدعومة بدون رمز مميز:

https://yourname.biz1.co.il/chat/index.php?lang=he&history=1

النطاقات المدعومة: `biz1.co.il`، `bull36.com`، `mastrocrm.com`.

يتطلب نص التضمين العائم دائمًا رمز API المميز.

الخطوة 5 — تحديد هوية الزائر العائد مسبقًا (اختياري)

إذا كنت تعرف العميل بالفعل (على سبيل المثال من CRM الخاص بك أو مستخدم مسجل الدخول على موقعك):

<script src="https://your-domain.com/chat/chat.php"
  data-api_hash_token="YOUR_API_TOKEN"
  data-con_id="ENCRYPTED_CONTACT_ID"
  data-name="John Doe"
  data-history="1"
  data-default="open">
</script>

يتخطى الزائر نموذج المقدمة وينتقل مباشرة إلى الدردشة.

الخطوة 6 — الاختبار قبل النشر

1. افتح `https://your-domain.com/chat/test.html` (أو رابط المعاينة من embed.php). 2. أرسل رسالة اختبار. 3. في Biz1، افتح العميل ← علامة تبويب الدردشة المطابقة وتأكد من وصول الرسالة. 4. رد من Biz1 وتأكد من أن الزائر يراها (أو استخدم أزرار حقن الاختبار في صفحة الاختبار).

الخطوة 7 — الرد من Biz1

عندما يدردش زائر على موقعك: