مستندات ربات تلگرام

ارسال پیام/عکس/فایل و getMe با Bot Token (BotFather یا Mcp:Telegram:BotToken).

معرفی

ارسال پیام/عکس/فایل و getMe با Bot Token (BotFather یا Mcp:Telegram:BotToken).

احراز هویت

صدور API Key از پنل کاربری در نسخه‌های بعدی فعال می‌شود. تست عمومی از صفحه جزئیات بدون کلید و با محدودیت نرخ انجام می‌شود.

Endpoint تست

POST /Mcp/ExecuteTool
Content-Type: application/json

{ "slug": "telegram-bot", "tool": "TOOL_NAME", "arguments": { } }

Tools

get_me

اطلاعات ربات

Parameters (Input Schema)

{"type":"object","properties":{"botToken":{"type":"string","description":"توکن"}},"required":[]}

Response (Output Schema)

{"type":"object"}

send_message

chatId+text

Parameters (Input Schema)

{"type":"object","properties":{"chatId":{"type":"string","description":"چت"},"text":{"type":"string","description":"متن"},"botToken":{"type":"string","description":"توکن"},"parseMode":{"type":"string","description":"HTML/Markdown"}},"required":["chatId","text"]}

Response (Output Schema)

{"type":"object"}

send_photo

URL عکس

Parameters (Input Schema)

{"type":"object","properties":{"chatId":{"type":"string","description":"چت"},"photo":{"type":"string","description":"URL"},"caption":{"type":"string","description":"عنوان"},"botToken":{"type":"string","description":"توکن"}},"required":["chatId","photo"]}

Response (Output Schema)

{"type":"object"}

send_document

URL سند

Parameters (Input Schema)

{"type":"object","properties":{"chatId":{"type":"string","description":"چت"},"document":{"type":"string","description":"URL"},"caption":{"type":"string","description":"عنوان"}},"required":["chatId","document"]}

Response (Output Schema)

{"type":"object"}

Error Codes

INVALID_ARGUMENT
NOT_FOUND
FORBIDDEN
SERVICE_UNAVAILABLE
TIMEOUT
INTERNAL_ERROR

Pricing / Rate Limits

رایگان — محدودیت دقیق از تنظیمات پلتفرم اعمال می‌شود.