پرش به محتویات

عملیات پیام در نود تلگرام#

از این اکشن‌ها برای ارسال، ویرایش و حذف پیام‌ها در چت؛ ارسال فایل به چت؛ و پین/آن‌پین کردن پیام در یک چت استفاده کنید. برای اطلاعات بیشتر درباره خود نود تلگرام، به تلگرام مراجعه کنید.

افزودن ربات به کانال

برای استفاده بیشتر این اکشن‌ها، باید ربات خود را به یک کانال اضافه کنید تا بتواند پیام‌ها را به آن کانال ارسال کند. برای اطلاعات بیشتر، به مشکلات رایج | افزودن ربات به یک کانال تلگرام مراجعه کنید.

این نود می‌تواند به عنوان ابزاری هوشمند مورد استفاده قرار گیرد

این نود می‌تواند برای افزایش قابلیت‌های یک عامل هوشمند مورد استفاده قرار گیرد. هنگام استفاده به این صورت، بسیاری از پارامترها به طور خودکار تنظیم می‌شوند، یا با اطلاعاتی که توسط هوش مصنوعی هدایت می‌شود - برای اطلاعات بیشتر در مستندات پارامترهای ابزار هوشمند آشنا شوید.

س

حذف پیام چت#

از این عملیات برای حذف یک پیام در چت با استفاده از متد deleteMessage API ربات تلگرام استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبارنامه برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: حذف پیام چت را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانالی که می‌خواهید پیام آن حذف شود را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت در این نود، از نود ٹرگر تلگرام استفاده کنید. برای اطلاعات بیشتر، به مشکل‌های رایج | دریافت شناسه چت مراجعه کنید.
  • شناسه پیام: شناسه یکتای پیامی که می‌خواهید حذف کنید را وارد کنید.

برای اطلاعات بیشتر، به مستندات deleteMessage API ربات تلگرام مراجعه کنید.

ویرایش متن پیام#

از این عملیات برای ویرایش متن یک پیام موجود با استفاده از متد editMessageText API ربات تلگرام استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ویرایش متن پیام را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانالی که می‌خواهید خارج شوید را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت در این نود، از نود ٹرگر تلگرام استفاده کنید. برای اطلاعات بیشتر، به مشکل‌های رایج | دریافت شناسه چت مراجعه کنید.
  • شناسه پیام: شناسه یکتای پیام مورد نظر را وارد کنید.
  • Markup پاسخ: مشخص کنید که آیا از کیبورد داخلی برای نمایش InlineKeyboardMarkup استفاده کنید یا خیر. این پارامتر reply_markup را تنظیم می‌کند. برای اطلاعات بیشتر، به InlineKeyboardMarkup مراجعه کنید.
  • متن: متن جدیدی که می‌خواهید پیام به آن تغییر کند را وارد کنید.

برای جزئیات بیشتر، به مستندات editMessageText API ربات تلگرام مراجعه کنید.

فیلدهای اضافی ویرایش متن پیام#

از فیلدهای اضافی برای تنظیم رفتار نود بیشتر استفاده کنید. برای افزودن هر یک از موارد زیر، اضافه کردن فیلد را انتخاب کنید:

  • غیرفعال کردن پیش‌نمایش صفحه وب: مشخص کنید که لینک‌ها در پیام پیش‌نمایش داشته باشند (خاموش) یا نداشته باشند (روشن). این پارامتر link_preview_options را برای is_disabled تنظیم می‌کند. برای اطلاعات بیشتر، به LinkPreviewOptions مراجعه کنید.
  • حالت پارس: مشخص کنید که پیام با HTML (پیش‌فرض)، مارک‌دان (Legacy) یا MarkdownV2 تفسیر شود. این پارامتر parse_mode را تنظیم می‌کند.

پین کردن پیام چت#

از این عملیات برای پین کردن یک پیام در چت، با استفاده از متد pinChatMessage API ربات تلگرام، استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: پین پیام چت را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مورد نظر برای پین کردن پیام را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت، از نود ٹرگر تلگرام استفاده کنید. برای اطلاعات بیشتر، به مشکل‌های رایج | دریافت شناسه چت مراجعه کنید.
  • شناسه پیام: شناسه یکتای پیام مورد نظر را وارد کنید.

برای جزئیات، به مستندات pinChatMessage API ربات تلگرام مراجعه کنید.

