القنوات: Telegram وWhatsApp وVK
اربط Telegram وWhatsApp وVK بمشروع واحد. تعرّف إلى اختلاف إمكانات القنوات والجهة التي تستقبل رد البوت.
في هذه الصفحة
يمكن لمشروع واحد في GetMyBot الرد عبر Telegram وWhatsApp وVK. فمثلًا، يمكنك استخدام تفاعل يرسل جدول الدروس في التطبيقات الثلاثة. يعود الردّ إلى التطبيق الذي كتب منه الشخص.
عند ربط تطبيق جديد، جرّب أزراره وإجراءاته: لا تدعم جميع التطبيقات الإمكانات نفسها. يوضّح هذا الدليل الفروق وطريقة الربط.
ما القناة؟
القناة هي حساب متصل تُرسل الرسائل عبره وتُستقبل منه: بوت Telegram محدد، أو رقم WhatsApp Business، أو مجتمع VK. يمكن ربط عدة قنوات ببوت GetMyBot واحد. التفاعلات مشتركة بينها: إذا كتب المشترك عبر WhatsApp، تعالج رسالته التفاعلات نفسها المستخدمة في Telegram، ثم يعود الرد عبر WhatsApp.
تختلف الأزرار والتنسيقات والإجراءات بين التطبيقات. قد يخفي المحرّر إعدادًا غير مدعوم أو يحوّله إلى بديل متاح. اختبر الرسالة في كل قناة مربوطة قبل إطلاقها.
القناة الأساسية (primary_channel)
لكل بوت قناة أساسية (primary_channel)، وهي التطبيق الذي يرتبط به البوت في المقام الأول. تكون غالبًا Telegram، لكن يمكنك إنشاء بوت WhatsApp أو VK من البداية دون Telegram. تُحدد القناة الأساسية عند إنشاء البوت وتظهر في قائمة البوتات؛ ويمكن إضافة القنوات الأخرى لاحقًا.
إمكانات القنوات
يلخص ما يلي الإمكانات المتاحة في كل تطبيق. ويمكن الحصول على القائمة الحالية بصيغة تقرؤها البرامج من واجهة API عبر GET /api/channels/capabilities.
Telegram: القناة الأكثر اكتمالًا. تدعم الأزرار المضمّنة ولوحة أزرار الرد، وتشغيل التفاعل عند الضغط على زر (callback)، وتفاعلات الإيموجي، ورابط البدء المباشر /start، وتعديل الرسائل وحذفها وإعادة توجيهها، واستخدام الرد على رسالة كمُشغّل، وأحداث الأعضاء، والصلاحيات والإشراف. تُقلّب بطاقات الصور داخل رسالة واحدة بالأزرار عند توفر معرّفات الملفات المناسبة. تنسيقات النص: Plain / HTML / Markdown. لا توجد قوالب WhatsApp أو قوائمه أو نافذة الجلسة فيه، لأنها غير لازمة لـ Telegram.
WhatsApp عبر WhatsApp Cloud API: يدعم الأزرار المضمّنة وcallback وتفاعلات الإيموجي ورابط البدء /start، إضافة إلى قوالب الرسائل والقوائم التفاعلية (interactive list) ونافذة جلسة مدتها 24 ساعة. التنسيق: Plain / Markdown. لا يدعم لوحة أزرار الرد الدائمة، أو تعديل الرسائل وحذفها وإعادة توجيهها، أو الرد كمُشغّل، أو أحداث الأعضاء، أو صلاحيات الإشراف، أو تقليب بطاقات الصور داخل رسالة واحدة. راجع WhatsApp.
VK: يدعم الرسائل والمرفقات، والأزرار المضمّنة ولوحة الرد، وcallback، وتفاعلات الإيموجي، ورابط البدء /start، وتعديل الرسائل وحذفها وإعادة توجيهها، وأحداث الأعضاء، والحظر وإلغاءه، والموافقة على طلب انضمام قُدّم بالفعل إلى مجتمع مغلق، وأحداث الاشتراك المدفوع VK Donut. يستخدم النص العادي فقط؛ يزيل HTML وMarkdown عند عرض الرسالة. لا يدعم قوالب WhatsApp، أو القوائم، أو تقليب الصور داخل رسالة واحدة، أو نافذة الجلسة.
تشترك القنوات كلها في الأزرار المضمّنة وcallback وتفاعلات الإيموجي ورابط البدء /start. وتتوفر كتلة دوّار الصور في القنوات التي تدعم الصور. في Telegram، تظهر البطاقات داخل رسالة واحدة إذا كان لكل صورة معرّف ملف file_id صالح. أما في WhatsApp وVK، وكذلك في Telegram إذا تعذّر الحصول على معرّف صالح لأي صورة، فتُرسل جميع البطاقات كرسائل صور منفصلة، مع الحفاظ على تعليق كل بطاقة وأزرارها. راجع الرسائل والأزرار.
VK Donut
إذا فعّلت VK Donut في مجتمعك، يستقبل البوت أحداث النظام التالية للاشتراك المدفوع:
| اسم الحدث في المحرّر | المفتاح | القيم المتاحة |
|---|---|---|
| VK Donut: subscription created (بدء الاشتراك) | donut_subscription_created | {{event.donut_amount}}، {{event.donut_amount_without_fee}} |
| VK Donut: subscription prolonged (تجديد الاشتراك) | donut_subscription_prolonged | {{event.donut_amount}}، {{event.donut_amount_without_fee}} |
| VK Donut: subscription expired (انتهاء الاشتراك) | donut_subscription_expired | لا توجد |
| VK Donut: subscription cancelled (إلغاء الاشتراك) | donut_subscription_cancelled | لا توجد |
{{event.donut_amount}} هو مبلغ الدفع، و{{event.donut_amount_without_fee}} هو المبلغ دون عمولة VK. لا تحمل أحداث انتهاء الاشتراك أو إلغائه مبلغًا. انتهاء الفترة المدفوعة لا يعني حدوث دفعة جديدة، وعرض مبلغ دفع قديم هنا سيكون مضللًا.
الحدث يتعلق بالمشترك، وليس رسالة منه. لذلك لا يفتح إمكانية مراسلته على الخاص، ولا يرفع الحظر، ولا يغيّر وقت «آخر نشاط»، ولا يزيد عدد الرسائل. خصم المال من البطاقة لا يعني أن الشخص كتب رسالة. وإذا لم يكن للمشترك سجل في المنصة بعد، يُنشأ له سجل حتى يمكن تطبيق الوسوم والصلاحيات عليه.
مثال لنادٍ بعضويّة مدفوعة:
- أنشئ تفاعلًا لحدثَي VK Donut: subscription created وVK Donut: subscription prolonged. استخدم إجراء تغيير التسميات لإضافة وسم «النادي» لمدة
ttl_days= 31 يومًا، ثم أرسل رابط المجتمع المغلق واطلب من الشخص تقديم طلب انضمام. - وافق بعد أن يقدّم الشخص الطلب. يقبل إجراء تغيير الصلاحيات → الموافقة على طلب الانضمام طلبًا مقدّمًا بالفعل (
groups.approveRequest). إذا لم يُقدّم الطلب، فلا شيء للموافقة عليه. ضع الإجراء في تفاعل يأتي بعد الخطوة الأولى، مثل زر «أرسلت الطلب» تحت الرسالة نفسها، أو عند حدث VK Donut: subscription prolonged التالي. - عند مُشغّل Label expired (
label_expired)، استخدم تغيير الصلاحيات → إزالة من المحادثة. وهكذا يغادر الشخص النادي عند انتهاء مدة الوسم، حتى إن لم يصل من VK حدث انتهاء الاشتراك. راجع المُشغّلات → انتهاء مدة الوسم. - عند VK Donut: subscription cancelled أو VK Donut: subscription expired، استخدم تغيير التسميات → إزالة «النادي»، وإذا أردت فأضف إزالة من المحادثة فورًا.
يجب أن يحتوي حقل المحادثة (chat_id) في إجراءات صلاحيات VK على المعرّف الرقمي للمجتمع المربوط، وهو الرقم الظاهر للقناة في قائمة القنوات. لا يستطيع VK إدارة أعضاء مجتمع آخر من هذه القناة. إذا أدخلت معرّفًا مختلفًا، يُرفض الإجراء قبل إرساله إلى VK. لإدارة مجتمع آخر، اربطه كقناة منفصلة.
لتفعيل الأحداث:
- Long Poll: يشترك البوت في الأحداث تلقائيًا عند ربط القناة وعند كل تشغيل للمنصة. لا يلزم إجراء إضافي للمجتمعات المربوطة سابقًا.
- Callback API: افتح في إعدادات المجتمع العمل مع API → Callback API → أنواع الأحداث → VK Donut وفعّل الأحداث الأربعة المذكورة في الجدول.
كيف تربط قناة؟
تُضاف القنوات من صفحة المشاريع:
- افتح المشاريع وابحث عن المشروع المطلوب.
- اضغط إضافة قناة في بطاقة المشروع.
- اختر Telegram أو WhatsApp أو VK.
- أدخل بيانات القناة: رمز البوت لـ Telegram، أو بيانات Meta لـ WhatsApp، أو بيانات المجتمع لـ VK.
- اضغط تحقّق ليفحص GetMyBot البيانات لدى التطبيق المعني.
- اضغط ربط.
بعد ربط WhatsApp أو VK، يظهر عنوان webhook في القناة مع الرمز 🔗. سجّل هذا العنوان لدى الخدمة المعنية، في تطبيق Meta لـ WhatsApp أو إعدادات المجتمع لـ VK، حتى تصل الأحداث الواردة إلى البوت. خطوات WhatsApp في إعداد webhook.
الخطوات التالية
- WhatsApp: الربط وwebhook ونافذة الجلسة وقوالب الرسائل.
- المشاريع والقنوات: أساسيات ربط البوت.
- أساسيات التفاعلات: سلوك البوت المشترك بين القنوات.
بيانات اعتماد القناة
يحتاج Telegram إلى الرمز المميز الكامل من BotFather. يحتاج VK إلى رمز المجتمع ومعرّفه الرقمي؛ وإذا استخدمت Callback API، فإلى المفتاح السري ورمز التأكيد أيضًا. يحتاج WhatsApp إلى Phone Number ID وWhatsApp Business Account ID ورمز وصول للحساب وVerify Token الخاص بـ webhook وApp Secret الخاص بتطبيق Meta.
راجع البيانات قبل الربط. وإذا غيّرت مفتاحًا، فحدّث الإعداد المرتبط به لدى المزوّد: يُستخدم Verify Token للتحقق من عنوان webhook، ويُستخدم App Secret للتحقق من توقيع الأحداث الواردة. لا يحل أيّ منهما محل رمز الوصول إلى API.
الأحداث الواردة وعناوين webhook
عند استخدام VK Callback API، سجّل العنوان الذي يعرضه MyBot في إعدادات خادم المجتمع، واستخدم المفتاح السري ورمز التأكيد نفسيهما في الجانبين. لا يحتاج Long Poll إلى عنوان عام أو هاتين القيمتين. في WhatsApp، سجّل العنوان في تطبيق Meta، وأدخل Verify Token المطابق، واشترك في أحداث الرسائل المطلوبة. بيانات الإرسال وحدها لا تكفي لاستقبال الرسائل.
تفويض Instagram وMessenger
يفتح معالج الربط صفحة تسجيل الدخول إلى Meta. سجّل الدخول بحساب يدير صفحة Facebook المطلوبة أو حساب Instagram مهنيًا، وامنح الأذونات المطلوبة، ثم اختر الحسابات لهذا المشروع. يتحقق المعالج من الأذونات والاشتراك في webhook وجاهزية تسليم الرسائل. أصلح أي فحص فاشل قبل استخدام القناة. ويمكن مراجعة الحسابات المختارة لاحقًا من الاتصال الموجود.