Telegram Bot API 메서드 한국어 레퍼런스
Telegram Bot API 10.3의 모든 메서드를 카테고리별로 한 페이지에 모았습니다. 각 메서드 페이지에는 공식 타입이 표기된 매개변수 목록, 반환값, 바로 실행할 수 있는 curl, Python, JavaScript 예제가 있으며, 클릭 한 번으로 온라인 테스터에서 열 수 있습니다.
봇 정보 24
getMe봇 정보를 반환합니다.getMyCommands현재 봇 명령어 목록을 반환합니다.setMyCommands봇 명령어 목록을 설정합니다.deleteMyCommands봇 명령어를 삭제합니다.getMyName봇 이름을 반환합니다.setMyName봇 이름을 설정합니다.getMyDescription봇 설명을 반환합니다.setMyDescription봇 설명을 설정합니다.getMyShortDescription봇의 짧은 설명을 반환합니다.setMyShortDescription봇의 짧은 설명을 설정합니다.setMyProfilePhoto봇 프로필 사진을 설정합니다.removeMyProfilePhoto봇 프로필 사진을 삭제합니다.getUserProfilePhotos사용자 프로필 사진을 반환합니다.getUserProfileAudios사용자 프로필 오디오를 반환합니다 (Bot API 9.4).getChatMenuButton봇의 메뉴 버튼을 반환합니다.setChatMenuButton봇의 메뉴 버튼을 설정합니다.getManagedBotAccessSettings관리 대상 봇의 접근 설정을 가져옵니다 (Bot API 10.0).setManagedBotAccessSettings관리 대상 봇의 접근 설정을 변경합니다 (Bot API 10.0).getManagedBotToken관리 대상 봇의 토큰을 가져옵니다 (Bot API 9.6).replaceManagedBotToken관리 대상 봇의 토큰을 교체합니다 (Bot API 9.6).logOut클라우드 Bot API 서버에서 로그아웃합니다.close다른 서버로 옮기기 전에 봇을 종료합니다.getMyDefaultAdministratorRights기본 관리자 권한을 반환합니다.setMyDefaultAdministratorRights기본 관리자 권한을 설정합니다.
업데이트 4
getWebhookInfo웹훅 정보를 반환합니다.setWebhook웹훅을 설정합니다.deleteWebhook웹훅을 삭제합니다.getUpdates업데이트를 가져옵니다. Long Polling에는 '시작' 버튼을 사용하십시오.
메시지 16
sendMessage텍스트 메시지를 전송합니다.forwardMessage메시지를 전달합니다.forwardMessages여러 메시지를 전달합니다.copyMessage원본 링크 없이 메시지를 복사합니다.copyMessages여러 메시지를 복사합니다.deleteMessage메시지를 삭제합니다.deleteMessages여러 메시지를 삭제합니다.sendChatAction채팅 액션(typing 등)을 전송합니다.sendMessageDraft메시지 초안(임시 미리보기)을 전송합니다 (Bot API 9.5+).sendContact연락처를 전송합니다.sendLocation위치를 전송합니다.sendVenue장소를 전송합니다.setMessageReaction메시지에 반응을 설정합니다.sendChecklist비즈니스 계정을 대신하여 체크리스트를 전송합니다.approveSuggestedPost다이렉트 메시지의 제안 게시물을 승인합니다.declineSuggestedPost다이렉트 메시지의 제안 게시물을 거절합니다.
리치 메시지 2
sendRichMessage구조화된 서식의 리치 메시지를 전송합니다 (Bot API 10.1).sendRichMessageDraft리치 메시지의 일부를 스트리밍합니다 — 30초 미리보기 (Bot API 10.1).
임시 메시지 5
editEphemeralMessageText임시 메시지의 텍스트를 수정합니다 (Bot API 10.2).editEphemeralMessageMedia임시 메시지의 미디어를 수정합니다 (Bot API 10.2).editEphemeralMessageCaption임시 메시지의 캡션을 수정합니다 (Bot API 10.2).editEphemeralMessageReplyMarkup임시 메시지의 인라인 키보드를 수정합니다 (Bot API 10.2).deleteEphemeralMessage임시 메시지를 삭제합니다 (Bot API 10.2).
수정 7
editMessageText메시지 텍스트를 수정합니다.editMessageCaption미디어 캡션을 수정합니다.editMessageMedia메시지의 미디어를 수정합니다.editMessageReplyMarkup메시지의 인라인 키보드를 수정합니다.editMessageLiveLocation실시간 위치를 수정합니다.stopMessageLiveLocation실시간 위치 공유를 중지합니다.editMessageChecklist체크리스트를 수정합니다.
미디어 12
sendPhoto사진을 전송합니다.sendVideo동영상을 전송합니다.sendDocument문서를 전송합니다.sendAudio오디오를 전송합니다.sendAnimation애니메이션(GIF)을 전송합니다.sendSticker스티커를 전송합니다.sendVoice음성 메시지를 전송합니다.sendVideoNote원형 동영상(video note)을 전송합니다.sendMediaGroup미디어 그룹(앨범)을 전송합니다.sendPaidMedia유료 미디어를 전송합니다 (Bot API 8.0+).sendDice주사위를 전송합니다.sendLivePhoto라이브 포토를 전송합니다 (사진 + 동영상, Bot API 10.0).
결제 16
sendInvoice결제용 인보이스를 전송합니다.createInvoiceLink결제 링크를 생성합니다.refundStarPaymentTelegram Stars 결제를 환불합니다.sendGift사용자 또는 채팅에 선물을 전송합니다.getMyStarBalance봇의 Telegram Stars 잔액을 반환합니다.getStarTransactions봇의 Telegram Stars 거래 내역을 반환합니다.editUserStarSubscriptionTelegram Stars 구독을 취소하거나 갱신합니다.giftPremiumSubscriptionTelegram Premium 구독을 선물합니다.answerShippingQuery배송 쿼리에 응답합니다.answerPreCheckoutQuery결제 전 확인 쿼리에 응답합니다.getAvailableGifts봇이 보낼 수 있는 선물 목록을 반환합니다.getUserGifts사용자의 선물을 반환합니다.getChatGifts채팅의 선물을 반환합니다.convertGiftToStars일반 선물을 Telegram Stars로 전환합니다.upgradeGift일반 선물을 고유 선물로 업그레이드합니다.transferGift고유 선물을 다른 사용자에게 양도합니다.
콜백 6
answerCallbackQuery콜백 쿼리에 응답합니다.answerInlineQuery인라인 쿼리에 응답합니다.answerGuestQuery게스트 모드에서 게스트 쿼리에 응답합니다 (Bot API 10.0).answerWebAppQueryWeb App 상호작용 결과를 전송합니다.answerChatJoinRequestQuery채팅 가입 요청 쿼리에 응답합니다 (Bot API 10.1).sendChatJoinRequestWebApp채팅 가입 요청 쿼리에 대해 Mini App을 표시합니다 (Bot API 10.1).
채팅 23
getChat채팅 정보를 가져옵니다.getChatMember채팅 멤버 정보를 가져옵니다.getChatMemberCount채팅 멤버 수를 반환합니다.getChatAdministrators채팅 관리자 목록을 반환합니다.setChatTitle채팅 제목을 설정합니다.setChatDescription채팅 설명을 설정합니다.setChatPhoto채팅 사진을 설정합니다.deleteChatPhoto채팅 사진을 삭제합니다.setChatPermissions채팅 권한을 설정합니다.leaveChat채팅에서 나갑니다.exportChatInviteLink채팅의 기본 초대 링크를 새로 발급합니다.createChatInviteLink초대 링크를 생성합니다.editChatInviteLink초대 링크를 수정합니다.revokeChatInviteLink초대 링크를 취소합니다.approveChatJoinRequest가입 요청을 승인합니다.declineChatJoinRequest가입 요청을 거절합니다.deleteMessageReaction메시지의 반응을 삭제합니다 (Bot API 10.0).deleteAllMessageReactions그룹/슈퍼그룹에서 반응을 최대 10000개까지 삭제합니다 (Bot API 10.0).getUserPersonalChatMessages사용자 개인 채팅의 최근 메시지를 가져옵니다 (Bot API 10.0).setChatStickerSet슈퍼그룹의 스티커 세트를 설정합니다.deleteChatStickerSet슈퍼그룹에서 스티커 세트를 삭제합니다.createChatSubscriptionInviteLink구독 초대 링크를 생성합니다.editChatSubscriptionInviteLink구독 초대 링크를 수정합니다.
관리자 11
banChatMember채팅 멤버를 차단합니다.unbanChatMember채팅 멤버의 차단을 해제합니다.restrictChatMember채팅 멤버를 제한합니다.promoteChatMember채팅 멤버를 관리자로 승격합니다.setChatAdministratorCustomTitle관리자의 사용자 지정 직함을 설정합니다.banChatSenderChat그룹/슈퍼그룹에서 채널을 차단합니다.unbanChatSenderChat그룹/슈퍼그룹에서 채널 차단을 해제합니다.pinChatMessage채팅에 메시지를 고정합니다.unpinChatMessage채팅에서 메시지 고정을 해제합니다.unpinAllChatMessages채팅의 모든 메시지 고정을 해제합니다.setChatMemberTag채팅 멤버 태그를 설정합니다 (Bot API 9.5).
투표 2
포럼 13
createForumTopic포럼 토픽을 생성합니다.editForumTopic포럼 토픽을 수정합니다.closeForumTopic포럼 토픽을 닫습니다.reopenForumTopic포럼 토픽을 다시 엽니다.deleteForumTopic포럼 토픽을 삭제합니다.editGeneralForumTopicGeneral 포럼 토픽을 수정합니다.closeGeneralForumTopicGeneral 포럼 토픽을 닫습니다.reopenGeneralForumTopicGeneral 포럼 토픽을 다시 엽니다.hideGeneralForumTopicGeneral 포럼 토픽을 숨깁니다.unhideGeneralForumTopicGeneral 포럼 토픽 숨김을 해제합니다.getForumTopicIconStickers포럼 토픽 아이콘 스티커를 반환합니다.unpinAllForumTopicMessages포럼 토픽의 모든 메시지 고정을 해제합니다.unpinAllGeneralForumTopicMessagesGeneral 포럼 토픽의 모든 메시지 고정을 해제합니다.
파일 1
getFile다운로드용 파일 정보를 가져옵니다.
스티커 14
getStickerSet스티커 세트를 반환합니다.uploadStickerFile스티커 파일을 업로드합니다.createNewStickerSet새 스티커 세트를 생성합니다.addStickerToSet세트에 스티커를 추가합니다.replaceStickerInSet세트의 스티커를 교체합니다.setStickerPositionInSet세트 안에서 스티커 위치를 이동합니다.deleteStickerFromSet세트에서 스티커를 삭제합니다.setStickerSetTitle스티커 세트 제목을 설정합니다.setStickerSetThumbnail스티커 세트 썸네일을 설정합니다.setCustomEmojiStickerSetThumbnail커스텀 이모지 스티커 세트 썸네일을 설정합니다.deleteStickerSet스티커 세트를 삭제합니다.setStickerEmojiList스티커 이모지 목록을 변경합니다.setStickerKeywords스티커 키워드를 변경합니다.setStickerMaskPosition스티커 마스크 위치를 변경합니다.
게임 3
sendGame게임을 전송합니다.setGameScore사용자의 게임 점수를 설정합니다.getGameHighScores게임 최고 점수를 반환합니다.
스토리 4
postStory비즈니스 계정을 대신하여 스토리를 게시합니다.editStory비즈니스 계정을 대신하여 스토리를 수정합니다.deleteStory비즈니스 계정을 대신하여 스토리를 삭제합니다.repostStory비즈니스 계정 간에 스토리를 리포스트합니다 (Bot API 9.3).
비즈니스 11
getBusinessAccountStarBalance비즈니스 계정의 Stars 잔액을 반환합니다.getBusinessAccountGifts비즈니스 계정의 선물을 반환합니다.transferBusinessAccountStars비즈니스 계정의 Stars를 봇 잔액으로 이체합니다.readBusinessMessage비즈니스 계정을 대신하여 수신 메시지를 읽음으로 표시합니다.deleteBusinessMessages비즈니스 계정을 대신하여 메시지를 삭제합니다.setBusinessAccountName비즈니스 계정 이름을 설정합니다.setBusinessAccountUsername비즈니스 계정 사용자명을 설정합니다.setBusinessAccountBio비즈니스 계정 소개를 설정합니다.setBusinessAccountProfilePhoto비즈니스 계정 프로필 사진을 설정합니다.removeBusinessAccountProfilePhoto비즈니스 계정 프로필 사진을 삭제합니다.setBusinessAccountGiftSettings비즈니스 계정의 선물 설정을 변경합니다.
기타 11
getCustomEmojiStickers커스텀 이모지 스티커 정보를 반환합니다.getUserChatBoosts사용자의 채팅 부스트를 반환합니다.getBusinessConnection비즈니스 연결 정보를 가져옵니다.savePreparedInlineMessage준비된 인라인 메시지를 저장합니다.verifyUser조직을 대신하여 사용자를 인증합니다.verifyChat조직을 대신하여 채팅을 인증합니다.removeUserVerification사용자 인증을 제거합니다.removeChatVerification채팅 인증을 제거합니다.setUserEmojiStatus사용자의 이모지 상태를 설정합니다.savePreparedKeyboardButtonMini App용 키보드 버튼을 저장합니다.setPassportDataErrors사용자에게 Telegram Passport 오류를 알립니다.