텔레그램 봇 (개별 게시자)
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이면 봇이 인라인 쿼리를 지원합니다. |