عنوان الويب والمنافذ لبوتك

ما يحصل عليه بوتك

لبوتك عنوان ويب بـ HTTPS ومنفذان إضافيان، وتبقى الثلاثة موقوفة حتى تفعّلها من الإدارة. ولا يفعّلها إلا بوت على باقة مدفوعة، فهي غير متاحة في الفترة التجريبية.

• عنوان الويب: https://name.srvk.gg، و name هو العنوان المخصص لبوتك، بشهادة نصدرها ونجددها بأنفسنا. يصل إليه الـ webhook من تيليقرام، وتفاعلات ديسكورد، وصفحات بوتك.
• المنفذ 1 والمنفذ 2: يستقبل كل منهما TCP و UDP على الرقم نفسه، دون شهادة.

فعّل عنوان الويب

1. افتح الإدارة وفعّل عنوان الويب. ننفّذ لبوتك ريستارت ليصله العنوان.
2. اجعل بوتك يستمع على 0.0.0.0، أي على كل العناوين لا على localhost، وعلى المنفذ الموجود في PORT. ونوجّه إلى هذا المنفذ كل طلب يصل إلى عنوانك.
3. راجع الكونسول: قبل أن يبدأ بوتك يظهر السطر serverk: web address https://name.srvk.gg on port 8080.

يستجيب العنوان بعد أن تصبح شهادته فعّالة. وتعرض الإدارة حالة الشهادة، وتنبّهك إذا كان بوتك لا يستقبل الطلبات. وننتظر رد بوتك على كل طلب 60 ثانية على الأكثر، ويمر الـ WebSocket أيضًا.

المتغيرات

ما دام عنوان الويب مفعّلًا، يصل إلى بوتك:

• PORT: المنفذ الذي يستمع عليه بوتك، مثل 8080. ويحل محل أي PORT أضفته إلى المتغيرات.
• SERVERK_WEB_URL: العنوان كاملًا، مثل https://name.srvk.gg، دون / في آخره.
• SERVERK_WEB_HOST: اسم الدومين وحده، مثل name.srvk.gg.

اقرأ هذه القيم من os.environ دائمًا ولا تكتبها في الكود، لأنها تتغيّر إذا غيّرت العنوان المخصص.

تيليقرام بالـ webhook

مع الـ webhook يرسل تيليقرام الرسائل إلى عنوان بوتك مباشرة، بدلًا من أن يسحبها بوتك بالـ polling.

في python-telegram-bot، استبدل app.run_polling() بهذا، فيضبط الـ webhook على عنوانك ويستمع على PORT بنفسه:

app.run_webhook(
    listen="0.0.0.0",
    port=int(os.environ["PORT"]),
    url_path="webhook",
    webhook_url=os.environ["SERVERK_WEB_URL"] + "/webhook",
)

ويحتاج ذلك python-telegram-bot[webhooks] في requirements.txt بدلًا من python-telegram-bot.

وفي aiogram، استقبل الطلبات بـ aiohttp واضبط الـ webhook عند كل تشغيل، واحذف dp.start_polling(bot):

import os

from aiogram import Bot, Dispatcher
from aiogram.webhook.aiohttp_server import SimpleRequestHandler, setup_application
from aiohttp import web

bot = Bot(os.environ["TELEGRAM_TOKEN"])
dp = Dispatcher()


async def on_startup(bot: Bot) -> None:
    await bot.set_webhook(f"{os.environ['SERVERK_WEB_URL']}/webhook")


dp.startup.register(on_startup)

app = web.Application()
SimpleRequestHandler(dispatcher=dp, bot=bot).register(app, path="/webhook")
setup_application(app, dp, bot=bot)
web.run_app(app, host="0.0.0.0", port=int(os.environ["PORT"]))

لا يجتمع الـ polling والـ webhook على توكن واحد، فشغّل بوتك بإحدى الطريقتين فقط.

تفاعلات ديسكورد عبر HTTP

إذا ضبطت Interactions Endpoint URL لتطبيقك، ترسل ديسكورد أوامر السلاش والأزرار إلى عنوان بوتك بدلًا من اتصال الـ gateway:

