Telegram 노드 Message 작업 문서
이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. 대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다.
이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. Telegram 노드 자체에 대한 자세한 내용은 Telegram을 참고하세요.
대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 자세한 내용은 공통 이슈 | Telegram 채널에 봇 추가를 참고하세요.
이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 방식으로 사용하면 많은 파라미터를 자동으로 설정하거나 AI가 제공하는 정보로 설정할 수 있습니다. 자세한 내용은 AI 도구 파라미터 문서를 참조하세요.
이 노드는 AI 에이전트 도구 호출에 대한 사람 검토 단계로 사용할 수 있습니다. 이 방식으로 구성하면 AI 에이전트가 감독이 필요한 도구를 실행하기 전에 이 서비스를 통해 사람의 승인을 요청하며 일시 중지됩니다. 자세한 내용은 AI 도구 호출을 위한 Human-in-the-loop을 참조하세요.
Delete Chat Message#
Bot API deleteMessage 메서드를 사용해 채팅에서 메시지를 삭제합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Delete Chat Message를 선택하세요.
- Chat ID: 삭제할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Message ID: 삭제할 메시지의 고유 식별자를 입력하세요.
자세한 내용은 Telegram Bot API deleteMessage 문서를 참고하세요.
Edit Message Text#
Bot API editMessageText 메서드를 사용해 기존 메시지의 텍스트를 편집합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Edit Message Text를 선택하세요.
- Chat ID: 나가려는 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Message ID: 편집할 메시지의 고유 식별자를 입력하세요.
- Reply Markup: Inline Keyboard로 InlineKeyboardMarkup을 표시할지, None으로 표시하지 않을지 선택하세요. 이것은
reply_markup파라미터를 설정합니다. 자세한 내용은 InlineKeyboardMarkup 문서를 참고하세요. - Text: 메시지를 편집할 텍스트를 입력하세요.
자세한 내용은 Telegram Bot API editMessageText 문서를 참고하세요.
Edit Message Text 추가 필드#
Additional Fields를 사용해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Disable WebPage Preview: 이 메시지의 링크 미리보기를 활성화할지(꺼짐) 비활성화할지(켜짐) 선택하세요. 이것은
is_disabled에 대한link_preview_options파라미터를 설정합니다. 자세한 내용은 LinkPreviewOptions 문서를 참고하세요. - Parse Mode: 메시지를 HTML(기본값), Markdown (Legacy) 또는 MarkdownV2 중 어느 것으로 파싱할지 선택하세요. 이것은
parse_mode파라미터를 설정합니다.
Pin Chat Message#
Bot API pinChatMessage 메서드를 사용해 채팅 메시지를 고정합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Pin Chat Message를 선택하세요.
- Chat ID: 메시지를 고정할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Message ID: 고정할 메시지의 고유 식별자를 입력하세요.
자세한 내용은 Telegram Bot API pinChatMessage 문서를 참고하세요.
Pin Chat Message 추가 필드#
Additional Fields를 사용해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Disable Notifications: 기본적으로 Telegram은 메시지가 고정되었음을 모든 채팅 멤버에게 알립니다. 이 알림을 보내지 않으려면 이 제어를 켜세요.
disable_notification파라미터를true로 설정합니다.
Send Animation#
Bot API sendAnimation 메서드를 사용해 최대 50MB의 GIF 또는 무음 H.264/MPEG-4 AVC 동영상을 채팅에 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Animation을 선택하세요.
- Chat ID: 애니메이션을 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Animation: Binary File을 사용하지 않는 경우 전송할 애니메이션을 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendAnimation 문서를 참고하세요.
Send Animation 추가 필드#
Additional Fields를 사용해 Telegram의 sendAnimation 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Caption: 애니메이션의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Duration: 애니메이션의 재생 시간(초)을 입력하세요.
- Height: 애니메이션의 높이를 입력하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Telegram의 Formatting options을 참고하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
- Thumbnail: 전송된 파일의 썸네일을 추가하세요. 서버 측에서 파일에 대한 썸네일 생성이 지원되는 경우 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
- JPEG 형식
- 200 KB 미만
- 너비와 높이 320px 미만
- Width: 동영상 클립의 너비를 입력하세요.
Send Audio#
Bot API sendAudio 메서드를 사용해 오디오 파일을 채팅에 전송하고 음악 플레이어에 표시합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Audio를 선택하세요.
- Chat ID: 오디오를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Audio: Binary File을 사용하지 않는 경우 전송할 오디오를 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendAudio 문서를 참고하세요.
Send Audio 추가 필드#
Additional Fields를 사용해 Telegram의 sendAudio 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Caption: 오디오의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Duration: 오디오의 재생 시간(초)을 입력하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Telegram의 Formatting options을 참고하세요.
- Performer: 연주자 이름을 입력하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
- Title: 오디오 트랙 이름을 입력하세요.
- Thumbnail: 전송된 파일의 썸네일을 추가하세요. 서버 측에서 파일에 대한 썸네일 생성이 지원되는 경우 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
- JPEG 형식
- 200 KB 미만
- 너비와 높이 320px 미만
Send Chat Action#
Bot API sendChatAction 메서드를 사용해 봇 측에서 무언가 진행 중임을 사용자에게 알립니다. 상태는 5초 이하로 설정됩니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Chat Action을 선택하세요.
- Chat ID: 채팅 액션을 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Action: 봇이 수행 중으로 브로드캐스트할 액션을 선택하세요. Find Location, Typing, 오디오 또는 동영상 Recording, 파일 유형 Uploading 등이 포함됩니다.
자세한 내용은 Telegram Bot API sendChatAction 문서를 참고하세요.
Send Document#
Bot API sendDocument 메서드를 사용해 채팅에 문서를 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Document를 선택하세요.
- Chat ID: 문서를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Document: Binary File을 사용하지 않는 경우 전송할 문서를 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendDocument 문서를 참고하세요.
Send Document 추가 필드#
Additional Fields를 사용해 Telegram의 sendDocument 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Caption: 파일의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Formatting options을 참고하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
- Thumbnail: 전송된 파일의 썸네일을 추가하세요. 서버 측에서 파일에 대한 썸네일 생성이 지원되는 경우 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
- JPEG 형식
- 200 KB 미만
- 너비와 높이 320px 미만
Send Location#
Bot API sendLocation 메서드를 사용해 채팅에 위치 정보를 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Location을 선택하세요.
- Chat ID: 위치 정보를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Latitude: 위치의 위도를 입력하세요.
- Longitude: 위치의 경도를 입력하세요.
- Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendLocation 문서를 참고하세요.
Send Location 추가 필드#
Additional Fields를 사용해 Telegram의 sendLocation 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
Send Media Group#
Bot API sendMediaGroup 메서드를 사용해 사진 및/또는 동영상 그룹을 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Media Group을 선택하세요.
- Chat ID: 미디어 그룹을 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Media: Add Media를 사용해 미디어 그룹에 다양한 미디어 유형을 추가하세요. 각 미디어에 대해 다음을 선택합니다:
- Type: 미디어 유형. Photo 또는 Video 중 선택하세요.
- Media File: 전송할 미디어 파일을 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Additional Fields: 각 미디어 파일에 대해 다음 필드를 추가할 수 있습니다:
- Caption: 파일의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Formatting options을 참고하세요.
자세한 내용은 Telegram Bot API sendMediaGroup 문서를 참고하세요.
Send Media Group 추가 필드#
Additional Fields를 사용해 Telegram의 sendMediaGroup 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
Send Message#
Bot API sendMessage 메서드를 사용해 채팅에 메시지를 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Message를 선택하세요.
- Chat ID: 메시지를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Text: 전송할 텍스트를 입력하세요. 엔티티 파싱 후 최대 4096자입니다.
자세한 내용은 Telegram Bot API sendMessage 문서를 참고하세요.
Telegram은 초당 30개의 메시지 전송 제한이 있습니다. 이 제한에 달할 것으로 예상되면 초당 30개 이상의 메시지 전송의 해결 방법을 참고하세요.
Send Message 추가 필드#
Additional Fields를 사용해 Telegram의 sendMessage 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Append n8n Attribution: 메시지 끝에
This message was sent automatically with n8n문구를 포함할지(켜짐, 기본값) 포함하지 않을지(꺼짐) 선택하세요. - Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Disable WebPage Preview: 이 메시지의 링크 미리보기를 활성화할지(꺼짐) 비활성화할지(켜짐) 선택하세요. 이것은
is_disabled에 대한link_preview_options파라미터를 설정합니다. 자세한 내용은 LinkPreviewOptions 문서를 참고하세요. - Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Telegram의 Formatting options을 참고하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
Send and Wait for Response#
Bot API sendMessage 메서드를 사용해 채팅에 메시지를 전송하고 사용자가 작업을 확인할 때까지 워크플로 실행을 일시 중지합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send and Wait for Response를 선택하세요.
- Chat ID: 메시지를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Message: 전송할 텍스트를 입력하세요.
- Response Type: 사용할 승인 또는 응답 유형:
- Approval: 사용자가 메시지 내에서 승인 또는 거부할 수 있습니다.
- Free Text: 사용자가 양식으로 응답을 제출할 수 있습니다.
- Custom Form: 사용자가 커스텀 양식으로 응답을 제출할 수 있습니다.
자세한 내용은 Telegram Bot API sendMessage 문서를 참고하세요.
Telegram은 초당 30개의 메시지 전송 제한이 있습니다. 이 제한에 달할 것으로 예상되면 초당 30개 이상의 메시지 전송의 해결 방법을 참고하세요.
Send and Wait for Response 추가 필드#
추가 필드는 선택한 Response Type에 따라 달라집니다.
Approval#
Approval 응답 유형은 다음 옵션을 추가합니다:
- Type of Approval: 승인 버튼만 표시할지 또는 승인 및 거부 버튼 모두 표시할지 선택하세요.
- Button Label: 승인 또는 거부 버튼의 레이블. 기본값은 승인 액션의 경우
✅ Approve, 거부 액션의 경우❌ Decline입니다. - Limit Wait Time: 지정된 시간 제한 후 워크플로가 자동으로 실행을 재개할지 여부를 설정합니다. 간격 또는 특정 시각으로 설정할 수 있습니다.
Free Text#
Free Text 응답 유형 사용 시 다음 옵션을 사용할 수 있습니다:
- Message Button Label: 메시지 버튼에 사용할 레이블. 기본값은
Respond입니다. - Response Form Title: 사용자가 응답을 제공하는 양식의 제목입니다.
- Response Form Description: 사용자가 응답을 제공하는 양식의 설명입니다.
- Response Form Button Label: 응답을 제출하는 양식의 버튼 레이블. 기본값은
Submit입니다. - Limit Wait Time: 지정된 시간 제한 후 워크플로가 자동으로 실행을 재개할지 여부를 설정합니다.
Custom Form#
Custom Form 응답 유형 사용 시 원하는 필드와 옵션을 사용해 양식을 만드세요.
각 양식 요소는 n8n Form 트리거의 양식 요소에 설명된 설정으로 커스터마이징할 수 있습니다. 필드를 추가하려면 Add Form Element 버튼을 선택하세요.
다음 옵션도 사용할 수 있습니다:
- Message Button Label: 메시지 버튼에 사용할 레이블. 기본값은
Respond입니다. - Response Form Title: 사용자가 응답을 제공하는 양식의 제목입니다.
- Response Form Description: 사용자가 응답을 제공하는 양식의 설명입니다.
- Response Form Button Label: 응답을 제출하는 양식의 버튼 레이블. 기본값은
Submit입니다. - Limit Wait Time: 지정된 시간 제한 후 워크플로가 자동으로 실행을 재개할지 여부를 설정합니다.
Send Photo#
Bot API sendPhoto 메서드를 사용해 채팅에 사진을 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Photo를 선택하세요.
- Chat ID: 사진을 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Photo: Binary File을 사용하지 않는 경우 전송할 사진을 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendPhoto 문서를 참고하세요.
Send Photo 추가 필드#
Additional Fields를 사용해 Telegram의 sendPhoto 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Caption: 파일의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Telegram의 Formatting options을 참고하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
Send Sticker#
Bot API sendSticker 메서드를 사용해 정적 .WEBP, 애니메이션 .TGS 또는 동영상 .WEBM 스티커를 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Sticker를 선택하세요.
- Chat ID: 스티커를 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Sticker: Binary File을 사용하지 않는 경우 전송할 사진을 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendSticker 문서를 참고하세요.
Send Sticker 추가 필드#
Additional Fields를 사용해 Telegram의 sendSticker 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
Send Video#
Bot API sendVideo 메서드를 사용해 채팅에 동영상을 전송합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Send Video를 선택하세요.
- Chat ID: 동영상을 전송할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 파라미터를 켜면 전송할 파일이 담긴 Input Binary Field를 입력해야 합니다.
- Video: Binary File을 사용하지 않는 경우 전송할 동영상을 여기에 입력하세요. Telegram 서버에 존재하는 파일을 보내려면
file_id를 전달하거나(권장), 인터넷에서 파일을 가져오도록 HTTP URL을 전달하세요. - Reply Markup: 이 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요. 자세한 내용은 Reply Markup 파라미터를 참고하세요.
자세한 내용은 Telegram Bot API sendVideo 문서를 참고하세요.
Send Video 추가 필드#
Additional Fields를 사용해 Telegram의 sendVideo 메서드의 선택적 필드를 통해 노드 동작을 세부 조정하세요. Add Field를 선택해 다음 중 하나를 추가합니다:
- Caption: 동영상의 캡션 텍스트를 최대 1024자까지 입력하세요.
- Disable Notification: 알림을 무음으로 전송할지(켜짐) 또는 표준 알림으로 전송할지(꺼짐) 선택하세요.
- Duration: 동영상의 재생 시간(초)을 입력하세요.
- Height: 동영상의 높이를 입력하세요.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력하세요. HTML(기본값), Markdown (Legacy), MarkdownV2 중 하나를 선택할 수 있습니다. 자세한 내용은 Telegram의 Formatting options을 참고하세요.
- Reply To Message ID: 이 메시지가 다른 메시지에 대한 답장인 경우 해당 메시지의 ID를 입력하세요.
- Message Thread ID: 포럼 슈퍼그룹에서만 사용하는 대상 메시지 스레드(주제)의 고유 식별자를 입력하세요.
- Thumbnail: 전송된 파일의 썸네일을 추가하세요. 서버 측에서 파일에 대한 썸네일 생성이 지원되는 경우 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
- JPEG 형식
- 200 KB 미만
- 너비와 높이 320px 미만
- Width: 동영상의 너비를 입력하세요.
Unpin Chat Message#
Bot API unpinChatMessage 메서드를 사용해 채팅에서 메시지 고정을 해제합니다.
다음 파라미터를 입력하세요:
- Credential to connect with: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
- Resource: Message를 선택하세요.
- Operation: Pin Chat Message를 선택하세요.
- Chat ID: 메시지 고정을 해제할 채널의 Chat ID 또는
@channelusername형식의 사용자 이름을 입력하세요.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 공통 이슈 | Chat ID 가져오기를 참고하세요.
- Message ID: 고정 해제할 메시지의 고유 식별자를 입력하세요.
자세한 내용은 Telegram Bot API unpinChatMessage 문서를 참고하세요.
Reply Markup 파라미터#
대부분의 Message Send 작업(Send Animation, Send Audio 등)에서 Reply Markup 파라미터를 사용해 추가 인터페이스 옵션을 설정하세요:
- Force Reply: Telegram 클라이언트는 사용자가 봇의 메시지를 선택하고 Reply를 탭한 것처럼 동작하여 자동으로 답장 인터페이스를 표시합니다. 자세한 내용은 Force Reply 파라미터를 참고하세요.
- Inline Keyboard: 메시지 바로 옆에 인라인 키보드를 표시합니다. 자세한 내용은 Inline Keyboard 파라미터를 참고하세요.
- Reply Keyboard: 답장 옵션이 있는 커스텀 키보드를 표시합니다. 자세한 내용은 Reply Keyboard 파라미터를 참고하세요.
- Reply Keyboard Remove: Telegram 클라이언트는 현재 커스텀 키보드를 제거하고 기본 문자 키보드를 표시합니다. 자세한 내용은 Reply Keyboard 파라미터를 참고하세요.
Telegram은 채널과 Telegram Business 계정을 대신해 전송된 메시지에서 다음 옵션을 제한합니다:
- Force Reply
- Reply Keyboard
- Reply Keyboard Remove
Force Reply 파라미터#
Force Reply는 개인 정보 보호 모드를 희생하지 않고도 사용자 친화적인 단계별 인터페이스를 만들 때 유용합니다.
Reply Markup > Force Reply를 선택하면 다음 Force Reply 파라미터 중에서 선택하세요:
- Force Reply: 켜면 위에 설명된 대로 사용자에게 답장 인터페이스를 표시합니다.
- Selective: 다음 사용자에게만 답장을 강제하려면 켜세요:
- 메시지 텍스트에서
@멘션된 사용자. - 이 Send Animation 메시지가 다른 메시지에 대한 답장인 경우 원래 메시지의 발신자.
- 메시지 텍스트에서
자세한 내용은 ForceReply를 참고하세요.
Inline Keyboard 파라미터#
Reply Markup > Inline Keyboard를 선택하면 Add Button 옵션을 사용해 표시할 인라인 키보드 버튼을 정의하세요. 키보드에 행을 추가하려면 Add Keyboard Row를 사용하세요.
자세한 내용은 InlineKeyboardMarkup 및 InlineKeyboardButtons를 참고하세요.
Reply Keyboard 파라미터#
Reply Markup > Reply Keyboard를 선택하면 Reply Keyboard 섹션을 사용해 Reply Keyboard의 버튼과 행을 정의하세요.
Reply Keyboard Options를 사용해 키보드 동작을 세부 조정하세요:
- Resize Keyboard: Telegram 클라이언트가 최적의 크기로 키보드를 수직으로 조정하도록 요청할지(켜짐) 또는 앱의 표준 키보드와 동일한 높이를 사용할지(꺼짐) 선택하세요.
- One Time Keyboard: Telegram 클라이언트가 사용자가 키보드를 사용한 즉시 숨길지(켜짐) 또는 계속 표시할지(꺼짐) 선택하세요.
- Selective: 다음 사용자에게만 키보드를 표시하려면 켜세요:
- 메시지 텍스트에서
@멘션된 사용자. - 이 Send Animation 메시지가 다른 메시지에 대한 답장인 경우 원래 메시지의 발신자.
- 메시지 텍스트에서
자세한 내용은 ReplyKeyboardMarkup을 참고하세요.
Reply Keyboard Remove 파라미터#
Reply Markup > Reply Keyboard Remove를 선택하면 다음 Reply Keyboard Remove 파라미터 중에서 선택하세요:
- Remove Keyboard: Telegram 클라이언트가 커스텀 키보드를 제거하도록 요청할지(켜짐) 또는 유지할지(꺼짐) 선택하세요.
- Selective: 다음 사용자에게만 키보드를 제거하려면 켜세요:
- 메시지 텍스트에서
@멘션된 사용자. - 이 Send Animation 메시지가 다른 메시지에 대한 답장인 경우 원래 메시지의 발신자.
- 메시지 텍스트에서
자세한 내용은 ReplyKeyboardRemove를 참고하세요.
