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

ارسال و ویرایش پیام‌ها و رسانه‌ها

در این بخش متدهای مربوط به ارسال متن، تصاویر، ویدیو، فایل‌های صوتی و اسناد، فوروارد، کپی، ویرایش، حذف پیام و ارسال وضعیت چت (Typing) توضیح داده شده است.

۱. ارسال پیام متنی (sendMessage)

ارسال پیام متنی به کاربر یا گفتگو.

POST https://botapi.codemeet.chat/bot<TOKEN>/sendMessage

پارامترهای ورودی

پارامتر نوع وضعیت توضیحات
chat_id String اجباری شناسه منحصر‌به‌فرد چت مقصد (UUID) یا نام کاربری کانال/گروه عمومی (مانند @channelusername).
text String اجباری متن پیام ارسالی (حداکثر ۳۲,۷۶۸ کاراکتر).
parse_mode String اختیاری حالت قالب‌بندی متن (HTML، Markdown، MarkdownV2).
entities Array of MessageEntity اختیاری لیست موجودیت‌های متن قالب‌بندی‌شده (در صورت عدم استفاده از parse_mode).
reply_to_message_id Integer اختیاری شماره توالی پیام مقصد برای ریپلای زدن.
disable_notification Boolean اختیاری ارسال پیام بدون تولید صدای نوتیفیکیشن برای کاربران.
reply_markup Object اختیاری کیبورد شیشه‌ای، کیبورد معمولی یا دستور حذف کیبورد.

نمونه درخواست

{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122",
  "text": "<b>سفارش شما با موفقیت ثبت شد!</b>\nکد پیگیری: <code>#12345</code>",
  "parse_mode": "HTML",
  "reply_markup": {
    "inline_keyboard": [
      [{"text": "پرداخت آنلاین", "url": "https://example.com/pay"}]
    ]
  }
}

۲. ارسال رسانه (sendPhoto / sendVideo / sendDocument / sendVoice)

برای ارسال انواع فایل و مدیا از متدهای اختصاصی زیر استفاده کنید:

  • sendPhoto: ارسال تصویر
  • sendVideo: ارسال ویدیو
  • sendDocument: ارسال انواع فایل و اسناد
  • sendVoice: ارسال وویس و فایل صوتی
POST https://botapi.codemeet.chat/bot<TOKEN>/sendPhoto

پارامترهای ورودی

پارامتر نوع وضعیت توضیحات
chat_id String اجباری شناسه چت مقصد.
photo / media_id UUID اجباری شناسه فایل آپلود شده در سرویس مدیای کدمیت.
caption String اختیاری متن کپشن زیر مدیا (تا ۳۲,۷۶۸ کاراکتر).
parse_mode String اختیاری حالت قالب‌بندی کپشن (HTML یا Markdown).
reply_to_message_id Integer اختیاری شماره پیام برای ریپلای.
reply_markup Object اختیاری دکمه‌های شیشه‌ای یا کیبورد. 
{
  "chat_id": "e9b2a1c0-4411-4fa3-9f88-d4508671b122",
  "photo": "3f889c20-a8d2-43bb-a1b4-927181043211",
  "caption": "تصویر محصول جدید"
}

۳. فوروارد و کپی پیام (forwardMessage / copyMessage)

forwardMessage

ارسال مجدد پیام با حفظ برچسب فوروارد و فرستنده اصلی:

{
  "chat_id": "destination-chat-id",
  "from_chat_id": "source-chat-id",
  "message_id": 142
}

copyMessage

کپی کردن کامل محتوای پیام (متن یا مدیا) بدون الصاق تگ فوروارد، همراه با امکان تغییر کپشن و کیبورد:

{
  "chat_id": "destination-chat-id",
  "from_chat_id": "source-chat-id",
  "message_id": 142,
  "caption": "کپشن جدید جایگزین شد"
}

۴. ویرایش پیام‌ها (editMessageText / editMessageCaption / editMessageReplyMarkup)

ربات‌ها می‌توانند پیام‌هایی که خودشان ارسال کرده‌اند را ویرایش کنند:

editMessageText

{
  "chat_id": "chat-id",
  "message_id": 25,
  "text": "وضعیت پردازش: تکمیل شد",
  "reply_markup": {
    "inline_keyboard": [
      [{"text": "بازگشت به منو", "callback_data": "menu"}]
    ]
  }
}

editMessageCaption

{
  "chat_id": "chat-id",
  "message_id": 26,
  "caption": "کپشن به‌روزرسانی شد"
}

editMessageReplyMarkup

ویرایش یا حذف کیبورد شیشه‌ای یک پیام بدون تغییر متن آن: 

{
  "chat_id": "chat-id",
  "message_id": 25,
  "reply_markup": { "inline_keyboard": [] }
}

۵. حذف پیام (deleteMessage)

حذف یک پیام مشخص از گفتگو:

POST https://botapi.codemeet.chat/bot<TOKEN>/deleteMessage 
{
  "chat_id": "chat-id",
  "message_id": 25
}

۶. ارسال وضعیت چت (sendChatAction)

نمایش وضعیت فعالیت ربات (مانند typing، upload_photo، record_video) در بالای صفحه چت کاربر:

POST https://botapi.codemeet.chat/bot<TOKEN>/sendChatAction 

{
  "chat_id": "chat-id",
  "action": "typing"
}
اکشن‌های مجاز شامل: typing, upload_photo, record_video, upload_video, record_voice, upload_voice, upload_document, choose_sticker, find_location.