InfoGrab Docs

Telegram 노드 Message 작업 문서

요약

이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. 대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다.

이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. Telegram 노드 자체에 대한 자세한 내용은 Telegram을 참고하세요.

채널에 봇 추가

대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 자세한 내용은 공통 이슈 | Telegram 채널에 봇 추가를 참고하세요.

이 노드는 AI 도구로 사용할 수 있습니다

이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 방식으로 사용하면 많은 파라미터를 자동으로 설정하거나 AI가 제공하는 정보로 설정할 수 있습니다. 자세한 내용은 AI 도구 파라미터 문서를 참조하세요.

AI 도구 호출을 위한 Human-in-the-loop

이 노드는 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • Text: 전송할 텍스트를 입력하세요. 엔티티 파싱 후 최대 4096자입니다.

자세한 내용은 Telegram Bot API sendMessage 문서를 참고하세요.

Send Message 제한

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 형식의 사용자 이름을 입력하세요.
  • 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 트리거의 양식 요소에 설명된 설정으로 커스터마이징할 수 있습니다. 필드를 추가하려면 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 Business 계정

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를 사용하세요.

자세한 내용은 InlineKeyboardMarkupInlineKeyboardButtons를 참고하세요.

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를 참고하세요.

Telegram 노드 Message 작업 문서

원문 보기
요약

이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. 대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다.

이 작업들을 사용해 채팅에서 메시지를 전송, 편집, 삭제하거나, 파일을 전송하거나, 메시지를 고정/고정 해제하세요. Telegram 노드 자체에 대한 자세한 내용은 Telegram을 참고하세요.

채널에 봇 추가

대부분의 작업을 사용하려면 봇이 채널에 메시지를 보낼 수 있도록 채널에 봇을 추가해야 합니다. 자세한 내용은 공통 이슈 | Telegram 채널에 봇 추가를 참고하세요.

이 노드는 AI 도구로 사용할 수 있습니다

이 노드는 AI 에이전트의 기능을 강화하는 데 사용할 수 있습니다. 이 방식으로 사용하면 많은 파라미터를 자동으로 설정하거나 AI가 제공하는 정보로 설정할 수 있습니다. 자세한 내용은 AI 도구 파라미터 문서를 참조하세요.

AI 도구 호출을 위한 Human-in-the-loop

이 노드는 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • Text: 전송할 텍스트를 입력하세요. 엔티티 파싱 후 최대 4096자입니다.

자세한 내용은 Telegram Bot API sendMessage 문서를 참고하세요.

Send Message 제한

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 형식의 사용자 이름을 입력하세요.
  • 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 트리거의 양식 요소에 설명된 설정으로 커스터마이징할 수 있습니다. 필드를 추가하려면 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 형식의 사용자 이름을 입력하세요.
  • 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 Business 계정

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를 사용하세요.

자세한 내용은 InlineKeyboardMarkupInlineKeyboardButtons를 참고하세요.

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를 참고하세요.