Telegram Bot API
🌐 한국어

setWebhook

카테고리: 업데이트 · Bot API 10.3 · 공식 문서

웹훅을 설정합니다.

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

매개변수

매개변수타입필수설명
urlString예웹훅 URL (빈 문자열 = 삭제)
certificateInputFile선택공개 키 인증서 (자체 서명 인증서용)
ip_addressString선택웹훅용 IP 주소
max_connectionsInteger선택최대 연결 수 (1-100, 기본값 40)
allowed_updatesArray of String선택업데이트 유형 JSON 배열
drop_pending_updatesBoolean선택대기 중인 업데이트 삭제
secret_tokenString선택X-Telegram-Bot-Api-Secret-Token 헤더용 비밀 토큰

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

요청 예제

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/telegram/webhook"}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/setWebhook",
    json={
        "url": "https://example.com/telegram/webhook"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setWebhook`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "url": "https://example.com/telegram/webhook"
  }),
});
console.log(await res.json());

단계별 가이드: 텔레그램 웹훅 설정 가이드: setWebhook, secret_token, getWebhookInfo