فیلدهای اضافی برای پین کردن پیام#

از فیلدهای اضافی برای تنظیم رفتار بیشتر نود استفاده کنید. برای افزودن هر یک، اضافه کردن فیلد را برگزینید:

  • غیرفعال کردن اعلان‌ها: در حالت پیش‌فرض، تلگرام به همه اعضای چت اطلاع می‌دهد که پیام پین شده است. اگر نمی‌خواهید این اعلان‌ها ارسال شوند، این گزینه را فعال کنید. این پارامتر disable_notification را روی true قرار می‌دهد.

ارسال انیمیشن#

از این عملیات برای ارسال GIF یا ویدئوهای H.264/MPEG-4 AVC بدون صدا تا حجم 50 مگابایت، با استفاده از متد sendAnimation API ربات تلگرام استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال انیمیشن را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مقصد را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت، از نود [ٹرگر تلگرام] استفاده کنید. برای مشاهده، به [مشکل‌های رایج | دریافت شناسه چت] مراجعه کنید.
  • فایل باینری: برای ارسال فایل باینری از خود نود، این گزینه را فعال کنید. در صورت فعال‌سازی، باید فیلد ورودی باینری که شامل فایل است را وارد کنید.
  • انیمیشن: در صورت عدم استفاده از فایل باینری، اینجا انیمیشن را وارد کنید. می‌توانید file_id بدهید تا فایل موجود بر سرورهای تلگرام ارسال شود یا URL HTTP برای گرفتن فایل از اینترنت.
  • Markup پاسخ: برای تنظیم گزینه‌های بیشتر در رابط کاربری، از این پارامتر استفاده کنید. برای اطلاعات بیشتر، به پارامترهای reply_markup مراجعه کنید.

برای اطلاعات بیشتر، به مستندات sendAnimation API ربات تلگرام مراجعه کنید.

فیلدهای اضافی برای ارسال انیمیشن#

از فیلدهای اضافی برای تنظیم رفتار نود بیشتر با استفاده از فیلدهای اختیاری در متد sendAnimation تلگرام استفاده کنید. برای افزودن موارد زیر، اضافه کردن فیلد را انتخاب کنید:

  • متن کپشن: متن توضیح برای انیمیشن، حداکثر 1024 کاراکتر.
  • غیرفعال کردن اعلان: انتخاب کنید که آیا اعلان بدون صدا (روشن) ارسال شود یا با اعلان استاندارد (خاموش).
  • مدت زمان: مدت زمان انیمیشن بر حسب ثانیه.
  • ارتفاع: ارتفاع انیمیشن.
  • حالت پارس: پارسی که برای متن‌های مرتبط استفاده می‌شود، شامل HTML (پیش‌فرض)، Markdown (Legacy)، یا MarkdownV2.
  • شناسه پیام پاسخ: اگر پیام در پاسخ است، شناسه پیام اصلی را وارد کنید.
  • شناسه رشته پیام: شناسه یکتای رشته پیام (موضوع) در انجمن؛ فقط برای فروم‌های سوپرگروه.
  • تصویر کوچک (Thumbnail): تصویر کوچک فایل ارسالی. این فیلد را اگر تولید تصویر کوچک توسط سرور پشتیبانی می‌شود، نادیده بگیرید. باید:
  • فرمت JPEG باشد.
  • حجم کمتر از ۲۰۰ کیلوبایت باشد.
  • عرض و ارتفاع کمتر از ۳۲۰ پیکسل باشد.
  • عرض: عرض ویدئو را وارد کنید.

ارسال صوت#

از این عملیات برای ارسال فایل صوتی به چت و نمایش آن در پلیر موزیک، با استفاده از متد sendAudio API ربات تلگرام استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال صدا را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مقصد را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت، از نود [ٹرگر تلگرام] استفاده کنید. برای جزئیات، به [مشکل‌های رایج | دریافت شناسه چت] مراجعه کنید.
  • فیلد باینری: برای ارسال فایل باینری از خود نود، این گزینه را فعال کنید. در صورت فعال‌سازی، باید فیلد ورودی باینری حاوی فایل مورد نظر را وارد کنید.
  • صدا: در صورت عدم استفاده از فایل باینری، اینجا فایل صوتی را وارد کنید. می‌توانید file_id بدهید یا URL HTTP برای دریافت فایل.
  • Markup پاسخ: برای تنظیم گزینه‌های بیشتر، از این پارامتر استفاده کنید. برای اطلاعات بیشتر، به پارامترهای reply_markup مراجعه کنید.

