Telegram Bot API

sendWidget

카테고리: 위젯 · Bot API 10.5 · 공식 문서

버전 기록: Bot API 10.4에서 추가됨

HTML 위젯이 포함된 메시지를 전송합니다 (Bot API 10.4).

반환값: 성공 시 반환값: Message.

매개변수

매개변수타입필수설명
chat_idInteger or String예채팅 ID 또는 @username
message_thread_idInteger선택포럼 토픽 ID
htmlString예위젯 HTML 코드: 1-32768바이트, zlib 압축 후 최대 4096바이트
widthInteger선택논리 픽셀 단위의 위젯 너비 (생략 시 메시지 전체 너비)
heightInteger선택논리 픽셀 단위의 위젯 높이, 50-600 (생략 시 콘텐츠에 맞춤)
public_dataString선택위젯의 공개 상태 (public_data), 0-1024바이트 — 위젯이 표시되는 모든 곳에서 보임
chat_dataString선택이 채팅에서의 위젯 상태 (chat_data), 0-1024바이트
captionString선택캡션 (0-1024)
parse_modeString선택HTML, Markdown, MarkdownV2
caption_entitiesArray of MessageEntity선택캡션용 MessageEntity JSON 배열
show_caption_above_mediaBoolean선택위젯 위에 캡션 표시
allow_queriesBoolean선택위젯의 봇 쿼리 전송 허용 (widget_query)
is_sharedBoolean선택공유 위젯 생성 — sendSharedWidget으로 다시 전송 가능
disable_notificationBoolean선택알림 없이 전송
protect_contentBoolean선택콘텐츠 보호
allow_paid_broadcastBoolean선택유료 브로드캐스트 허용
message_effect_idString선택메시지 효과 ID
reply_parametersReplyParameters선택ReplyParameters JSON 객체
reply_markupInlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply선택JSON 객체: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply

매개변수 설명은 핵심만 간추린 요약입니다. 전체 설명은 공식 문서에서 확인할 수 있습니다.

요청 예제

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendWidget" \
  -H "Content-Type: application/json" \
  -d '{
  "chat_id": 123456789,
  "html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/sendWidget",
    json={
        "chat_id": 123456789,
        "html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendWidget`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "chat_id": 123456789,
    "html": "<h3>Order #1042</h3><p>2 × Margherita</p><button>Track the order</button>"
  }),
});
console.log(await res.json());

단계별 가이드: 텔레그램 위젯 가이드: 봇 메시지 안에서 동작하는 HTML 위젯