Bot API

ارسال پیام

متدهای اصلی ارسال متن، عملیات پیام و پیام‌های چندرسانه‌ای در مسیر Bot API یونیوم.

sendMessage

متد اصلی برای ارسال متن:

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "@username",
    "text": "پیام تست",
    "parse_mode": "HTML"
  }'

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

پارامتر	ضروری	توضیح
`chat_id`	بله	مقصد پیام
`text`	بله	متن پیام
`parse_mode`	خیر	`HTML`، `Markdown` یا حالت‌های پشتیبانی‌شده
`reply_to_message_id`	خیر	پاسخ به یک پیام قبلی
`disable_notification`	خیر	ارسال بی‌صدا

ارسال عملیات چت

برای نمایش وضعیت‌هایی مثل typing:

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendChatAction" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"@username","action":"typing"}'

forward و copy

وقتی می‌خواهید پیام موجود را به مقصد دیگری منتقل کنید:

curl -X POST "https://api.uniom.ir/bot<API_KEY>/forwardMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"@target","from_chat_id":"@source","message_id":123}'

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

ویرایش و حذف

curl -X POST "https://api.uniom.ir/bot<API_KEY>/editMessageText" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"@username","message_id":123,"text":"متن جدید"}'

curl -X POST "https://api.uniom.ir/bot<API_KEY>/deleteMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id":"@username","message_id":123}'

نکته پلتفرمی

قالب API واحد است، ولی قابلیت‌هایی مثل HTML کامل، ویرایش رسانه، یا عملیات مدیریتی گروه ممکن است در همه پلتفرم‌ها یکسان نباشد. خطای برگشتی را در کد خود مدیریت کنید و برای مسیرهای حساس، ابتدا با همان پلتفرم هدف تست بگیرید.