البدء السريع مع تيليجرام

تربط قناة تيليجرام بوت تيليجرام بـ Resool، فتصل كل رسالة خاصة يرسلها العملاء إلى البوت إلى صندوق الوارد المشترك بجانب واتساب وإنستجرام والبريد. تربطها بتوكن البوت الذي يعطيك إياه ‎@BotFather‎ في تيليجرام، ويضبط Resool الـ Webhook للبوت تلقائيًا. ولا توجد في تيليجرام نافذة للرد، فيستطيع فريقك الرد في أي وقت.

#ما الذي يمكنك فعله مع تيليجرام

في صندوق الوارد

• استقبل الرسائل الخاصة المرسلة إلى البوت كمحادثات، بما فيها الصور والفيديو والرسائل الصوتية والملفات.
• ردّ بالنصوص والصور والملفات في أي وقت، فتيليجرام ليس فيه نافذة للرد.

في القناة

• افتح محادثة مع البوت بضغطة واحدة لتجربته.
• حدّث الربط إذا تغيّر الـ Webhook الخاص بالبوت من مكان آخر.

#قبل أن تبدأ

• حساب تيليجرام لإنشاء البوت وامتلاكه.
• توكن بوت من ‎@BotFather‎. لا يمكن ربط بوتات تيليجرام إلا بالتوكن، لذلك تستخدم هذه القناة التوكن بدلًا من تسجيل الدخول.
• في Resool، يستطيع المالكون والمسؤولون فقط ربط القنوات. وتُحتسب تيليجرام قناةً واحدة ضمن حد خطتك.

#كيفية إنشاء بوت والحصول على التوكن

1. في تيليجرام، افتح ‎@BotFather‎ (البوت الرسمي بعلامة التوثيق الزرقاء).
2. أرسل /newbot. اختر اسمًا يظهر للعملاء، ثم اسم مستخدم ينتهي بـ bot (مثل AcmeSupportBot).
3. يرد BotFather بتوكن البوت، ويكون بالشكل 123456789:AAH….

لديك بوت بالفعل؟ أرسل /mybots، واختر البوت، وافتح API Token لترى التوكن.

#كيفية ربط تيليجرام بـ Resool

1. انتقل إلى الإعدادات › القنوات واضغط إضافة قناة.
2. في تبويب المراسلة التجارية، ابحث عن تيليجرام واضغط ربط.
3. يعرض مربع ربط تيليجرام الخطوات الثلاث ورابط فتح BotFather. املأ:
   • اسم القناة: كيف تظهر القناة في Resool. القيمة الافتراضية «تيليجرام».
   • توكن البوت: الصق التوكن الذي حصلت عليه من BotFather.

مكان لقطة الشاشة

الإعدادات › القنوات › إضافة قناة › تيليجرام › ربط

مربع «ربط تيليجرام» بشعار تيليجرام، والخطوات الثلاث المرقمة، ورابط «فتح BotFather»، وحقل اسم القناة، وحقل توكن البوت مع التلميح، وزر «ربط».

الملف: screenshots/ar/telegram-quick-start-connect-dialog.png

1. اضغط ربط. يتحقق Resool من التوكن، ويربط البوت، ويضبط الـ Webhook، ويفتح صفحة القناة.

افتح البوت في تيليجرام، وأرسل إليه رسالة، وتأكد من ظهورها في صندوق الوارد.

#كيفية إعداد تيليجرام

افتح الإعدادات › القنوات واضغط إدارة على قناة تيليجرام. يعرض تبويب الإعدادات:

• اسم القناة: غيّر اسم القناة واحفظ من شريط الحفظ.
• بطاقة البوت: اسم البوت واسم المستخدم ‎@‎، والحالة (مربوط، أو محتاج مراجعة مع السبب)، وزر فتح المحادثة الذي يفتح البوت في تيليجرام، وزر تحديث الربط الذي يضبط الـ Webhook من جديد.
• الـ Webhook: العنوان الذي يرسل إليه تيليجرام الرسائل، ويضبطه Resool لك.

مكان لقطة الشاشة

الإعدادات › القنوات › تيليجرام › الإعدادات

تبويب الإعدادات وفيه حقل اسم القناة، وبطاقة البوت (اسم البوت، ‎@AcmeSupportBot‎، شارة «مربوط»، زرّا «فتح المحادثة» و«تحديث الربط»)، وبطاقة «الـ Webhook» بالعنوان وملاحظة نافذة الرد.

الملف: screenshots/ar/telegram-quick-start-configuration.png

يُضبط التوجيه والإسناد التلقائي واستبيانات الرضا من إعدادات القناة. ولإزالة القناة، اضغط حذف القناة تحت منطقة الخطر وأكّد. تبقى المحادثات السابقة.

#ملاحظات وقيود

• تصل المحادثات الخاصة مع البوت فقط، وتُتجاهل الرسائل في المجموعات والقنوات التي يكون البوت عضوًا فيها.
• يجب أن يراسل العميل البوت أولًا، فبوتات تيليجرام لا تستطيع بدء محادثة مع شخص لم يكتب إليها.
• تستقبل البوتات من العملاء ملفات حتى 20 ميجابايت.
• يرسل بوت تيليجرام رسائله إلى وجهة واحدة فقط، لذلك يحل ربطه بـ Resool محل أي Webhook ضبطته أداة أخرى للبوت نفسه.
• يمكن ربط كل بوت بمساحة عمل واحدة في Resool.

#الأسئلة الشائعة وحل المشكلات

#تظهر رسالة «ده مش شكل توكن صحيح.»

التوكن ليس بالصيغة التي يستخدمها تيليجرام. انسخه مرة أخرى من BotFather: يتكون من رقم ثم نقطتين رأسيتين ثم سلسلة طويلة من الحروف والأرقام و- و_ دون مسافات.

#تظهر رسالة «المنصة رفضت البيانات دي. راجعها وجرب تاني.»

لم يقبل تيليجرام التوكن، وربما أُلغي أو أُعيد إنشاؤه في BotFather.

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

• في BotFather، أرسل /mybots، واختر البوت، وافتح API Token لنسخ التوكن الحالي.
• حاول مرة أخرى بالتوكن الجديد.

#توقفت الرسائل عن الوصول

ربما ضبطت أداة أخرى Webhook خاصًا بها للبوت نفسه، أو أُلغي التوكن.

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

• افتح القناة واضغط تحديث الربط.
• إذا ظهرت الحالة محتاج مراجعة بسبب إلغاء التوكن، فاحذف القناة واربطها من جديد بالتوكن الجديد.

#هل يستطيع البوت الرد في مجموعات تيليجرام؟

لا. تصل إلى Resool المحادثات الخاصة مع البوت فقط.

#ما التالي؟

• إعدادات القناة: التوجيه والإسناد التلقائي واستبيانات الرضا
• الرد على المحادثات
• البدء السريع مع فايبر
• وكلاء الذكاء الاصطناعي