REST API والرموز

إلى جانب المنشئ المرئي، يمكن الوصول إلى GetMyBot برمجياً: يمكن إدارة بيانات البوت عبر REST API. يوجد نوعان من الرموز — للوصول إلى بوت بعينه والرموز الشخصية (للأتمتة والتكاملات على مستوى الحساب).

رموز API للبوت

تُنشأ في الإعدادات → رموز API. كل رمز مرتبط ببوت ويتيح الوصول إلى نقاط REST الخاصة به (التفاعلات، المستخدمون، المجموعات، الإحصائيات وما إلى ذلك). يُعرض الرمز مرة واحدة فقط عند الإنشاء — احفظه في مكان آمن؛ تعرض القائمة الاسم والقناع وتاريخ الإنشاء. احذف الرموز غير الضرورية.

رموز الوصول الشخصية (PAT)

رموز الوصول الشخصية (PAT، تبدأ بـ mbp_) تعمل على مستوى الحساب وتُستخدم للأتمتة والتكاملات. تُنشأ في لوحة التحكم الشخصية؛ وتُمرَّر في ترويسة Authorization: Bearer mbp_…. يمتلك الرمز نطاقات وصول (scopes) — مجموعة صلاحيات بصيغة مورد:إجراء (مثلاً reactions:read، bots:write)، وتعني * الوصول الكامل. تكون مدة الصلاحية محدودة وتُخزَّن الرموز بشكل مُجزَّأ. هذه طريقة ملائمة لمنح سكريبت وصولاً محدوداً دون الكشف عن كلمة المرور.

ما المتاح عبر API

تتوفر عبر API نفس الكيانات المتاحة في الواجهة: البوتات وإعداداتها، والتفاعلات (بما يشمل الاستيراد/التصدير)، والمشتركون والعلامات، والمجموعات والسجلات، والإحصائيات وسجل الطلبات، والبث الجماعي. يتيح ذلك بناء لوحات مخصصة ومزامنات وأتمتة فوق GetMyBot.

القنوات وWhatsApp

GetMyBot متعدد القنوات (Telegram + WhatsApp + VK)، وتُدار قنوات البوت عبر REST أيضاً. القنوات وقوالب WhatsApp محكومة بـالنطاقات المشتركة bots:read / bots:write — لا يوجد نطاق منفصل للقنوات.

  • GET /api/channels/capabilities — مصفوفة إمكانات القنوات (نقطة نهاية جلسة، لا تتطلب نطاق PAT).
  • GET /api/bots/{botID}/channels (bots:read) — سرد قنوات البوت.
  • POST /api/bots/{botID}/channels (bots:write) — توصيل قناة WhatsApp أو VK.
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — فصل قناة.
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — كتالوج قوالب WhatsApp للقناة.
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — إنشاء قالب وإرساله إلى Meta للمراجعة.
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — إعادة مزامنة الكتالوج من Meta.
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — تعديل قالب.
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — حذف قالب.
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — رفع مثال وسائط للرأس (صورة/فيديو/مستند).

مخططات الطلبات والاستجابات والمعاملات والأمثلة موجودة في مرجع API.

الوصول عبر الجوّال

تمتلك المنصة تطبيقاً للجوّال بتفويض خاص به (رموز access وrefresh) ولوحة ملخص للبوتات — يستخدم نفس الواجهة الخلفية.

مرجع API

يتوفر المرجع التفاعلي الكامل للـ API العام في صفحة مرجع API: تجد فيه جميع نقاط النهاية المتاحة عبر PAT، والمعاملات، ومخططات الطلبات والاستجابات، والـ scopes المطلوبة وأمثلة جاهزة على الطلبات (curl وJavaScript وPython). يمكن تنفيذ طلب تجريبي بالرمز الخاص بك مباشرةً من الصفحة.

الأمان

  • تُعرض الرموز مرة واحدة؛ تعامل معها كأسرار.
  • تُخزَّن أسرار البوتات وبيانات الاعتماد بشكل مشفر.
  • تُسجَّل عمليات التعديل في سجل التدقيق.

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