# Telegram Integration via LowCodeAPI

**Last Updated**: February 10, 2026

## Overview
Telegram

**Categories:**
- {'id': 'social-chat', 'name': 'Social Chat'}

## Base Endpoint
https://api.lowcodeapi.com/telegram

**Important**: Always include the provider name in the URL path after `api.lowcodeapi.com/`

## Authentication
**Type:** TOKEN

**Official Documentation:** https://core.telegram.org/api

## URL Format (Important)

LowCodeAPI supports two URL formats. **Always try the New Format first**, then fall back to Old Format if needed.

### New Format (Priority)
- Path parameters stay in the URL path
- Do NOT include path parameters as query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/{id}?api_token=XXX`

### Old Format (Fallback)
- Path parameters become query parameters
- Example: `https://api.lowcodeapi.com/{provider}/resource/id?id={id}&api_token=XXX`

### Decision Flow for AI Agents
1. Always use **New Format** first - keep path parameters in the URL path
2. If you get a 404 or error, try **Old Format** with sanitized path
3. Log which format worked for future requests to this provider

## API Categories

## Common Endpoints

### Send message

**Method:** POST
**LowCodeAPI Path:** /bot{token}/sendMessage

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/sendMessage?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/sendmessage?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| text | string |  |
| allow_sending_without_reply | boolean |  |
| business_connection_id | string |  |
| chat_id | string |  |
| disable_notification | boolean |  |
| disable_web_page_preview | string |  |
| entities | array |  |
| message_effect_id | string |  |
| message_thread_id | string |  |
| parse_mode | string |  |
| protect_content | boolean |  |
| reply_markup | string |  |
| reply_parameters | string |  |
| reply_to_message_id | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/sendMessage?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#sendmessage

### Get incoming updates

**Method:** GET
**LowCodeAPI Path:** /bot{token}/getUpdates

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/getUpdates?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/getupdates?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| allowed_updates | string |  |
| limit | string |  |
| offset | string |  |
| timeout | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/telegram/bot{token}/getUpdates?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#getupdates

### Forward message

**Method:** POST
**LowCodeAPI Path:** /bot{token}/forwardMessage

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/forwardMessage?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bottoken/forwardmessage?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| chat_id | string |  |
| disable_notification | boolean |  |
| from_chat_id | string |  |
| message_id | string |  |
| message_thread_id | string |  |
| protect_content | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/forwardMessage?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#forwardmessage

### Set or update webhook

**Method:** POST
**LowCodeAPI Path:** /bot{token}/setWebhook

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/setWebhook?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/setwebhook?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| allowed_updates | string |  |
| certificate | string |  |
| drop_pending_updates | string |  |
| ip_address | string |  |
| max_connections | string |  |
| secret_token | string |  |
| url | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/setWebhook?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#setwebhook

### Remove webhook

**Method:** POST
**LowCodeAPI Path:** /bot{token}/deleteWebhook

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/deleteWebhook?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/deletewebhook?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| drop_pending_updates | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/deleteWebhook?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#deletewebhook

### Copy message

**Method:** POST
**LowCodeAPI Path:** /bot{token}/copyMessage

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/copyMessage?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/copymessage?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| allow_sending_without_reply | string |  |
| caption | string |  |
| caption_entities | string |  |
| chat_id | string |  |
| disable_notification | string |  |
| from_chat_id | string |  |
| message_id | string |  |
| message_thread_id | string |  |
| parse_mode | string |  |
| protect_content | string |  |
| reply_markup | string |  |
| reply_to_message_id | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/copyMessage?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#copymessage

### Get current webhook status

**Method:** GET
**LowCodeAPI Path:** /bot{token}/getWebhookInfo

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/getWebhookInfo?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/getwebhookinfo?api_token=YOUR_API_TOKEN

**Query Parameters:**

| Parameter | Type | Description |
|-----------|------|-------------|
| allowed_updates | array |  |
| has_custom_certificate | boolean |  |
| ip_address | string |  |
| last_error_date | number |  |
| last_error_message | string |  |
| last_synchronization_error_date | number |  |
| max_connections | number |  |
| pending_update_count | number |  |
| url | string |  |

**Example Request (New Format):**

