다음을 통해 공유


텔레그램 봇 (개별 게시자)

Telegram Bot API는 Telegram용 봇을 빌드하려는 개발자를 위해 만든 HTTP 기반 인터페이스입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 최웅
URL https://www.linkedin.com/in/woongchoi/
전자 메일 woong.choi@rapidcircle.com
커넥터 메타데이터
게시자 최웅
웹 사이트 https://telegram.org/
개인 정보 보호 정책 https://telegram.org/privacy
카테고리 Communication

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

Get Me

User 개체의 형태로 봇에 대한 기본 정보를 반환합니다. 봇의 인증 토큰을 테스트하는 간단한 방법입니다.

메시지 보내기

이 메서드를 사용하여 문자 메시지 보내기

사진 보내기

이 방법을 사용하여 사진을 보냅니다.

업데이트 가져오기

이 메서드를 사용하여 긴 폴링을 사용하여 들어오는 업데이트를 받습니다.

채팅 받기

이 방법을 사용하여 채팅에 대한 최신 정보 가져오기

Get Me

User 개체의 형태로 봇에 대한 기본 정보를 반환합니다. 봇의 인증 토큰을 테스트하는 간단한 방법입니다.

매개 변수

Name 필수 형식 Description
봇 토큰
token True string

전보 봇 토큰입니다. 예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

반환

Name 경로 형식 Description
그래
ok boolean

요청 성공

사용자
result User

이 개체는 Telegram 사용자 또는 봇을 나타냅니다.

메시지 보내기

이 메서드를 사용하여 문자 메시지 보내기

매개 변수

Name 필수 형식 Description
봇 토큰
token True string

전보 봇 토큰입니다. 예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

채팅 ID
chat_id string

chat_id

문자 메시지
text string

보낼 텍스트

구문 분석 모드
parse_mode string

메시지 텍스트에서 엔터티를 구문 분석하는 모드입니다.

반환

Name 경로 형식 Description
그래
ok boolean

그래

Message
result Message

이 개체는 메시지를 나타냅니다.

사진 보내기

이 방법을 사용하여 사진을 보냅니다.

매개 변수

Name 필수 형식 Description
봇 토큰
token True string

전보 봇 토큰입니다. 예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

채팅 ID
chat_id string

chat_id

사진
photo string

Phototo send

반환

이 개체는 메시지를 나타냅니다.

Message
Message

업데이트 가져오기

이 메서드를 사용하여 긴 폴링을 사용하여 들어오는 업데이트를 받습니다.

매개 변수

Name 필수 형식 Description
봇 토큰
token True string

전보 봇 토큰입니다. 예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

반환

Name 경로 형식 Description
그래
ok boolean

요청 성공

결과
result array of Update

결과

채팅 받기

이 방법을 사용하여 채팅에 대한 최신 정보 가져오기

매개 변수

Name 필수 형식 Description
봇 토큰
token True string

전보 봇 토큰입니다. 예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

채팅 ID
chat_id string

chat_id

반환

이 개체는 메시지를 나타냅니다.

Message
Message

정의

Chat

이 개체는 채팅을 나타냅니다.

Name 경로 형식 Description
채팅 ID
id integer

이 채팅의 고유 식별자

이름 (First Name)
first_name string

비공개 채팅에서 상대방의 이름

성 이름
last_name string

비공개 채팅에서 상대방의 성

사용자 이름
username string

사용자 이름, 개인 채팅, 슈퍼 그룹 및 채널(사용 가능한 경우)

Chat
type string

채팅 유형은 "private", "group", "supergroup" 또는 "channel"일 수 있습니다.

Update

이 개체는 들어오는 업데이트를 나타냅니다.

Name 경로 형식 Description
ID 업데이트
update_id integer

업데이트의 고유 식별자입니다.

Message
message Message

이 개체는 메시지를 나타냅니다.

Message

이 개체는 메시지를 나타냅니다.

Name 경로 형식 Description
메시지 ID
message_id integer

이 채팅 내의 고유 메시지 식별자

사용자
from User

이 개체는 Telegram 사용자 또는 봇을 나타냅니다.

Chat
chat Chat

이 개체는 채팅을 나타냅니다.

날짜
date integer

메시지가 Unix 시간으로 전송된 날짜

문자 메시지
text string

문자 메시지의 경우 메시지의 실제 UTF-8 텍스트인 0-4096자

사용자

이 개체는 Telegram 사용자 또는 봇을 나타냅니다.

Name 경로 형식 Description
아이디
id integer

이 사용자 또는 봇에 대한 고유 식별자

봇인가요?
is_bot boolean

True, 이 사용자가 봇인 경우

이름 (First Name)
first_name string

사용자 또는 봇의 이름

성 이름
last_name string

사용자 또는 봇의 성

사용자 이름
username string

사용자 또는 봇의 사용자 이름

언어 코드
language_code string

사용자 언어의 IETF 언어 태그

그룹에 조인할 수 있습니다.
can_join_groups boolean

봇을 그룹에 초대할 수 있는 경우 True입니다.

모든 그룹 메시지를 읽을 수 있음
can_read_all_group_messages boolean

True이면 봇에 대해 개인 정보 모드를 사용할 수 없습니다.

인라인 쿼리 지원
supports_inline_queries boolean

True이면 봇이 인라인 쿼리를 지원합니다.