برای اطلاعات بیشتر، به مستندات sendAudio API ربات تلگرام مراجعه کنید.

فیلدهای اضافی برای ارسال صوت#

برای تنظیم رفتار نود، می‌توانید از فیلدهای اختیاری زیر در متد sendAudio استفاده کنید. برای افزودن موارد زیر، اضافه کردن فیلد را برگزینید:

  • متن کپشن: متن توضیحات صوت، حداکثر 1024 کاراکتر.
  • غیرفعال کردن اعلان: ارسال اعلان بی‌صدا (روشن) یا با اعلان استاندارد (خاموش).
  • مدت زمان: طول مدت فایل صوتی بر حسب ثانیه.
  • حالت پارس: همانند پیام‌های متنی، شامل HTML، Markdown (Legacy)، MarkdownV2.
  • کنیدکننده: نام اجراکننده.
  • شناسه پیام پاسخ: در صورت پاسخ بودن، شناسه پیام مورد نظر.
  • شناسه رشته پیام: شناسه یکتای رشته پیام (موضوع) در انجمن؛ فقط برای فروم‌های سوپرگروه.
  • عنوان: نام قطعه صوتی.
  • تصویر کوچک (Thumbnail): تصویر کوچک فایل، با مشخصات ذکر شده در بالا.

ارسال وضعیت چت#

از این عملیات برای اعلام وضعیت در حال انجام در چت، با استفاده از متد sendChatAction API ربات تلگرام بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: انتقال وضعیت را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مقصد را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت، از نود [ٹرگر تلگرام] استفاده کنید. مراجعه کنید به [مشکل‌های رایج | دریافت شناسه چت].
  • عمل: نوع وضعیت مورد نظر را انتخاب کنید، مانند: پیدا کردن مکان، در حال تایپ، ضبط صدا یا ویدئو، و بارگذاری فایل.

برای اطلاعات بیشتر، به مستندات sendChatAction مراجعه کنید.

ارسال فایل#

از این عملیات برای ارسال فایل به چت، با استفاده از متد sendDocument API ربات تلگرام استفاده کنید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال سند را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مورد نظر را وارد کنید.
  • برای وارد کردن شناسه چت مستقیم، از نود [ٹرگر تلگرام] استفاده کنید. برای اطلاعات بیشتر، مراجعه کنید به [مشکل‌های رایج | دریافت شناسه چت].
  • فایل باینری: برای ارسال فایل باینری از خود نود، این گزینه را فعال کنید.
  • سند: در صورت عدم استفاده از فایل باینری، سند موردنظر را وارد کنید. می‌توانید file_id بدهید یا URL HTTP.
  • Markup پاسخ: تنظیم گزینه‌های بیشتر، با این پارامتر انجام می‌شود. برای جزئیات، به پارامترهای reply_markup مراجعه کنید.

برای اطلاعات بیشتر، به مستندات sendDocument API ربات تلگرام مراجعه کنید.

فیلدهای اضافی برای ارسال سند#

برای تنظیم رفتار نود، از فیلدهای اختیاری زیر در متد sendDocument می‌توان استفاده کرد. برای افزودن موارد زیر، اضافه کردن فیلد را برگزینید:

  • متن کپشن: متن توضیح فایل، حداکثر 1024 کاراکتر.
  • غیرفعال کردن اعلان: ارسال بدون صدا (روشن) یا با اعلان استاندارد (خاموش).
  • حالت پارس: HTML، Markdown (Legacy)، MarkdownV2.
  • شناسه پیام پاسخ: در صورت پاسخ بودن، شناسه پیام.
  • شناسه رشته پیام: شناسه یکتای موضوع، فقط برای سوپرگروه‌های انجمن.
  • تصویر کوچک (Thumbnail): همانند قبل، با مشخصات ذکر شده.

ارسال موقعیت مکانی#

از این عملیات برای ارسال مکان بر روی نقشه به چت، با استفاده از متد sendLocation API ربات تلگرام بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال مکان را انتخاب کنید.
  • شناسه چت: شناسه چت یا نام کاربری کانال مقصد را در قالب @channelusername وارد کنید.
  • برای وارد کردن مستقیم شناسه چت، از نود [ٹرگر تلگرام] استفاده کنید.
  • عرض جغرافیایی (Latitude): عرض جغرافیایی مکان را وارد کنید.
  • طول جغرافیایی (Longitude): طول جغرافیایی مکان را وارد کنید.
  • Markup پاسخ: تنظیم گزینه‌های بیشتر، مانند موارد قبل.

