Get updates
Tool ID: telegram_get_updates
Summary
Reads new inbound messages (and button presses) from the hub’s store — what Telegram delivered to your bot. It does not mark them handled; call Ack updates when you are done.
When to use it
- Check what people wrote to the bot.
- See who pressed an inline button.
- Pull a batch before summarizing or replying.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Telegram credential (webhook registered) | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
chat_id |
No | Only updates from this chat |
since |
No | ISO time or a previous update_id |
limit |
No | 1–100, default 20 |
include_media_meta |
No | Include file size / mime when present |
include_consumed |
No | Also return already-acked updates |
What you get back
A list of updates with update_id, chat_id, sender, kind (text, photo, callback_query, …), text/caption, and optional file_id.
Example prompts
What did people send my Telegram bot in the last hour?
List new Telegram messages and summarize them for me. Don’t mark them handled yet.
Tips
- Always ack after you handle a batch so a failed run does not lose messages.
- In groups, disable privacy mode in BotFather if you need all messages, not only commands.