Telegram
TelegramCommunication
View messages received by the bot and chats; send messages
Available tools 9
Hard-to-undo tools, such as sending or destructive actions, require your approval before running.
- telegram__api_destructiveDestructiveApproval required
Telegram Bot API 10.3 destructive 메서드 실행 — telegram__describe_operation에서 필수 입력·중첩 자료형·위험도를 먼저 조회한다. 서버의 고정 목록만 실행한다. 파일은 file_id·HTTPS URL 또는 attach://name과 attachments로 전달한다(합계 5 MiB). ⚠️ 삭제·권한·결제·웹훅·수신 확인은 되돌릴 수 없을 수 있다. 결과: result · pagination · truncated.
- telegram__api_sendSendApproval required
Telegram Bot API 10.3 send 메서드 실행 — telegram__describe_operation에서 필수 입력·중첩 자료형·위험도를 먼저 조회한다. 서버의 고정 목록만 실행한다. 파일은 file_id·HTTPS URL 또는 attach://name과 attachments로 전달한다(합계 5 MiB). ⚠️ 메시지·응답을 외부에 발신한다. 회수할 수 없을 수 있다. 요청에 대상·본문이 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. 결과: result · pagination · truncated.
- telegram__sendSendApproval required
Telegram 채팅·채널에 메시지 발송 — 봇 이름으로 보낸다. ⚠️ 상대에게 바로 전달된다. 수정·삭제할 수 있어도 알림은 회수할 수 없다. 요청에 대상·본문이 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다. 상대가 봇과 대화를 시작한 적이 있어야 한다. 서식·버튼·토픽을 지원한다. 일반 텍스트는 4096자마다 최대 5개로 나누고, 서식 본문은 4096자 이내여야 한다. 결과: sent · chat_id · messages_sent · last_message_id. 수정은 api_write editMessageText, 삭제는 api_destructive deleteMessage를 사용한다.
- telegram__api_writeWrite
Telegram Bot API 10.3 write 메서드 실행 — telegram__describe_operation에서 필수 입력·중첩 자료형·위험도를 먼저 조회한다. 서버의 고정 목록만 실행한다. 파일은 file_id·HTTPS URL 또는 attach://name과 attachments로 전달한다(합계 5 MiB). 결과: result · pagination · truncated.
- telegram__api_readRead
Telegram Bot API 10.3 read 메서드 실행 — telegram__describe_operation에서 필수 입력·중첩 자료형·위험도를 먼저 조회한다. 서버의 고정 목록만 실행한다. 파일은 file_id·HTTPS URL 또는 attach://name과 attachments로 전달한다(합계 5 MiB). 결과: result · pagination · truncated.
- telegram__describe_operationRead
Telegram 메서드 목록과 공식 입력 스키마 조회 — risk로 목록을 찾고 operation으로 필수 필드·중첩 ref를 확인한다. type_name으로 ref 자료형을 조회한다. 결과: operation · risk · fields · next_offset. 다음 offset으로 나머지 필드를 읽는다.
- telegram__download_fileRead
telegram__get_updates의 원본 update에서 받은 file_id로 파일 다운로드 — 3 KiB씩 base64로 돌려준다. 결과: data_base64 · next_offset · complete · 파일 메타데이터. next_offset으로 다음 조각을 받아 합친다. Cloud Bot API 최대 20 MiB이며 토큰·다운로드 URL은 돌려주지 않는다.
- telegram__get_chatRead
채팅(대화방) 정보 조회 — 유형·이름·설명. chat_id 는 telegram__get_updates 결과에서 확보한다
- telegram__get_updatesRead
봇이 받은 최근 24시간 업데이트 조회 — 오래된 순서, 수신 확인·필터 변경 없이 읽는다. 결과: chat_id · message_id · 원본 update · next_update_offset. 다음 offset으로 수신 확인할 때는 telegram__api_destructive의 getUpdates를 사용한다. 웹훅과 polling은 동시에 사용할 수 없다.