با استفاده از داکیومنت موجود در زیر من چطوری میتونم وقتی یک ویدیو کال در یک گروه تلگرامی…
- User
با استفاده از داکیومنت موجود در زیر من چطوری میتونم وقتی یک ویدیو کال در یک گروه تلگرامی شروع میشود از طریق ربات cli بصورت خودکار به ویدیو کال بپیوندم https://docs.pyrogram.org/telegram/functions/phone/join-group-call
- Assistant
برای پیوستن به یک تماس ویدئویی (کال) گروهی در تلگرام از طریق یک ربات بر پایه
Pyrogramو استفاده از متدjoin_group_call، توجه داشته باشید که باید چند گام مقدماتی را طی کنید. در زیر به شما نحوه انجام این کار را قدم به قدم توضیح میدهیم.1. نصب Pyrogram
در ابتدا مطمئن شوید که
Pyrogramروی سیستم شما نصب است. این کار را میتوانید با اجرای دستور زیر در ترمینال انجام دهید:pip install pyrogram tgcrypto2. ایجاد API Key و Hash
برای استفاده از API تلگرام، شما نیاز به یک API key و API hash دارید که از طریق وبسایت my.telegram.org با ایجاد یک اپلیکیشن جدید به دست میآید.
3. ایجاد ربات با BotFather
اگر قبلاً یک ربات تلگرام نساختهاید، با استفاده از
BotFatherدر تلگرام یک ربات بسازید و توکن API را دریافت کنید.4. راهاندازی اسکریپت Pyrogram
برای استفاده از متد
join_group_call، شما باید یک اسکریپت پایتون بنویسید کهPyrogramرا به عنوان کلاینت استفاده کرده و سپس به کال گروهی بپیوندید. اما توجه داشته باشید که API تلگرام محدودیتهایی دارد و ممکن است مستقیماً نتوان با استفاده از API ربات به تماس گروهی پیوست. راهحل ممکن است نیازمند استفاده از کلاینت userbot (یک کاربر معمولی که به عنوان ربات رفتار میکند) باشد، نه یک ربات API معمولی.توجه: استفاده از userbots و دستکاری API ها ممکن است با قوانین و مقررات تلگرام مغایرت داشته باشد.
این مثالی است که چگونگی اتصال به کال گروهی با استفاده از یک userbot را نشان میدهد. کد زیر نیاز به تنظیمات بیشتری دارد و فقط یک مثال اولیه است:
from pyrogram import Client, filters app = Client("my_account", api_id=123456, api_hash="your_api_hash") @app.on_message(filters.command(["joincall"], prefixes="!")) async def join_call(client, message): chat_id = message.chat.id # تنظیمات لازم برای پیوستن به گروه کال # دقت کنید مستقیما از رباتها نمیتوان برای پیوستن به کال استفاده کرد. pass app.run()نکته مهم
مستندات
Pyrogramمربوط به methodهایی است که کار با کلاینتهای کاربر (userbot) را تسهیل میبخشد و از رباتهای رسمی API پشتیبانی نمیکند. برای پیوستن به تماس ویدئویی از طریق ربات به صورت خودکار، ممکن است نیاز به یک رویکرد خلاقانهتر و برخی دور زدن محدودیتها داشته باشید.این اطلاعات بر پایه دانش و قوانین موجود تا زمان ذکر شده است، و توصیه میشود پیش از اقدام، بهروزرسانیها و اصلاحات احتمالی ذیربط را بررسی کنید.
- User
من میخواهم از ربات های کلاینتی برای پیوستن به یک ویدیو مال لستفاده کنم. در واقع رباتی که بتونه به حساب کاربری من در تلگرام وصل بشه
- Assistant
اگر میخواهید یک ربات کلاینتی (معمولاً به آن userbot گفته میشود) ایجاد کنید که به حساب کاربری شخصی شما در تلگرام وصل شود و به تماس ویدئویی (ویدئو کال) گروهی بپیوندد، باید بدانید که این کار از طریق API رسمی تلگرام و رباتهای استاندارد API امکانپذیر نیست. به جای آن، شما نیاز به استفاده از یک کلاینت تلگرام دارید که با استفاده از
API IDوAPI Hashشخصی خودتان به حسابتان وصل شود. در اینجا نحوه انجام این کار با استفاده از Pyrogram را توضیح میدهیم.1. دریافت
API IDوAPI Hashاولین قدم، دریافت
API IDوAPI Hashاز طریق my.telegram.org است. وارد حساب خود شوید، به بخش "API development tools" بروید و یک برنامه جدید ایجاد کنید. پس از ایجاد برنامه،API IDوAPI Hashبه شما داده میشود که برای اتصال به Pyrogram نیاز دارید.2. نصب Pyrogram
از طریق ترمینال یا CMD، Pyrogram را با دستور زیر نصب کنید:
pip install pyrogram tgcrypto3. کد برای اتصال به حساب و پیوستن به تماس
ایجاد یک فایل پایتون (
join_group_call.pyبه عنوان مثال) و کد زیر را در آن قرار دهید:from pyrogram import Client app = Client("my_account", api_id=YOUR_API_ID, api_hash="YOUR_API_HASH") @app.on_message() async def join_group_call(client, message): if message.text == "!join_call": # اینجا فرض بر این است که شما دسترسی به chat_id و call مورد نظر دارید try: await client.join_group_call( chat_id=CHAT_ID, # تنظیمات دیگر لازم برای پیوستن به call ) print("با موفقیت به تماس پیوستید") except Exception as e: print(f"یک خطا رخ داد: {e}") # تنظیمات دیگر و شروع کلاینت app.run()توجه: به جای
YOUR_API_IDوYOUR_API_HASHبایدAPI IDوAPI Hashخود را قرار دهید. همچنینCHAT_IDرا باید به شناسه چت گروهی که میخواهید به تماس آن بپیوندید، تغییر دهید.4. اجرای اسکریپت
پس از آمادهسازی اسکریپت، فقط کافی است تا آن را با استفاده از پایتون اجرا کنید:
python join_group_call.pyاز طریق این اسکریپت، شما میتوانید مستقیما به حساب کاربری خود در تلگرام متصل شوید و به تماسهای ویدئویی گروهی بپیوندید. این مثال بسیار ابتدایی است و ممکن است بنا به نیازهای خاص شما نیاز به تنظیمات پیچیدهتری داشته باشد.
- User
اشتباه داری راهنمایی میکنی. تو اصلا از class pyrogram.raw.functions.phone.JoinGroupCall که در داکیومنت بود استفاده نکردی آيا تو gpt4 هستی یا 3.5
- Assistant
معذرت میخواهم برای هرگونه سردرگمی که پیش آمد. مروری بر پرسش شما نشان میدهد که درخواست شما استفاده از
pyrogram.raw.functions.phone.JoinGroupCallاست، که در نسخههای خام (raw) API تلگرام تعریف شده. بیایید نحوه استفاده از این تابع را در Pyrogram بررسی کنیم:استفاده از
pyrogram.raw.functions.phone.JoinGroupCallبرای استفاده از این تابع، نخست باید اطمینان حاصل فرمایید که
PyrogramوTgCryptoنصب شدهاند. اگر نصب نکردهاید، دستورات زیر را اجرا نمایید:pip install pyrogram tgcryptoسپس میتوانید مثال زیر را به عنوان راهنمایی برای نحوه استفاده از
JoinGroupCallدر Pyrogram استفاده نمایید. توجه داشته باشید، این کد به منظور نمونه است و شما باید آن را بنا به نیازهای خاص خود تنظیم کنید:from pyrogram import Client from pyrogram.raw.functions.phone import JoinGroupCall from pyrogram.raw.types import InputGroupCall, InputPeerSelf import asyncio api_id = 'YOUR_API_ID' api_hash = 'YOUR_API_HASH' # ایجاد نمونهای از کلاینت Pyrogram با استفاده از API ID و API Hash شما app = Client("my_account", api_id=api_id, api_hash=api_hash) async def join_call(chat_id, call_id): async with app: # این کد فرض میکند که شما به عنوان کاربری (User) در حال اتصال هستید # و از InputPeerSelf برای مشخص کردن شخصی که قرار است به تماس وارد شود، استفاده میکند. result = await app.send( JoinGroupCall( peer=await app.resolve_peer(chat_id), call=InputGroupCall(id=call_id), join_as=InputPeerSelf(), # شما ممکن است نیاز به تنظیم پارامترهای بیشتری داشته باشید ) ) print(result) # جایگزین کردن `chat_id` و `call_id` با مقادیر مورد نظر شما chat_id = 'CHAT_ID' call_id = YOUR_CALL_ID loop = asyncio.get_event_loop() loop.run_until_complete(join_call(chat_id, call_id))این کد مثال، چگونگی اتصال به یک تماس گروهی (Group Call) با استفاده از Pyrogram و API خام (Raw API) تلگرام را نمایش میدهد. دقت داشته باشید که
YOUR_API_ID,YOUR_API_HASH,CHAT_ID, وYOUR_CALL_IDباید با اطلاعات صحیح جایگزین شود.برای دریافت
call_idممکن است نیاز باشد که ابتدا اطلاعات جلسه تماس گروهی (Group Call) را با استفاده از توابع مرتبط دریافت کنید. این اطلاعات اغلب نیازمند ارتباط با API و درخواستهای مخصوص به تماس هستند.پوزش میطلبم برای قصور در اولین پاسخ و امیدوارم این اطلاعات به شما کمک کند.
- User
call_id رو از کجا باید پیدا کنم؟ من میخواهم وقتی کاربر به یک ویدیو کال دعوت شد call_id رو خودکار بگیره
- Assistant
برای آنکه بتوانید
call_idیک ویدیو کال در تلگرام را به صورت خودکار دریافت کنید، میتوانید از فرآیند زیر استفاده کنید:1. گوش دادن به آپدیتهای جدید
شما باید رویدادهای (events) وارد شده به گروه یا کانالی که کاربر (یا userbot شما) در آن عضو است را گوش دهید. این کار ممکن است شامل گوش دادن به پیامهایی باشد که اطلاعات تماس گروهی را حمل میکنند.
2. دریافت اطلاعات تماس با استفاده از API
هنگامی که یک ویدیو کال در گروه آغاز میشود، ممکن است توسط پیام یا آپدیت خاصی در API اطلاعرسانی شود. بسته به نحوه اجرای API تلگرام و کتابخانهای که استفاده میکنید، میتوانید به اطلاعات مربوط به شروع تماس دست یابید. برای مثال، در Pyrogram شما میتوانید از event listener برای شنیدن آپدیتها استفاده کنید.
3. استفاده از
GetGroupCallیکی از توابعی که ممکن است برای این منظور مفید باشد
GetGroupCallاست. با استفاده از این تابع، میتوانید اطلاعات فعلی تماس گروهی را بگیرید، که شاملcall_idمورد نیاز برای پیوستن به تماس خواهد بود.from pyrogram import Client from pyrogram.raw.functions.phone import GetGroupCall app = Client("my_account", api_id=YOUR_API_ID, api_hash="YOUR_API_HASH") async def get_group_call(chat_id): async with app: result = await app.send(GetGroupCall(peer=await app.resolve_peer(chat_id))) print(result) # جایگزین کردن `chat_id` با مقدار مورد نظر شما chat_id = 'CHAT_ID' loop = asyncio.get_event_loop() loop.run_until_complete(get_group_call(chat_id))در این نمونه کد، فرض بر این است که شما در گروه مورد نظر عضو هستید و در جستجوی اطلاعات فعلی تماس گروهی هستید که
call_idرا در خود دارد.توجه
- همیشه در استفاده از API تلگرام و کتابخانههای ثالث مربوطه، قوانین و محدودیتهای API تلگرام را در نظر داشته باشید تا از هرگونه مشکلی جلوگیری کنید.
- نمونه کدهایی که ارائه شدهاند، بر اساس فرضیات صورت گرفته در سوال هستند و ممکن است نیاز به تنظیمات و تغییراتی بر اساس نیازهای واقعی شما داشته باشند.
امیدوارم این توضیحات به شما کمک کند تا با استفاده از Pyrogram به صورت خودکار
call_idویدیو کالهای تلگرام را دریافت کنید.