برای جزئیات، به sendLocation مراجعه کنید.

فیلدهای اضافی ارسال مکان#

برای تنظیم رفتار بیشتر، می‌توانید موارد زیر را وارد کنید:

  • غیرفعال کردن اعلان: خاموش یا روشن بودن.
  • شناسه پیام پاسخ: اگر در پاسخ است، شناسه پیام.
  • شناسه رشته پیام: برای موضوع، فقط برای سوپرگروه‌ها.

ارسال گروه رسانه‌ای#

از این عملیات برای ارسال گروهی عکس‌ها و/یا ویدئوها با استفاده از متد sendMediaGroup API بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال گروه رسانه را انتخاب کنید.
  • شناسه چت: شناسه یا نام کاربری کانال مقصد در قالب @channelusername.
  • برای وارد کردن مستقیم شناسه چت، از نود [ٹرگر تلگرام] استفاده کنید.
  • رسانه (Media): با اضافه کردن رسانه، نوع موردنظر را مشخص کنید:
  • نوع: عکس یا ویدئو.
  • فایل رسانه: فایل رسانه را وارد کنید، یا file_id بدهید، یا URL HTTP.
  • فیلدهای اضافی: برای هر فایل، موارد زیر قابل تنظیم است:
    • کپشن: متن توضیحات، حداکثر 1024 کاراکتر.
    • حالت پارس: HTML، Markdown (Legacy)، MarkdownV2.

برای مستندات کامل، به sendMediaGroup مراجعه کنید.

فیلدهای اضافی برای ارسال گروه رسانه‌ای#

برای تنظیم رفتار تکمیلی، از فیلدهای اضافی در توابع sendMediaGroup استفاده کنید:

  • غیرفعال کردن اعلان: روشن یا خاموش بودن.
  • شناسه پیام پاسخ: اگر در پاسخ است، شناسه پیام.
  • شناسه رشته پیام: فقط برای سوپرگروه‌های فوروم.

ارسال پیام#

از این عملیات برای ارسال پیام به چت با استفاده از متد sendMessage API بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود ایجاد یا انتخاب کنید.
  • منبع: پیام را انتخاب کنید.
  • عملیات: ارسال پیام را انتخاب کنید.
  • شناسه چت: در قالب @channelusername.
  • برای وارد کردن مستقیم، از نود [ٹرگر تلگرام] استفاده کنید.
  • متن: متن پیام؛ حداکثر 4096 کاراکتر بعد از پارس کردن موجودیت‌ها.

برای اطلاعات بیشتر، به sendMessage مراجعه کنید.

محدودیت‌های ارسال پیام

تلگرام حداکثر ۳۰ پیام در ثانیه مجاز می‌داند. در صورت نزدیک‌شدن به این محدودیت، به ارسال بیش از 30 پیام در ثانیه مراجعه کنید.

فیلدهای اضافی برای ارسال پیام#

برای تنظیمات بیشتر، از گزینه‌های زیر در بخش فیلدهای اضافی استفاده کنید:

  • افزودن نشان نیش n8n: در صورت فعال بودن، پیام با عنوان این پیام به صورت خودکار با n98n ارسال شده است پایان می‌یابد.
  • غیرفعال کردن اعلان: خاموش یا روشن کردن نوتیفیکیشن.
  • غیرفعال کردن پیش‌نمایش صفحه وب: لینک‌ها در پیام پیش‌نمایش داشته باشند یا خیر.
  • حالت پارس: HTML، Markdown (Legacy)، MarkdownV2.
  • شناسه پیام پاسخ: در صورت پاسخ، شناسه پیام اصلی.
  • شناسه رشته پیام: فقط برای سوپرگروه‌ها.

ارسال و انتظار پاسخ#

