← All toolsCommunicationtelegramAll editions

TELEGRAM_READ

Read recent messages received by the bot. Returns the latest updates.

Parameters

NameTypeRequiredDescription
countinteger—Number of recent updates to return (default 10, max 100)
offsetinteger—Update offset for pagination

How to use it

You normally trigger this by describing what you want in chat — the agent selects TELEGRAM_READ automatically. For example:

Try saying
“telegram my telegram”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "telegram",
  "action": "TELEGRAM_READ",
  "args": {
    "count": 5,
    "offset": 1
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"TELEGRAM_READ","args":{"count":5,"offset":1}}'

Part of the telegram plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.