كيفية إعداد TalkTG: الدردشة المباشرة لموقعك داخل Telegram خطوة بخطوة
دليل مصوّر: أنشئ موقعًا، واربط بوت Telegram الخاص بك، والصق سطرًا واحدًا من الكود، ثم رُدّ على أول زائر من Telegram.
يشرح هذا الدليل إعداد TalkTG بالكامل، من إنشاء الحساب حتى الرد على أول زائر من Telegram. يستغرق الأمر نحو خمس دقائق، ولكل خطوة لقطة شاشة توضّح ما ستراه بالضبط.
ما تحتاج إليه
- موقع يمكنك إضافة وسم script إليه (HTML عادي أو WordPress أو Shopify أو Webflow أو Next.js وغيرها).
- حساب Telegram على الهاتف أو الكمبيوتر.
- نحو خمس دقائق.
الخطوة 1: أنشئ حسابك في TalkTG
افتح talktg.com وانقر «ابدأ مجانًا». سجّل باستخدام Google، أو أدخل اسمك وبريدك الإلكتروني وكلمة مرور، وسنرسل إليك رمزًا من 6 أرقام لتأكيد البريد. الخطة المجانية لا تتطلب بطاقة ائتمان.

الخطوة 2: أضف موقعك
في لوحة التحكم افتح «المواقع» وانقر «إضافة موقع». أدخل النطاق من دون https:// (مثل shop.example.com) واسمًا اختياريًا. لا تعمل الأداة إلا على النطاق الذي تدخله هنا، فلا يمكن لمواقع أخرى استخدامها.

بعد إنشاء الموقع تنتقل إلى صفحة نظرته العامة. تعرض قائمة الإطلاق في الأعلى الخطوات المتبقية: ربط Telegram، وتثبيت الأداة، واستقبال أول محادثة.

الخطوة 3: أنشئ بوت Telegram عبر BotFather
يوصل TalkTG رسائل الزوار عبر بوت Telegram الخاص بك، فالبوت ملكك وأنت من يختار اسمه وصورته. انقر زر «Telegram» في صفحة الموقع لفتح معالج الربط، ثم أنشئ البوت:
- في Telegram ابحث عن @BotFather (الحساب الرسمي يحمل علامة توثيق زرقاء) واضغط Start.
- أرسل /newbot.
- اختر اسمًا ظاهرًا، مثل «Demo Shop Support».
- اختر اسم مستخدم ينتهي بـ bot، مثل DemoShopSupportBot.
- سيرسل BotFather رمز API يشبه 1234567890:AAE… انسخه.

تعامل مع رمز البوت كأنه كلمة مرور، فمن يملكه يستطيع التحكم في البوت. يخزّن TalkTG الرمز مشفّرًا. وإذا تسرّب، أرسل /revoke إلى BotFather ثم اربط الرمز الجديد.
الخطوة 4: اربط البوت بموقعك
انقر «I have my bot token»، والصق الرمز، ثم انقر «Verify & Continue». يتحقق TalkTG من الرمز لدى Telegram ويربط البوت بهذا الموقع.

بعد ذلك يظهر رمز تحقق من 6 أرقام. افتح البوت في Telegram وأرسل إليه الرمز (أو /bindsite متبوعًا بالرمز). هذا يثبت أن حساب Telegram الذي سيستقبل الرسائل هو حسابك. تنتهي صلاحية الرمز بعد 5 دقائق.

انقر «I sent the code». بمجرد أن يستلم البوت الرمز تتحدّث الصفحة تلقائيًا وتعرض «Telegram Connected» مع الأوامر التي يمكنك استخدامها في Telegram.

- /online و/offline: لتحديد ما إذا كانت الأداة تُظهرك متاحًا.
- /sites: لعرض كل المواقع المرتبطة بهذا البوت.
- الرد: رُدّ على رسالة الزائر في Telegram لتجيبه.
- الرد + /block: لإغلاق المحادثة. الرد + /history: لعرض آخر 20 رسالة.
الخطوة 5: ثبّت الأداة على موقعك
ارجع إلى صفحة الموقع وانسخ المقتطف من بطاقة «Embed Code»، ثم الصقه في HTML موقعك قبل وسم </body> مباشرة. معرّف موقعك مضمّن فيه مسبقًا.
<script src="https://talktg.com/widget.js" data-site-id="YOUR_SITE_ID" async></script>
- HTML عادي: الصقه قبل </body> في كل صفحة، أو في القالب المشترك أو قالب التذييل.
- WordPress: استخدم تذييل القالب أو إضافة لـ«سكربتات الرأس والتذييل».
- Shopify: المتجر الإلكتروني ← القوالب ← تعديل الكود ← theme.liquid، قبل </body> مباشرة.
- React وNext.js وتطبيقات الصفحة الواحدة: أضفه مرة واحدة في قالب HTML الجذري أو التخطيط الرئيسي ليُحمَّل في كل الصفحات.
يُحمَّل السكربت بشكل غير متزامن ولا يبطئ صفحاتك. في قائمة الإطلاق انقر «Check widget installation» للتأكد من أن TalkTG يعثر على الأداة في موقعك.
الخطوة 6: خصّص الأداة لتناسب علامتك (اختياري)
من «Widget Settings» اختر لون علامتك، والزاوية السفلية اليمنى أو اليسرى، وحدّد اسم الموظف وفقاعة الترحيب ورسالة عدم الاتصال ورسالة الترحيب. يمكنك أيضًا طلب البريد الإلكتروني من الزوار لمتابعتهم إذا غادروا. انقر «Save Changes» فتتحدّث الأداة المنشورة فورًا.

الخطوة 7: أرسل رسالة تجريبية
افتح موقعك في نافذة تصفح خاصة، وسيظهر زر الدردشة في الزاوية التي اخترتها.

أرسل رسالة بصفتك زائرًا، وستصل إلى محادثة البوت في Telegram خلال ثانية مع الصفحة التي أُرسلت منها. رُدّ على تلك الرسالة في Telegram (اسحب لليسار على الهاتف، أو انقر بزر الفأرة الأيمن ← رد على الكمبيوتر)، وسيظهر ردّك فورًا في نافذة دردشة الزائر من دون إعادة تحميل الصفحة.

تُحفظ كل محادثة أيضًا في لوحة التحكم ضمن «المحادثات»، مع السجل الكامل وبيانات الزائر مثل الصفحة والمتصفح ووقت أول زيارة.

حل المشكلات
- لا يظهر زر الدردشة: تأكد من وجود المقتطف في الصفحة التي تعرضها، ومن تطابق النطاق في TalkTG مع نطاق موقعك تمامًا.
- رُفض رمز البوت: انسخه مجددًا من BotFather، بما في ذلك الجزء الذي قبل النقطتين ومن دون مسافات.
- رمز التحقق لا يعمل: تنتهي صلاحيته بعد 5 دقائق. انقر «Go back & try again» للحصول على رمز جديد.
- لا تصل الرسائل إلى Telegram: تأكد من أنك لم تحظر البوت أو توقفه، ومن أن الموقع يعرض «Telegram Connected».
ماذا بعد؟
أصبحت جاهزًا. رُدّ من Telegram أينما كنت، وأرسل /offline عندما تبتعد ليعرف الزوار أن عليهم ترك رسالة. وللرد تلقائيًا على الأسئلة الشائعة حتى في الليل، أضف مستنداتك وأسئلتك الشائعة إلى قاعدة المعرفة بالذكاء الاصطناعي (خطة Pro)، فهي تجيب نيابةً عنك وتحوّل المحادثة إليك في Telegram عندما لا تعرف الإجابة.