از این عملیات برای ارسال پیام و توقف ورکفلو تا تایید کاربر، با استفاده از متد sendMessage API بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام.
  • منبع: پیام.
  • عملیات: ارسال و انتظار برای پاسخ.
  • شناسه چت: در قالب @channelusername.
  • برای وارد کردن مستقیم، از نود [ٹرگر تلگرام] استفاده کنید.
  • پیام: متن مورد نظر.
  • نوع پاسخ: نوع تایید یا پاسخ مورد نظر:
    • تاییدیه: کاربران می‌توانند تایید یا رد کنند.
    • متن آزاد: پاسخ با فرم.
    • فرم سفارشی: پاسخ با فرم دلخواه.

برای جزئیات، به مستندات sendMessage مراجعه کنید.

محدودیت‌های ارسال پیام

تلگرام حداکثر ۳۰ پیام در ثانیه مجاز می‌داند. در صورت نیاز، به ارسال بیش از 30 پیام در ثانیه مراجعه کنید.

فیلدهای اضافی ثبت پاسخ و انتظار#

نوع‌های پاسخ متفاوت، فیلدهای زیر را دارند:

تاییدیه#

گزینه‌های پاسخ تاییدیه:

  • نوع تایید: فقط دکمه تایید یا هر دو تایید و رد.
  • برچسب دکمه: متن برای دکمه تایید یا رد. پیش‌فرض‌ها: ✅ تایید و ❌ رد.
  • مدت زمان انتظار: پس از مدت زمان مشخصی، عملیات به صورت خودکار ادامه می‌یابد، به صورت دوره‌ای یا زمانی خاص.

متن آزاد#

در صورت استفاده از متن آزاد، گزینه‌ها:

  • برچسب دکمه پیام: "پاسخ دهید" است.
  • عنوان فرم پاسخ: عنوان فرم پاسخ.
  • توضیحات فرم: توضیح برای فرم.
  • برچسب دکمه فرم: "ارسال" است.
  • مدت زمان انتظار: همانند قبل، تایم‌اسکیل یا زمان واقعی.

فرم سفارشی#

در این حالت، می‌توانید فرم ساخته شده با موارد دلخواه را تنظیم کنید. از امکانات عناصر فرم در n8n استفاده کنید. برای افزودن فیلد، روی افزودن عنصر فرم کلیک کنید.

عناصر زیر در دسترس است:

  • برچسب دکمه پیام: "پاسخ دهید".
  • عنوان فرم: عنوان فرم.
  • توضیحات فرم: توضیحات.
  • برچسب دکمه فرم: "ارسال".
  • مدت زمان انتظار: به صورت دوره‌ای یا زمانی خاص.

ارسال عکس#

از این عملیات برای ارسال عکس به چت، با استفاده از متد sendPhoto API بهره بگیرید.

پارامترهای زیر را وارد کنید:

  • اعتبار برای کانکشن: یک اعتبار تلگرام موجود یا جدید.
  • منبع: پیام.
  • عملیات: ارسال عکس.
  • شناسه چت: در قالب @channelusername.
  • برای وارد کردن مستقیم، از نود [ٹرگر تلگرام] استفاده کنید.
  • فایل باینری: فعال کنید اگر فایل را از خود نود می‌خواهید ارسال کنید.
  • عکس: در صورت عدم استفاده از فایل باینری، تصویر را وارد کنید، یا file_id یا URL.
  • Markup پاسخ: تنظیم گزینه‌های بیشتر.

برای جزئیات، به sendPhoto مراجعه کنید.

فیلدهای اضافی برای ارسال عکس#

ایجاد کپشن، غیرفعال کردن اعلان، پارس کردن متن، شناسه پیام پاسخ و موارد دیگر. مطابق توضیحات ارسال فایل، اضافه کنید.

ارسال استیکر#

برای ارسال استیکرهای استاتیک (WEBP)، انیمیشن (TGS) یا ویدیویی (WEBM) از sendSticker API استفاده کنید.

پارامترهای لازم:

  • اعتبار برای کانکشن: اعتبار تلگرام.
  • منبع: پیام.
  • عملیات: ارسال استیکر.
  • شناسه چت: در قالب @channelusername.
  • برای وارد کردن مستقیم، از نود [ټرگر تلگرام] استفاده کنید.
  • فایل باینری: فعال کنید برای فایل از خود نود.
  • استیکر: فایل استیکر، file_id یا URL.
  • Markup پاسخ: تنظیم بیشتر.

برای جزئیات، به sendSticker مراجعه کنید.

فیلدهای اضافی برای ارسال استیکر#

شامل تنظیم اعلان، شناسه پیام پاسخ و شناسه جلسه، همراه با عناصر افزوده.