```bash
curl -X GET 'https://api.lowcodeapi.com/telegram/bot{token}/getWebhookInfo?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#getwebhookinfo

### Send photo

**Method:** POST
**LowCodeAPI Path:** /bot{token}/sendPhoto

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/sendPhoto?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/sendphoto?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| allow_sending_without_reply | boolean |  |
| caption | string |  |
| caption_entities | string |  |
| chat_id | string |  |
| disable_notification | string |  |
| has_spoiler | boolean |  |
| message_thread_id | string |  |
| parse_mode | string |  |
| photo | string |  |
| protect_content | string |  |
| reply_markup | string |  |
| reply_to_message_id | string |  |
| show_caption_above_media | boolean |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/sendPhoto?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#sendphoto

### Send video

**Method:** POST
**LowCodeAPI Path:** /bot{token}/sendVideo

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/sendVideo?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/sendvideo?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| allow_sending_without_reply | string |  |
| caption | string |  |
| caption_entities | string |  |
| chat_id | string |  |
| disable_notification | string |  |
| duration | string |  |
| height | string |  |
| message_thread_id | string |  |
| parse_mode | string |  |
| protect_content | string |  |
| reply_markup | string |  |
| reply_to_message_id | string |  |
| supports_streaming | string |  |
| thumb | string |  |
| video | string |  |
| width | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/sendVideo?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#sendvideo

### Send video note

**Method:** POST
**LowCodeAPI Path:** /bot{token}/sendVideoNote

**New Format URL:**
https://api.lowcodeapi.com/telegram/bot{token}/sendVideoNote?api_token=YOUR_API_TOKEN

**Old Format URL:**
https://api.lowcodeapi.com/telegram/bot-token/sendvideonote?api_token=YOUR_API_TOKEN

**Request Body:**

| Field | Type | Description |
|-------|------|-------------|
| allow_sending_without_reply | string |  |
| chat_id | string |  |
| disable_notification | string |  |
| duration | string |  |
| length | string |  |
| message_thread_id | string |  |
| protect_content | string |  |
| reply_markup | string |  |
| reply_to_message_id | string |  |
| thumb | string |  |
| video_note | string |  |

**Example Request (New Format):**

```bash
curl -X POST 'https://api.lowcodeapi.com/telegram/bot{token}/sendVideoNote?api_token=YOUR_API_TOKEN'
```

**Official Documentation:** https://core.telegram.org/bots/api#sendvideonote


## Usage Examples

### Example 1: Get User Profile

```bash
# Get current user information
curl -X GET "https://api.lowcodeapi.com/telegram/user?api_token=YOUR_API_TOKEN"
```

### Example 2: List Messages or Posts

```bash
# Get list of messages/posts
curl -X GET "https://api.lowcodeapi.com/telegram/messages?api_token=YOUR_API_TOKEN"
```

### Example 3: Send Message or Create Post

```bash
# Send a message
curl -X POST "https://api.lowcodeapi.com/telegram/chat.postMessage?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "CHANNEL_ID",
    "text": "Hello from Telegram!"
  }'
```

## Error Handling

LowCodeAPI returns standard HTTP status codes. Common errors:

| Status Code | Description |
|-------------|-------------|
| 200 | Success - Request completed successfully |
| 400 | Bad Request - Invalid parameters or request body |
| 401 | Unauthorized - Invalid or missing API token |
| 403 | Forbidden - Insufficient permissions |
| 404 | Not Found - Endpoint or resource doesn't exist |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error - Provider API error |

All error responses include error details:

```json
{
  "data": {
    "error": {
      "message": "Error description",
      "code": "ERROR_CODE"
    }
  }
}
```

## Complete Endpoint Reference

| Endpoint | Method | Category |
|----------|--------|----------|
| Send message | POST | Message |
| Get incoming updates | GET | Activity |
| Forward message | POST | Message |
| Set or update webhook | POST | Webhook |
| Remove webhook | POST | Webhook |
| Copy message | POST | Message |
| Get current webhook status | GET | Webhook |
| Send photo | POST | Message |
| Send video | POST | Message |
| Send video note | POST | Message |
| Send general files | POST | Message |
| Send animated file | POST | Message |
| Send voice message | POST | Message |
| Send a random animated emoji | POST | Message |
| Send phone contact | POST | Message |
| Send location | POST | Message |
| Send venue | POST | Message |
| Send poll | POST | Message |
| Send chat action | POST | Message |
| Delete messages, including service messages | POST | Message |
| Edit message text | POST | Message |
| Edit message caption | POST | Message |
| Edit message media | POST | Message |
| Edit message reply markup | POST | Message |
| Stop poll | POST | Message |
| Answer inline query | POST | Inline Mode |
| Answer callback query | POST | Inline Mode |
| Send multiple media files as an album. | POST | Message |
| Get file info | GET | Message |
| Get a sticker set | GET | Stickers |
| Send static WEBP, animated TGS, or video WEBM stic... | POST | Stickers |
| Send audio file | POST | Message |
| Get custom emoji sticker info by their identifiers | GET | Stickers |
| Upload sticker PNG for future use in sticker sets | POST | Stickers |
| Make a user's new sticker set | POST | Stickers |
| Bot creates set. Add new sticker | POST | Stickers |
| Bot moves sticker to specific position in set | POST | Stickers |
| Remove bot-created set sticker | POST | Stickers |
| Set sticker set thumbnail: animated for animations | POST | Stickers |
| Get bot details | GET | User |
| Logout from Cloud Bot API before running locally | POST | User |
| Close bot instance | POST | User |
| Get user profile pictures | GET | User |
| Get chat | GET | Chat |
| Get chat administrators | GET | Chat |
| Get chat member count | GET | Chat |
| Get chat member | GET | Chat |
| Set chat sticker set | POST | Chat |
| Delete chat sticker set | POST | Chat |
| Restrict chat member | POST | Chat |
| Promote chat member | POST | Chat |
| Set chat administrator custom title | POST | Chat |
| Ban chat member | POST | Chat |
| Unban chat member | POST | Chat |
| Set chat permissions | POST | Chat |
| Set chat title | POST | Chat |
| Set chat description | POST | Chat |
| Pin chat message | POST | Chat |
| Unpin chat message | POST | Chat |
| Unpin all chat messages | POST | Chat |
| Leave chat | POST | Chat |
| Send invoice | POST | Payments |
| Answer shipping query | POST | Payments |
| Answer pre-checkout query | POST | Payments |
| Send game | POST | Games |
| Set game score | POST | Games |
| Get game high scores | GET | Games |
| Set passport data errors | POST | Telegram Passport |

## API Definition Endpoints

You can fetch the complete API specification for this provider:

**New Format (OpenAPI spec):**
```bash
curl 'https://backend.lowcodeapi.com/telegram/openapi'
```

**Old Format (API definition):**
```bash
curl 'https://backend.lowcodeapi.com/telegram/definition'
```

## Response Format

All responses are wrapped in a `data` key:

```json
{
  "data": {
    // Actual response from provider (object or array)
  }
}
```