1. أضف DISCORD_PUBLIC_KEY إلى المتغيرات، وقيمته Public Key من صفحة General Information لتطبيقك في Developer Portal.
2. استقبل الطلبات على المسار /interactions، وتحقق من توقيع كل طلب بمكتبة discord-interactions كما في المثال أدناه.
3. انشر بوتك، ثم اكتب في Interactions Endpoint URL قيمة SERVERK_WEB_URL وبعدها /interactions، مثل https://name.srvk.gg/interactions، واضغط Save Changes.

import os

from discord_interactions import InteractionResponseType, verify_key_decorator
from flask import Flask, jsonify

app = Flask(__name__)


@app.post("/interactions")
@verify_key_decorator(os.environ["DISCORD_PUBLIC_KEY"])
def interactions():
    return jsonify(
        {
            "type": InteractionResponseType.CHANNEL_MESSAGE_WITH_SOURCE,
            "data": {"content": "Hello from Serverk"},
        }
    )


app.run(host="0.0.0.0", port=int(os.environ["PORT"]))

أضف discord-interactions و flask إلى requirements.txt. وعند الحفظ ترسل ديسكورد طلب PING، ولا تحفظ العنوان إلا إذا رد بوتك بـ PONG وبالحالة 200 خلال 3 ثوانٍ، ويرد verify_key_decorator عليه بنفسه. ويلزم الرد على كل تفاعل بعدها خلال 3 ثوانٍ أيضًا.

صفحات بوتك

لتقديم صفحة أو لوحة من بوتك، افتح سيرفر aiohttp واحدًا على PORT داخل حلقة بوتك نفسها:

import os

from aiohttp import web


async def health(request: web.Request) -> web.Response:
    return web.Response(text="ok")


async def serve_pages() -> None:
    app = web.Application()
    app.router.add_get("/health", health)
    runner = web.AppRunner(app)
    await runner.setup()
    await web.TCPSite(runner, "0.0.0.0", int(os.environ["PORT"])).start()

استدعِ await serve_pages() من setup_hook في discord.py، أو من post_init في python-telegram-bot، وأضف aiohttp إلى requirements.txt إذا لم تكن فيه. ويستمع بوتك على منفذ ويب واحد، فإذا استخدمت الـ webhook أو تفاعلات ديسكورد أيضًا، فأضف مساراتها إلى السيرفر نفسه ولا تفتح سيرفرًا ثانيًا على PORT.

المنفذ 1 والمنفذ 2

فعّل المنفذ الذي تحتاجه من الإدارة، فيصل رقمه إلى بوتك في SERVERK_PORT_1 أو SERVERK_PORT_2. اجعل بوتك يستمع على 0.0.0.0 وعلى هذا الرقم نفسه، لا على PORT، ويستقبل المنفذ TCP و UDP على الرقم نفسه. ويتصل الآخرون ببوتك على name.srvk.gg مع الرقم، كما تعرضه صفحة بوتك.

ويظهر الرقم في الكونسول قبل أن يبدأ بوتك، مثل serverk: port 1 on 29004، أو serverk: port 1 at name.srvk.gg:29004 إذا كان عنوان الويب مفعّلًا. واقرأه من المتغير دائمًا ولا تكتبه في الكود.

لا شهادة على هذين المنفذين، فما يمر عليهما غير مشفّر إلا إذا شفّره بوتك بنفسه. ولصفحات الويب والـ webhook استخدم عنوان الويب.

إذا غيّرت العنوان المخصص

عند تغيير العنوان المخصص من الإدارة ننفّذ لبوتك ريستارت، فيصله SERVERK_WEB_URL الجديد، ونصدر شهادة للعنوان الجديد. ويتحدّث الـ webhook في تيليقرام تلقائيًا إذا كان كودك يضبطه عند كل تشغيل كما في الأمثلة أعلاه. أما في ديسكورد فحدّث Interactions Endpoint URL في Developer Portal بنفسك.

ما لا يُسمح بتقديمه

قدّم على عنوانك ومنفذيك ما يخص بوتك فقط. ويُمنع كل ما يخالف شروط الاستخدام، ومنه:

• صفحات تنتحل خدمة أخرى، أو تجمع كلمات المرور وبيانات الدخول.
• البروكسي والـ VPN وأي تمرير لاتصالات الآخرين.
• استضافة ملفات أو مواقع لا تخص بوتك.

نوقف عنوان الويب والمنافذ لأي بوت يخالف ذلك.