텔레그램
통신/외부메신저
텔레그램 봇으로 메시지·사진·문서·동영상을 보내거나, 사용자가 보낸 파일을 받는다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.telegram |
| 표시 이름 | 텔레그램 |
| 카테고리 | 통신/외부 |
| 그룹 | output |
| 버전 | 1 |
자격증명
| 이름 | 필수 |
|---|---|
telegramApi | 예 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 리소스 | resource | 선택 | message | 대상 리소스 선택지: 메시지( message) · 파일(file) |
| 작업 | operation | 선택 | sendMessage | 수행할 작업 (파일 리소스는 기본 'get') 선택지: 메시지 전송( sendMessage) · 사진 전송(sendPhoto) · 문서 전송(sendDocument) · 동영상 전송(sendVideo) · 위치 전송(sendLocation) · 메시지 편집(editMessageText) · 메시지 삭제(deleteMessage)표시 조건: resource = "message" |
| 챗 ID | chatId | 문자열 | "" | 대상 채팅 ID (표현식 사용 가능) 표시 조건: resource = "message" |
| 텍스트 | text | 문자열 | "" | 메시지 본문 표시 조건: operation = "sendMessage" 또는 "editMessageText" |
| 캡션 | caption | 문자열 | "" | 미디어 설명 문구 표시 조건: operation = "sendPhoto" 또는 "sendDocument" 또는 "sendVideo" |
| 저장 파일 사용 | binaryData | 불리언 | false | 파일 저장소(claim-check)에 저장된 파일을 전송할지 여부 표시 조건: operation = "sendPhoto" 또는 "sendDocument" 또는 "sendVideo" |
| 사진 URL/파일ID | photo | 문자열 | "" | binaryData 미사용 시 사진 소스 표시 조건: operation = "sendPhoto", binaryData = false |
| 문서 URL/파일ID | document | 문자열 | "" | binaryData 미사용 시 문서 소스 표시 조건: operation = "sendDocument", binaryData = false |
| 동영상 URL/파일ID | file | 문자열 | "" | binaryData 미사용 시 동영상 소스 표시 조건: operation = "sendVideo", binaryData = false |
| 위도 | latitude | 문자열 | "" | 표시 조건: operation = "sendLocation" |
| 경도 | longitude | 문자열 | "" | 표시 조건: operation = "sendLocation" |
| 메시지 ID | messageId | 문자열 | "" | 편집/삭제 대상 메시지 ID 표시 조건: operation = "editMessageText" 또는 "deleteMessage" |
| 파일 ID | fileId | 문자열 | "" | 받을 파일의 Telegram file_id 표시 조건: resource = "file" |
| 다운로드 | download | 불리언 | true | 파일 바이트를 실제로 내려받아 저장소에 보관할지 여부 표시 조건: resource = "file" |
| 추가 필드 | additionalFields | 컬렉션 | {} | — |
추가 필드 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 파싱 모드 | parseMode | 선택 | "" | 텍스트 서식 선택지: 없음() · Markdown · MarkdownV2 · HTML |
| 알림 끄기 | disableNotification | 불리언 | false | — |
| 콘텐츠 보호 | protectContent | 불리언 | false | — |
| 답장 대상 ID | replyToMessageId | 문자열 | "" | — |