Telegram 노드 Message 작업 문서
n8n v2.29이 작업을 사용하여 채팅에서 메시지를 보내고, 편집하고, 삭제하며, 채팅에 파일을 전송하고, 채팅에서 메시지를 고정/고정 해제할 수 있습니다. 이 작업 대부분을 사용하려면 봇을 채널에 추가해서 해당 채널에 메시지를 보낼 수 있도록 해야 합니다.
이 작업을 사용하여 채팅에서 메시지를 보내고, 편집하고, 삭제하며, 채팅에 파일을 전송하고, 채팅에서 메시지를 고정/고정 해제할 수 있습니다. Telegram 노드 자체에 대한 자세한 내용은 Telegram을 참조하세요.
채널에 봇 추가
이 작업 대부분을 사용하려면 봇을 채널에 추가해서 해당 채널에 메시지를 보낼 수 있도록 해야 합니다. 자세한 내용은 Common Issues | Telegram 채널에 봇 추가하기를 참조하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Delete Chat Message#
Bot API deleteMessage 메서드를 사용하여 채팅에서 메시지를 삭제하려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Delete Chat Message를 선택합니다.
- Chat ID: 삭제하려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Message ID: 삭제하려는 메시지의 고유 식별자를 입력합니다.
자세한 내용은 Telegram Bot API deleteMessage 문서를 참조하세요.
Edit Message Text#
Bot API editMessageText 메서드를 사용하여 기존 메시지의 텍스트를 편집하려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Edit Message Text를 선택합니다.
- Chat ID: 탈퇴하려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Message ID: 편집하려는 메시지의 고유 식별자를 입력합니다.
- Reply Markup: InlineKeyboardMarkup을 표시하려면 Inline Keyboard를, 표시하지 않으려면 None을 선택합니다. 이는
reply_markup매개변수를 설정합니다. 자세한 내용은 InlineKeyboardMarkup 문서를 참조하세요. - Text: 메시지를 편집할 텍스트를 입력합니다.
자세한 내용은 Telegram Bot API editMessageText 문서를 참조하세요.
Edit Message Text 추가 필드#
Additional Fields를 사용하여 노드의 동작을 세부적으로 조정합니다. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Disable WebPage Preview: 이 메시지의 링크에 대한 링크 미리보기를 활성화(꺼짐)할지 비활성화(켜짐)할지 선택합니다. 이는
link_preview_options매개변수의is_disabled를 설정합니다. 자세한 내용은 LinkPreviewOptions 문서를 참조하세요. - Parse Mode: 메시지를 파싱할 방식으로 HTML(기본값), Markdown (Legacy), MarkdownV2 중 선택합니다. 이는
parse_mode매개변수를 설정합니다.
Pin Chat Message#
Bot API pinChatMessage 메서드를 사용하여 채팅에 메시지를 고정하려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Pin Chat Message를 선택합니다.
- Chat ID: 메시지를 고정하려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | 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 credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Animation을 선택합니다.
- Chat ID: 애니메이션을 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Animation: Binary File을 사용하지 않는다면 여기에 보낼 애니메이션을 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram Bot API sendAnimation 문서를 참조하세요.
Send Animation 추가 필드#
Telegram의 sendAnimation 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. 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 형식
- 200KB 미만 크기
- 너비와 높이 320px 미만.
- Width: 동영상 클립의 너비를 입력합니다.
Send Audio#
Bot API sendAudio 메서드를 사용하여 채팅에 오디오 파일을 보내고 뮤직 플레이어에 표시하려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Audio를 선택합니다.
- Chat ID: 오디오를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Audio: Binary File을 사용하지 않는다면 여기에 보낼 오디오를 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram Bot API sendAudio 문서를 참조하세요.
Send Audio 추가 필드#
Telegram의 sendAudio 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. 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 형식
- 200KB 미만 크기
- 너비와 높이 320px 미만.
Send Chat Action#
봇 측에서 무언가가 진행 중이라는 것을 사용자에게 알려야 할 때 이 작업을 사용하세요. Bot API sendChatAction 메서드를 사용하여 상태가 5초 이하 동안 설정됩니다.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Chat Action을 선택합니다.
- Chat ID: 채팅 액션을 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Action: 봇이 수행 중인 것으로 표시하고 싶은 액션을 선택합니다. 여기에는 Find Location, Typing, 오디오나 비디오 Recording, 그리고 Uploading 파일 유형이 포함됩니다.
자세한 내용은 Telegram의 Bot API sendChatAction 문서를 참조하세요.
Send Document#
Bot API sendDocument 메서드를 사용하여 채팅에 문서를 보내려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Document를 선택합니다.
- Chat ID: 문서를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Document: Binary File을 사용하지 않는다면 여기에 보낼 문서를 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram의 sendDocument 문서를 참조하세요.
Send Document 추가 필드#
Telegram의 sendDocument 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Caption: 파일의 캡션 텍스트를 입력합니다. 최대 1024자입니다.
- Disable Notification: 알림을 무음으로 보낼지(켜짐), 표준 알림으로 보낼지(꺼짐) 선택합니다.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML(기본값), Markdown (Legacy), MarkdownV2가 있습니다. 이러한 옵션에 대한 자세한 내용은 Formatting options를 참조하세요.
- Reply To Message ID: 메시지가 답장인 경우, 답장 대상 메시지의 ID를 입력합니다.
- Message Thread ID: 포럼(슈퍼그룹 전용)의 대상 메시지 스레드(토픽)에 대한 고유 식별자를 입력합니다.
- Thumbnail: 전송된 파일의 썸네일을 추가합니다. 서버 측에서 파일의 썸네일 생성을 지원하는 경우 이 필드는 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
- JPEG 형식
- 200KB 미만 크기
- 너비와 높이 320px 미만.
Send Location#
Bot API sendLocation 메서드를 사용하여 채팅에 지리적 위치를 보내려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Location을 선택합니다.
- Chat ID: 위치를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Latitude: 위치의 위도를 입력합니다.
- Longitude: 위치의 경도를 입력합니다.
- Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram의 Bot API sendLocation 문서를 참조하세요.
Send Location 추가 필드#
Telegram의 sendLocation 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Disable Notification: 알림을 무음으로 보낼지(켜짐), 표준 알림으로 보낼지(꺼짐) 선택합니다.
- Reply To Message ID: 메시지가 답장인 경우, 답장 대상 메시지의 ID를 입력합니다.
- Message Thread ID: 포럼(슈퍼그룹 전용)의 대상 메시지 스레드(토픽)에 대한 고유 식별자를 입력합니다.
Send Media Group#
Bot API sendMediaGroup 메서드를 사용하여 사진 및/또는 동영상 그룹을 보내려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Media Group을 선택합니다.
- Chat ID: 미디어 그룹을 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Media: Add Media를 사용하여 서로 다른 유형의 미디어를 미디어 그룹에 추가합니다. 각 미디어 항목에 대해 다음을 선택합니다:
- Type: 이 미디어의 유형입니다. Photo와 Video 중에서 선택합니다.
- Media File: 보낼 미디어 파일을 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Additional Fields: 각 미디어 파일에 대해 다음 필드를 추가로 선택할 수 있습니다:
- Caption: 파일의 캡션 텍스트를 입력합니다. 최대 1024자입니다.
- Parse Mode: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML(기본값), Markdown (Legacy), MarkdownV2가 있습니다. 이러한 옵션에 대한 자세한 내용은 Formatting options를 참조하세요.
자세한 내용은 Telegram의 Bot API sendMediaGroup 문서를 참조하세요.
Send Media Group 추가 필드#
Telegram의 sendMediaGroup 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Disable Notification: 알림을 무음으로 보낼지(켜짐), 표준 알림으로 보낼지(꺼짐) 선택합니다.
- Reply To Message ID: 메시지가 답장인 경우, 답장 대상 메시지의 ID를 입력합니다.
- Message Thread ID: 포럼(슈퍼그룹 전용)의 대상 메시지 스레드(토픽)에 대한 고유 식별자를 입력합니다.
Send Message#
Bot API sendMessage 메서드를 사용하여 채팅에 메시지를 보내려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Message를 선택합니다.
- Chat ID: 메시지를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Text: 보낼 텍스트를 입력합니다. 엔티티 파싱 후 최대 4096자입니다.
자세한 내용은 Telegram의 Bot API sendMessage 문서를 참조하세요.
Send Message 제한
Telegram은 초당 보낼 수 있는 메시지 수를 30개로 제한합니다. 이 한도에 도달할 것으로 예상되는 경우, 제안된 해결 방법은 초당 30개 이상의 메시지 보내기를 참조하세요.
Send Message 추가 필드#
Telegram의 sendMessage 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Append n8n Attribution: 메시지 끝에
This message was sent automatically with n8n문구를 포함할지(켜짐, 기본값) 포함하지 않을지(꺼짐) 선택합니다. - Disable Notification: 알림을 무음으로 보낼지(켜짐), 표준 알림으로 보낼지(꺼짐) 선택합니다.
- Disable WebPage Preview: 이 메시지의 링크에 대한 링크 미리보기를 활성화(꺼짐)할지 비활성화(켜짐)할지 선택합니다. 이는
link_preview_options매개변수의is_disabled를 설정합니다. 자세한 내용은 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 credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send and Wait for Response를 선택합니다.
- Chat ID: 메시지를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Message: 보낼 텍스트를 입력합니다.
- Response Type: 사용할 승인 또는 응답 유형입니다:
- Approval: 사용자는 메시지 내에서 승인하거나 거부할 수 있습니다.
- Free Text: 사용자는 폼을 통해 응답을 제출할 수 있습니다.
- Custom Form: 사용자는 커스텀 폼을 통해 응답을 제출할 수 있습니다.
자세한 내용은 Telegram의 Bot API sendMessage 문서를 참조하세요.
Send Message 제한
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 trigger의 폼 요소에 설명된 설정을 사용하여 각 폼 요소를 커스터마이즈할 수 있습니다. 필드를 더 추가하려면 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 credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Photo를 선택합니다.
- Chat ID: 사진을 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Photo: Binary File을 사용하지 않는다면 여기에 보낼 사진을 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram의 Bot API sendPhoto 문서를 참조하세요.
Send Photo 추가 필드#
Telegram의 sendPhoto 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. 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 credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Sticker를 선택합니다.
- Chat ID: 스티커를 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Sticker: Binary File을 사용하지 않는다면 여기에 보낼 사진을 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram의 Bot API sendSticker 문서를 참조하세요.
Send Sticker 추가 필드#
Telegram의 sendSticker 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. Add Field를 선택하여 다음 중 원하는 항목을 추가하세요:
- Disable Notification: 알림을 무음으로 보낼지(켜짐), 표준 알림으로 보낼지(꺼짐) 선택합니다.
- Reply To Message ID: 메시지가 답장인 경우, 답장 대상 메시지의 ID를 입력합니다.
- Message Thread ID: 포럼(슈퍼그룹 전용)의 대상 메시지 스레드(토픽)에 대한 고유 식별자를 입력합니다.
Send Video#
Bot API sendVideo 메서드를 사용하여 채팅에 동영상을 보내려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Send Video를 선택합니다.
- Chat ID: 동영상을 보내려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Binary File: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켰다면 보내려는 파일이 포함된 Input Binary Field를 입력해야 합니다.
- Video: Binary File을 사용하지 않는다면 여기에 보낼 동영상을 입력합니다. Telegram 서버에 존재하는 파일을 보내려면
file_id(권장)를, 인터넷에서 Telegram이 파일을 가져오도록 하려면 HTTP URL을 전달합니다. - Reply Markup: 이 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용 방법에 대한 자세한 내용은 Reply Markup parameters를 참조하세요.
자세한 내용은 Telegram의 Bot API sendVideo 문서를 참조하세요.
Send Video 추가 필드#
Telegram의 sendVideo 메서드에서 선택적 필드를 사용하여 노드의 동작을 세부적으로 조정하려면 Additional Fields를 사용하세요. 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 형식
- 200KB 미만 크기
- 너비와 높이 320px 미만.
- Width: 동영상의 너비를 입력합니다.
채팅 메시지 고정 해제#
Bot API unpinChatMessage 메서드를 사용하여 채팅에서 메시지의 고정을 해제하려면 이 작업을 사용하세요.
다음 매개변수를 입력합니다:
- Credential to connect with: 기존 Telegram credential을 생성하거나 선택합니다.
- Resource: Message를 선택합니다.
- Operation: Pin Chat Message를 선택합니다.
- Chat ID: 메시지 고정을 해제하려는 채널의 Chat ID 또는 사용자 이름을
@channelusername형식으로 입력합니다.- Chat ID를 이 노드에 직접 전달하려면 Telegram Trigger 노드를 사용하세요. 자세한 내용은 Common Issues | Chat ID 가져오기를 참조하세요.
- Message ID: 고정을 해제하려는 메시지의 고유 식별자를 입력합니다.
자세한 내용은 Telegram Bot API unpinChatMessage 문서를 참조하세요.
Reply Markup 매개변수#
대부분의 Message Send 작업(예: Send Animation, Send Audio)에서 Reply Markup 매개변수를 사용하여 추가 인터페이스 옵션을 설정합니다:
- Force Reply: Telegram 클라이언트는 사용자가 봇의 메시지를 선택하고 Reply를 탭한 것처럼 동작하여 사용자에게 답장 인터페이스를 자동으로 표시합니다. 이 옵션에 대한 자세한 안내는 Force Reply parameters를 참조하세요.
- Inline Keyboard: 메시지 바로 옆에 인라인 키보드를 표시합니다. 이 옵션에 대한 자세한 안내는 Inline Keyboard parameters를 참조하세요.
- Reply Keyboard: 답장 옵션이 있는 커스텀 키보드를 표시합니다. 이 옵션에 대한 자세한 안내는 Reply Keyboard parameters를 참조하세요.
- Reply Keyboard Remove: Telegram 클라이언트는 현재 커스텀 키보드를 제거하고 기본 문자 키보드를 표시합니다. 이 옵션에 대한 자세한 안내는 Reply Keyboard parameters를 참조하세요.
Telegram Business 계정
Telegram은 채널 및 Telegram Business 계정을 대신하여 보낸 메시지에서 다음 옵션을 제한합니다:
- Force Reply
- Reply Keyboard
- Reply Keyboard Remove
Force Reply 매개변수#
Force Reply는 프라이버시 모드를 희생하지 않고도 사용자 친화적인 단계별 인터페이스를 만들고 싶을 때 유용합니다.
Reply Markup > Force Reply를 선택하면 다음 Force Reply 매개변수 중에서 선택합니다:
- Force Reply: 위에서 설명한 것처럼 사용자에게 답장 인터페이스를 표시하려면 켭니다.
- Selective: 다음 사용자에게만 답장을 강제하고 싶다면 이 옵션을 켭니다:
- 메시지 텍스트에서
@mentioned된 사용자. - 이 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: 다음 사용자에게만 키보드를 표시하고 싶다면 이 옵션을 켭니다:
- 메시지 텍스트에서
@mentioned된 사용자. - 이 Send Animation 메시지가 어떤 메시지에 대한 답장인 경우, 원본 메시지의 발신자.
- 메시지 텍스트에서
자세한 내용은 ReplyKeyboardMarkup를 참조하세요.
Reply Keyboard Remove 매개변수#
Reply Markup > Reply Keyboard Remove를 선택하면 다음 Reply Keyboard Remove 매개변수 중에서 선택합니다:
- Remove Keyboard: Telegram 클라이언트에 커스텀 키보드를 제거하도록 요청할지(켜짐), 유지할지(꺼짐) 선택합니다.
- Selective: 다음 사용자에 대해서만 키보드를 제거하고 싶다면 이 옵션을 켭니다:
- 메시지 텍스트에서
@mentioned된 사용자. - 이 Send Animation 메시지가 어떤 메시지에 대한 답장인 경우, 원본 메시지의 발신자.
- 메시지 텍스트에서
자세한 내용은 ReplyKeyboardRemove를 참조하세요.