القنوات: Telegram وWhatsApp وVK

يمكن للبوت في GetMyBot أن يعمل في عدة مراسلات في آن واحد — Telegram وWhatsApp وVK. تجمع السلوك مرة واحدة (التفاعلات والشروط والإجراءات)، وتوصله المنصة إلى القناة التي جاء منها الحدث. هكذا يخدم منشئ واحد جميع القنوات بدلاً من إعداد بوت منفصل لكل قناة.

ما هي القناة

القناة هي منصة توصيل موصولة: بوت Telegram محدد، أو رقم WhatsApp Business، أو مجتمع VK. يمكن أن يمتلك بوت GetMyBot واحد عدة قنوات. التفاعلات مشتركة: عندما يكتب المشترك في WhatsApp، يُعالَج الحدث بنفس التفاعلات المستخدمة في Telegram، ويعود الرد إلى WhatsApp.

تدعم القنوات المختلفة مجموعات مختلفة من إمكانات المراسلات (الأزرار، التعديل، القوالب وما إلى ذلك). يراعي المنشئ ذلك: الإجراءات غير المتاحة لقناة ما إمّا لا تُعرض أو تتراجع إلى أقرب بديل.

القناة الأساسية (primary_channel)

لكل بوت قناة أساسية (primary_channel) — المنصة التي يُرتبط بها البوت في المقام الأول. غالباً تكون Telegram، لكن يمكن إنشاء البوت مباشرةً كبوت WhatsApp أو VK دون Telegram إطلاقاً. تُحدَّد القناة الأساسية عند الإنشاء وتظهر في قائمة البوتات؛ وتُضاف بقية القنوات إلى البوت لاحقاً.

مصفوفة إمكانات القنوات

فيما يلي الإمكانات التي تدعمها كل قناة من إمكانات المراسلات. تُعيد الواجهة البرمجية المصفوفة المحدّثة بصيغة قابلة للمعالجة: GET /api/channels/capabilities.

Telegram — القناة المرجعية بمجموعة الإمكانات الكاملة: أزرار inline ولوحة مفاتيح reply، وcallback (ضغط زر ← تفاعل)، وتفاعلات الإيموجي، وdeep-link /start، وتعديل الرسائل وحذفها وإعادة توجيهها، وreply كمُشغّل، وأحداث المشاركين، والصلاحيات والإشراف. تنسيق النص — Plain / HTML / Markdown. لا توجد قوالب ولا قوائم ولا carousels ولا نافذة جلسة (لا حاجة إليها في Telegram).

WhatsApp (عبر WhatsApp Cloud API) — بخصوصيته: أزرار inline، وcallback، وتفاعلات الإيموجي، وdeep-link /start، وقوالب الرسائل، والقوائم (interactive list)، ونافذة جلسة مدتها 24 ساعة. التنسيق — Plain / Markdown. لا يدعم لوحة مفاتيح reply ولا تعديل الرسائل ولا حذفها ولا إعادة توجيهها، ولا reply كمُشغّل، ولا أحداث المشاركين، ولا الصلاحيات/الإشراف، ولا carousels. مزيد من التفاصيل في صفحة WhatsApp.

VK — الرسائل والمرفقات، وأزرار inline ولوحة مفاتيح reply، وcallback، وتفاعلات الإيموجي، وdeep-link /start، وتعديل الرسائل وحذفها، وإعادة التوجيه، وأحداث المشاركين، والحظر/رفع الحظر. التنسيق — نص عادي فقط (يُزال HTML/Markdown عند العرض). لا توجد قوالب WhatsApp ولا قوائم ولا carousels ولا نافذة جلسة في VK.

المشترك بين جميع القنوات: أزرار inline، وcallback، وتفاعلات الإيموجي، وdeep-link /start. أما carousels فلا تدعمها أي قناة حتى الآن.

كيفية توصيل قناة

تُضاف القنوات في صفحة البوتات (/app/bots).

  1. افتح البوتات واعثر على البوت المطلوب.
  2. اضغط «إضافة قناة» في بطاقة البوت.
  3. اختر المنصة — Telegram أو WhatsApp أو VK.
  4. أدخل بيانات القناة (لـTelegram — الرمز، لـWhatsApp — مجموعة بيانات Meta، لـVK — بيانات المجتمع).
  5. اضغط «تحقق» — ستتحقق المنصة من بيانات الاعتماد لدى المراسلة.
  6. اضغط «توصيل».

بالنسبة إلى WhatsApp وVK، تظهر للقناة بعد التوصيل عنوان webhook (أيقونة 🔗). يجب إدخال هذا العنوان في جهة المنصة (في تطبيق Meta لـWhatsApp، وفي إعدادات المجتمع لـVK) كي تصل الأحداث الواردة إلى البوت. لمعرفة كيفية ذلك في WhatsApp — راجع WhatsApp ← إعداد webhook.

الخطوات التالية