ارسال ویدئو#

برای ارسال ویدئو، با متد sendVideo API بهره‌برداری کنید.

پارامترهای زیر:

  • اعتبار برای کانکشن: اعتبار تلگرام.
  • منبع: پیام.
  • عملیات: ارسال ویدئو.
  • شناسه چت: در قالب @channelusername.
  • فایل باینری: فعال‌سازی.
  • ویدئو: فایل، file_id یا URL.
  • Markup پاسخ: تنظیمات بیشتر.

جزئیات در sendVideo.

فیلدهای اضافی برای ویدئو#

کپشن، مدت زمان، ارتفاع، حالت پارس، شناسه پیام پاسخ، شناسه تریگر، ابعاد و تصویر کوچک، تمامی مطابق توضیحات بالا.

آنپین کردن پیام#

برای حذف پین از پیام، از unpinChatMessage API بهره‌مند شوید.

پارامترهای مورد نیاز:

  • اعتبار برای کانکشن: اعتبار تلگرام.
  • منبع: پیام.
  • عملیات: حذف پین پیام.
  • شناسه چت: در قالب @channelusername.
  • شناسه پیام: شناسه پیام پین شده.

مراجعه کنید به unpinChatMessage.

پارامترهای inline و reply_markup#

برای بیشتر عملیات‌های ارسال پیام (مانند ارسال انیمیشن، صدا، عکس)، از پارامتر پاسخ‌گویی برای تنظیم منو و نوارهای تعاملی استفاده کنید:

  • فورس ریپلای: نمایش رابط پاسخ‌گویی با گزینه پاسخ، همانند حالت خودکار.
  • کلیکه داخلی: نمایش کیبورد داخلی در کنار پیام.
  • کلیکه پاسخ: نمایش کیبورد شخصی با گزینه‌های پاسخ.
  • حذف کیبورد پاسخ: حذف کیبورد قبلی و نمایش کیبورد پیش‌فرض.

حساب‌های کسب‌وکار تلگرام

در کانال‌ها و پیام‌های ارسالی از طرف حساب کسب‌وکار تلگرام، این گزینه‌ها محدود هستند:

  • فورس ریپلای
  • کیبورد پاسخ
  • حذف کیبورد پاسخ

پارامترهای فورس ریپلای#

در صورت نیاز به وردیابی کاربر بدون کاهش حالت حریم شخصی، از گزینه فورس ریپلای استفاده کنید:

  • فورس ریپلای: فعال کنید.
  • انتخابی: فعال است اگر بخواهید فقط کاربرانی خاص پاسخ دهند:
  • کاربرانی که در متن پیام @mention شده‌اند.
  • فرستنده پیام اصلی، در پاسخ به این پیام.

برای اطلاعات بیشتر، به ForceReply مراجعه کنید.

پارامترهای کیبورد داخلی (Inline Keyboard)#

در صورت فعال‌سازی، از اضافه کردن دکمه برای ساخت کیبورد استفاده کنید. برای افزودن ردیف جدید، از افزودن ردیف کیبورد استفاده کنید.

برای اطلاعات، به InlineKeyboardMarkup و InlineKeyboardButtons مراجعه کنید.

پارامترهای کیبورد پاسخ (Reply Keyboard)#

در صورت فعال‌سازی، بخش کیبورد پاسخ برای ساخت فهرستی از دکمه‌ها و ردیف‌ها استفاده می‌شود.

برای تنظیم رفتار، گزینه‌های زیر را در انتخاب‌های کیبورد پاسخ قرار دهید:

  • اندازه‌گیری مجدد کیبورد: فعال یا غیرفعال کردن.
  • یک‌بار بودن کیبورد: پس از اولین استفاده، مخفی یا نمایش دائمی.
  • انتخابی: فعال است اگر فقط برای کاربران خاص باشد:
  • کاربران @mention شده.
  • فرستنده پیام اصلی.

برای جزئیات، به ReplyKeyboardMarkup مراجعه کنید.

پارامترهای حذف کیبورد پاسخ#

در صورت فعال‌سازی، گزینه‌های زیر:

  • حذف کیبورد: درخواست حذف کیبورد شخصی یا نگه داشتن آن.
  • انتخابی: فقط برای کاربران خاص، همانند قبل.

برای جزئیات، به ReplyKeyboardRemove مراجعه کنید.