OpenIntegrations/docs/en/md/Telegram/Data-retrieval-and-settings/Get-updates.md

---
sidebar_position: 2
---

# Get updates
 Executes a request /getUpdates, returning information about bot events. Used in polling mode



`Function GetUpdates(Val Token, Val Timeout = 0, Val Offset = "") Export`

  | Parameter | CLI option | Type | Description |
  |-|-|-|-|
  | Token | --token | String | Bot token |
  | Timeout | --timeout | String, Number | Waiting time for new events |
  | Offset | --offset | String, Number | Offset in the list of received messages |

  
  Returns:  Map Of KeyAndValue - Serialized JSON response from Telegram

<br/>




```bsl title="Code example"
    Token  = "6129457865:AAFyzNYOAFbu...";
    Result = OPI_Telegram.GetUpdates(Token);
```



```sh title="CLI command example"
    
  oint telegram GetUpdates --token "6129457865:AAFyzNYOAFbu..." --timeout %timeout% --offset %offset%

```

```json title="Result"
{
  "ok": true,
  "result": [
  {
  "update_id": 291366000,
  "channel_post": {
  "message_id": 4685,
  "sender_chat": {
  "id": -1001893407333,
  "title": "Test channel",
  "username": "testsichee",
  "type": "channel"
  },
  "chat": {
  "id": -1001893407333,
  "title": "Test channel",
  "username": "testsichee",
  "type": "channel"
  },
  "date": 1717054881,
  "pinned_message": {
  "message_id": 4670,
  "sender_chat": {
  "id": -1001893407333,
  "title": "Test channel",
  "username": "testsichee",
  "type": "channel"
  },
  "chat": {
  "id": -1001893407333,
  "title": "Test channel",
  "username": "testsichee",
  "type": "channel"
  },
  "date": 1717054721,
  "text": "String value"
  }
  }
  },
  {
  "update_id": 291366001,
  "message": {
  "message_id": 2446,
  "from": {
  "id": 6129457865,
  "is_bot": true,
  "first_name": "Vitaly The Bot",
  "username": "sicheebot"
  },
  "chat": {
  "id": -1001971186208,
  "title": "Test",
  "is_forum": true,
  "type": "supergroup"
  },
  "date": 1717054906,
  "message_thread_id": 2446,
  "forum_topic_created": {
  "name": "TestTopic fb0492fb-3a2d-4496-8309-b119226ef9f9",
  "icon_color": 7322096,
  "icon_custom_emoji_id": "5357419403325481346"
  },
  "is_topic_message": true
  }
  },
  {
  "update_id": 291366002,
  "message": {
  "message_id": 2448,
  "from": {
  "id": 6129457865,
  "is_bot": true,
  "first_name": "Vitaly The Bot",
  "username": "sicheebot"
  },
  "chat": {
  "id": -1001971186208,
  "title": "Test",
  "is_forum": true,
  "type": "supergroup"
  },
  "date": 1717054907,
  "message_thread_id": 2446,
  "reply_to_message": {
  "message_id": 2446,
  "from": {
  "id": 6129457865,
  "is_bot": true,
  "first_name": "Vitaly The Bot",
  "username": "sicheebot"
  },
  "chat": {
  "id": -1001971186208,
  "title": "Test",
  "is_forum": true,
  "type": "supergroup"
  },
  "date": 1717054906,
  "message_thread_id": 2446,
  "forum_topic_created": {
  "name": "TestTopic fb0492fb-3a2d-4496-8309-b119226ef9f9",
  "icon_color": 7322096,
  "icon_custom_emoji_id": "5357419403325481346"
  },
  "is_topic_message": true
  },
  "forum_topic_edited": {
  "name": "NewTestTitle",
  "icon_custom_emoji_id": "5310132165583840589"
  },
  "is_topic_message": true
  }
  },
  {
  "update_id": 291366003,
  "message": {
  "message_id": 2449,
  "from": {
  "id": 6129457865,
  "is_bot": true,
  "first_name": "Vitaly The Bot",
  "username": "sicheebot"
  },
  "chat": {
  "id": -1001971186208,
  "title": "Test",
  "is_forum": true,
  "type": "supergroup"
  },
  "date": 1717054912,
  "forum_topic_reopened": {}
  }
  },
  {
  "update_id": 291366004,
  "message": {
  "message_id": 2450,
  "from": {
  "id": 6129457865,
  "is_bot": true,
  "first_name": "Vitaly The Bot",
  "username": "sicheebot"
  },
  "chat": {
  "id": -1001971186208,
  "title": "Test",
  "is_forum": true,
  "type": "supergroup"
  },
  "date": 1717054912,
...
```