admin/openclaw-workspace

Fork 0

Files

OpenClaw Agent 5deb387aa6 Fresh start - excluded large ROM JSON files

2026-04-11 09:45:12 -05:00

3.3 KiB

Raw Blame History

Telegram Routing Reference

App name: telegram Base URL proxied: api.telegram.org

API Path Pattern

/telegram/:token/{method}

The :token placeholder is automatically replaced with the bot token from the connection configuration.

Common Endpoints

Get Bot Info

GET /telegram/:token/getMe

Get Updates

POST /telegram/:token/getUpdates
Content-Type: application/json

{
  "limit": 100,
  "timeout": 30
}

Send Message

POST /telegram/:token/sendMessage
Content-Type: application/json

{
  "chat_id": 123456789,
  "text": "Hello!",
  "parse_mode": "HTML"
}

Send Photo

POST /telegram/:token/sendPhoto
Content-Type: application/json

{
  "chat_id": 123456789,
  "photo": "https://example.com/image.jpg",
  "caption": "Photo caption"
}

Send Document

POST /telegram/:token/sendDocument
Content-Type: application/json

{
  "chat_id": 123456789,
  "document": "https://example.com/file.pdf"
}

Send Location

POST /telegram/:token/sendLocation
Content-Type: application/json

{
  "chat_id": 123456789,
  "latitude": 37.7749,
  "longitude": -122.4194
}

Send Poll

POST /telegram/:token/sendPoll
Content-Type: application/json

{
  "chat_id": 123456789,
  "question": "What is your favorite?",
  "options": [{"text": "Option 1"}, {"text": "Option 2"}]
}

Edit Message

POST /telegram/:token/editMessageText
Content-Type: application/json

{
  "chat_id": 123456789,
  "message_id": 123,
  "text": "Updated text"
}

Delete Message

POST /telegram/:token/deleteMessage
Content-Type: application/json

{
  "chat_id": 123456789,
  "message_id": 123
}

Forward Message

POST /telegram/:token/forwardMessage
Content-Type: application/json

{
  "chat_id": 123456789,
  "from_chat_id": 123456789,
  "message_id": 123
}

Get Chat

POST /telegram/:token/getChat
Content-Type: application/json

{
  "chat_id": 123456789
}

Set Bot Commands

POST /telegram/:token/setMyCommands
Content-Type: application/json

{
  "commands": [
    {"command": "start", "description": "Start the bot"},
    {"command": "help", "description": "Get help"}
  ]
}

Get File

POST /telegram/:token/getFile
Content-Type: application/json

{
  "file_id": "AgACAgQAAxkDAAM..."
}

Set Webhook

POST /telegram/:token/setWebhook
Content-Type: application/json

{
  "url": "https://example.com/webhook",
  "allowed_updates": ["message", "callback_query"]
}

Answer Callback Query

POST /telegram/:token/answerCallbackQuery
Content-Type: application/json

{
  "callback_query_id": "12345678901234567",
  "text": "Button clicked!"
}

Notes

The :token placeholder is automatically replaced with the bot token
Chat IDs are positive integers for private chats, negative for groups
All methods support both GET and POST, but POST is recommended
Text messages have a 4096 character limit
Captions have a 1024 character limit
Polls support 2-10 options
Files can be sent via URL or file_id from previously uploaded files

3.3 KiB Raw Blame History