sendSharedWidget
봇이 생성한 공유 위젯을 다시 전송합니다 (Bot API 10.4).
반환값: 성공 시 반환값: Message.
매개변수
| 매개변수 | 타입 | 필수 | 설명 |
|---|---|---|---|
chat_id | Integer or String | 예 | 채팅 ID 또는 @username |
message_thread_id | Integer | 선택 | 포럼 토픽 ID |
widget_id | String | 예 | 공유 위젯 ID (전송된 메시지의 widget.id) |
chat_data | String | 선택 | 이 채팅에서의 위젯 상태 (chat_data), 0-1024바이트 |
caption | String | 선택 | 캡션 (0-1024) |
parse_mode | String | 선택 | HTML, Markdown, MarkdownV2 |
caption_entities | Array of MessageEntity | 선택 | 캡션용 MessageEntity JSON 배열 |
show_caption_above_media | Boolean | 선택 | 위젯 위에 캡션 표시 |
disable_notification | Boolean | 선택 | 알림 없이 전송 |
protect_content | Boolean | 선택 | 콘텐츠 보호 |
allow_paid_broadcast | Boolean | 선택 | 유료 브로드캐스트 허용 |
message_effect_id | String | 선택 | 메시지 효과 ID |
reply_parameters | ReplyParameters | 선택 | ReplyParameters JSON 객체 |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | 선택 | JSON 객체: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
요청 예제
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendSharedWidget" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"widget_id":"WIDGET_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendSharedWidget",
json={
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendSharedWidget`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"widget_id": "WIDGET_ID"
}),
});
console.log(await res.json());
단계별 가이드: 텔레그램 위젯 예제: HTML과 Python 봇 코드 전체 공개
관련 메서드
sendWidgetHTML 위젯이 포함된 메시지를 전송합니다 (Bot API 10.4).answerWidgetQuery위젯의 쿼리에 응답합니다 (Bot API 10.4).editMessageWidgetData메시지 속 위젯의 데이터를 수정합니다 (Bot API 10.4).editSharedWidgetData공유 위젯의 공개 데이터를 수정합니다 (Bot API 10.4).