وثائق تكامل أداة الدردشة
تعرّف على إضافة TalkTG إلى موقعك، من التثبيت الأساسي إلى تخصيص المظهر.
المحتويات
البدء السريع
الصق سطرًا واحدًا من الكود وابدأ خلال دقائق.
سجّل وأضف موقعًا
أنشئ حسابًا، افتح «المواقع»، اختر «إضافة موقع» وأدخل نطاق موقعك.
اربط بوت Telegram
أنشئ بوت عبر @BotFather، انسخ Token، اربطه بالموقع ثم أرسل /start إلى البوت.
الصق كود الأداة
انسخ كود التضمين وضعه قبل وسم </body> مباشرة في HTML.
المتطلبات
- 1حساب TalkTG
- 2موقع يمكنك تعديل HTML الخاص به
- 3Telegram Bot Token من @BotFather
التثبيت
استبدل YOUR_SITE_ID بمعرّف الموقع الظاهر في لوحة التحكم.
<script src="https://talktg.com/widget.js"
data-site-id="YOUR_SITE_ID" async></script>HTML عادي
أضف السكربت قبل وسم الإغلاق </body>.
Next.js / React
استخدم مكوّن Script من Next.js في التخطيط الجذري.
Vue / Nuxt
أضفه إلى app.head.script في nuxt.config.ts.
WordPress
أضفه قبل </body> في footer.php أو استخدم إضافة للرأس والتذييل.
Shopify
أضفه قبل </body> في theme.liquid.
Wix
أضف كودًا مخصصًا في نهاية Body وطبّقه على جميع الصفحات.
إعدادات الأداة
انتقل إلى «المواقع ← موقعك ← إعدادات الأداة» لتغيير المظهر والسلوك.
| الخيار | الافتراضي | الوصف |
|---|---|---|
| اللون الأساسي | #6366F1 | لون الزر والرأس ورسائل الزائر. |
| الموضع | bottom-right | أسفل اليمين أو أسفل اليسار. |
| الترحيب | Hi there! | رسالة تظهر للزوار الجدد. |
| اسم الوكيل | Support | الاسم الظاهر في رأس الدردشة. |
| الفتح التلقائي | false | إظهار رسالة الترحيب تلقائيًا. |
| الصوت | true | تشغيل صوت عند وصول رد جديد. |
مرجع API
تستخدم الأداة واجهات API العامة التالية داخليًا، ولا تحتاج عادةً إلى استدعائها مباشرة.
/api/widget/config/{siteId}جلب إعدادات الأداة.
/api/sites/{siteId}/statusالتحقق من حالة بوت Telegram.
/api/chat/sendإرسال رسالة الزائر.
/api/chat/historyتحميل سجل المحادثة.
/api/chat/pollالتحقق من الرسائل الجديدة.
كيف تعمل
يُحمّل السكربت بشكل غير متزامن ويعزل الأنماط باستخدام Shadow DOM.
تُنقل رسائل الزوار إلى Telegram المرتبط عبر TalkTG.
تظهر ردودك من Telegram في نافذة الدردشة على الموقع.
تُحفظ هوية الزائر في المتصفح لمتابعة المحادثة عند العودة.
الأسئلة الشائعة وحل المشكلات
الأداة لا تظهر
تحقق من موضع السكربت ومعرّف الموقع وأخطاء وحدة تحكم المتصفح.
لا تصل الرسائل إلى Telegram
أرسل /start إلى البوت وتأكد أن لوحة التحكم تعرض أنه مرتبط.
هل يمكن استخدام عدة نطاقات؟
كل موقع مرتبط بنطاق واحد؛ أنشئ موقعًا لكل نطاق.
هل تبطئ الأداة الموقع؟
لا. تُحمّل باستخدام async ولا تعطل عرض الصفحة.
هل أنت مستعد للبدء؟
يستغرق الإعداد دقائق قليلة ولا يتطلب بطاقة ائتمان.