bldinit Telegram Rest API
The telegram-rest API from bldinit — 8 operation(s) for telegram-rest.
The telegram-rest API from bldinit — 8 operation(s) for telegram-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-telegram-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Telegram Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: telegram-rest
paths:
/api/v1/telegram/sendMessage:
post:
tags:
- telegram-rest
summary: 메시지 발송 (★ irreversible)
description: '``chat_id`` 으로 메시지 발송. parse_mode (Markdown / HTML) 지원.
``reply_markup`` 으로 inline keyboard / reply keyboard 부착 가능.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**: 수신자 단말 알림 도달,
mcpweave 측 회수 불가. ``telegram_delete_message`` 로 메시지 자체 삭제
가능하지만 알림은 회수 불가.
Native pass-through.'
operationId: telegram_send_message
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/sendPhoto:
post:
tags:
- telegram-rest
summary: 사진 발송 (★ irreversible)
description: '``chat_id`` 으로 사진 발송. ``photo`` = URL (Telegram 이 fetch) 또는
Telegram file_id (이미 업로드된 파일 재사용). multipart upload 는
Phase 2 trigger.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**: 수신자 단말 도달.
Native pass-through.'
operationId: telegram_send_photo
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/sendDocument:
post:
tags:
- telegram-rest
summary: 파일 발송 (★ irreversible)
description: '``chat_id`` 으로 일반 파일 (PDF / zip / docx 등) 발송. ``document`` =
URL 또는 file_id. 50MB max (URL) / 20MB max (file_id reuse).
**URL 발송 시 Telegram 은 binary mime 만 accept** — text/plain (.txt 등)
/ HTML 은 "web page" 로 해석해 거절 (``Bad Request: wrong type of the
web page content``). PDF / zip / docx / image 등은 OK.
**Irreversible (ADR-028/030 Cat A — 외부 도달)**.
Native pass-through.'
operationId: telegram_send_document
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/editMessageText:
post:
tags:
- telegram-rest
summary: 메시지 텍스트 수정
description: 'bot 이 발송한 메시지의 텍스트 수정. ``chat_id`` + ``message_id`` 또는
inline mode 의 ``inline_message_id``.
Recoverable — 다시 edit 으로 이전 텍스트 복원 가능. irreversible 아님.
Native pass-through.'
operationId: telegram_edit_message
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/deleteMessage:
post:
tags:
- telegram-rest
summary: 메시지 삭제 (★ irreversible)
description: 'bot 이 발송한 메시지 (또는 group/supergroup 에서 admin 권한 가진 채널의
다른 메시지) 삭제. **48시간 이내** 만 삭제 가능 (Telegram 측 제약).
**Irreversible (ADR-028/030 Cat B — 영구 삭제)**: API 삭제 후 복구 불가.
Native pass-through.'
operationId: telegram_delete_message
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: confirmation_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'ADR-030: required for irreversible op. First call returns token.'
title: Confirmation Token
description: 'ADR-030: required for irreversible op. First call returns token.'
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/getMe:
get:
tags:
- telegram-rest
summary: Bot 정보
description: 현재 bot 의 metadata (id / username / first_name / can_join_groups 등). Native pass-through.
operationId: telegram_get_me
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/getUpdates:
get:
tags:
- telegram-rest
summary: 새 메시지 polling (webhook 미설정 시)
description: 'Long polling 방식으로 새 메시지 / event 받기. ``offset`` (마지막 받은
update_id + 1) / ``timeout`` (long poll 초) / ``limit``.
**주의**: ``setWebhook`` 활성 시 사용 불가 (HTTP 409 conflict).
Phase 1 default = polling. Phase 2 SNS-Webhook sprint 시 setWebhook
흐름 추가.
Native pass-through.'
operationId: telegram_get_updates
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: offset
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Offset
- name: limit
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Limit
- name: timeout
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Timeout
- name: allowed_updates
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Allowed Updates
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/telegram/answerCallbackQuery:
post:
tags:
- telegram-rest
summary: Inline button 응답
description: 'Inline keyboard button 클릭 시 발생한 ``callback_query`` 에 응답. 사용자에게
toast / alert 표시 또는 답장. 응답 안 하면 Telegram client 가 spinner
표시.
Recoverable — 응답 자체는 일시적 UI 알림 (메시지 X). irreversible 아님.
Native pass-through.'
operationId: telegram_answer_callback_query
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
content:
application/json:
schema:
anyOf:
- type: object
additionalProperties: true
- type: 'null'
title: Body
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)