콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

n8n 공식 기술 문서 한글판 by 인포그랩

Telegram 노드 메시지 작업#

채팅에서 메시지를 보내고, 편집하고, 삭제하는 작업; 채팅에 파일을 보내는 작업; 채팅에서 메시지를 고정/고정 해제하는 작업을 사용하세요. Telegram 노드 자체에 대한 자세한 내용은 Telegram를 참조하세요.

채널에 봇 추가

이러한 대부분의 작업을 사용하려면 봇을 채널에 추가해야 해당 채널에 메시지를 보낼 수 있습니다. 더 많은 정보는 Common Issues | 텔레그램 채널에 봇 추가하기를 참조하세요.

s

채팅 메시지 삭제#

Bot API deleteMessage 메서드를 사용하여 채팅에서 메시지를 삭제하는 작업입니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택하세요.
  • 리소스: Message를 선택하세요.
  • 작업: 채팅 메시지 삭제를 선택하세요.
  • 채팅 ID: 삭제하려는 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력하세요.
  • 메시지 ID: 삭제하려는 메시지의 고유 식별자를 입력하세요.

Telegram Bot API deleteMessage 문서를 참조하여 더 많은 정보를 확인하세요.

메시지 텍스트 편집#

Bot API editMessageText 메서드를 사용하여 기존 메시지의 텍스트를 편집하는 작업입니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택하세요.
  • 리소스: Message를 선택하세요.
  • 작업: 메시지 텍스트 편집을 선택하세요.
  • 채팅 ID: 남기려는 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력하세요.
  • 메시지 ID: 편집하려는 메시지의 고유 식별자를 입력하세요.
  • 응답 마크업: Inline Keyboard를 사용하여 InlineKeyboardMarkup을 표시할지 여부를 선택하세요. None을 선택하면 표시하지 않습니다. 이는 reply_markup 매개변수를 설정합니다. 더 많은 정보는 InlineKeyboardMarkup 문서를 참조하세요.
  • 텍스트: 메시지를 편집할 텍스트를 입력하세요.

Telegram Bot API editMessageText 문서를 참조하여 더 많은 정보를 확인하세요.

메시지 텍스트 수정 추가 필드#

추가 필드를 사용하여 노드의 동작을 더욱 세분화할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하십시오:

  • 웹페이지 미리보기 비활성화: 이 메시지의 링크에 대해 링크 미리보기를 활성화할지(꺼짐) 또는 비활성화할지(켜짐 선택) 선택합니다. 이는 is_disabled의 link_preview_options 매개변수를 설정합니다. 자세한 내용은 LinkPreviewOptions 문서를 참조하십시오.
  • 구문 분석 모드: 메시지가 HTML(기본값), Markdown (레거시) 또는 MarkdownV2로 구문 분석되어야 하는지 선택합니다. 이는 parse_mode 매개변수를 설정합니다.

채팅 메시지 고정#

이 작업을 사용하여 Bot API pinChatMessage 메서드를 사용하여 채팅에 메시지를 고정할 수 있습니다.

다음 매개변수를 입력하십시오:

  • 연결할 자격 증명: 기존 텔레그램 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 채팅 메시지 고정을 선택합니다.
  • 채팅 ID: 메시지를 고정할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 메시지 ID: 고정할 메시지의 고유 식별자를 입력합니다.

Telegram Bot API pinChatMessage 문서를 참조하여 자세한 내용을 확인하십시오.

채팅 메시지 고정 추가 필드#

추가 필드를 사용하여 노드의 동작을 더욱 세분화할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하십시오:

  • 알림 비활성화: 기본적으로 Telegram은 메시지가 고정되었다는 것을 모든 채팅 회원에게 알립니다. 이러한 알림이 전송되지 않도록 하려면 이 제어를 켭니다. disable_notification 매개변수를 true로 설정합니다.

애니메이션 전송#

이 작업을 사용하여 Bot API sendAnimation 메서드를 사용하여 소리가 없는 GIF 또는 H.264/MPEG-4 AVC 비디오를 최대 50MB 크기로 채팅에 전송합니다.

다음 매개변수를 입력하십시오:

  • 연결할 자격 증명: 기존 텔레그램 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 애니메이션 전송을 선택합니다.
  • 채팅 ID: 애니메이션을 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 이진 파일: 노드 자체에서 이진 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켜면 전송할 파일이 포함된 입력 이진 필드를 입력해야 합니다.
  • 애니메이션: 이진 파일을 사용하지 않는 경우 전송할 애니메이션을 여기에 입력합니다. Telegram 서버에 있는 파일을 전송하려면 file_id를 전달하거나 인터넷에서 파일을 가져오는 HTTP URL을 전송합니다.
  • 답장 마크업: 이 매개변수를 사용하여 더 많은 인터페이스 옵션을 설정합니다. 이러한 옵션 및 사용 방법에 대한 자세한 내용은 답장 마크업 매개변수를 참조하십시오.

Telegram Bot API sendAnimation 문서를 참조하여 자세한 내용을 확인하십시오.

애니메이션 전송 추가 필드#

추가 필드를 사용하여 Telegram의 sendAnimation 메서드에서 선택적 필드를 사용하여 노드의 동작을 더 정제할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하세요:

  • 캡션: 애니메이션에 대한 캡션 텍스트를 입력하세요. 최대 1024자.
  • 알림 끄기: 알림을 조용히 전송할 것인지(켜짐) 또는 표준 알림으로 보낼 것인지(꺼짐) 선택하세요.
  • 지속시간: 애니메이션의 지속시간을 초 단위로 입력하세요.
  • 높이: 애니메이션의 높이를 입력하세요.
  • 파서 모드: 관련 텍스트에 사용할 파서를 입력하세요. 옵션에는 HTML(기본값), Markdown (구버전), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 추가 정보는 Telegram의 형식 옵션을 참조하세요.
  • 메시지 ID에 회신: 메시지가 회신인 경우, 회신하는 메시지의 ID를 입력하세요.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력하세요; 포럼 슈퍼그룹 전용.
  • 썸네일: 전송된 파일의 썸네일을 추가하세요. 파일에 대한 썸네일 생성이 서버 측에서 지원되면 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
    • JPEG 형식
    • 크기가 200KB 미만
    • 너비와 높이가 320px 미만.
  • 너비: 비디오 클립의 너비를 입력하세요.

오디오 전송#

이 작업을 사용하여 오디오 파일을 채팅으로 전송하고 Bot API sendAudio 메서드를 사용하여 음악 플레이어에 표시합니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존 Telegram 자격 증명을 생성하거나 선택하세요.
  • 리소스: 메시지를 선택하세요.
  • 작업: 오디오 전송을 선택하세요.
  • 챗 ID: 오디오를 보내려는 채널의 챗 ID 또는 사용자 이름을 @channelusername 형식으로 입력하세요.
  • 바이너리 파일: 노드 자체에서 바이너리 파일을 전송하려면 이 옵션을 켜세요. 이 매개변수를 켜면 보내고자 하는 파일이 포함된 입력 바이너리 필드를 입력해야 합니다.
  • 오디오: 바이너리 파일을 사용하지 않는 경우 여기에서 보낼 오디오를 입력하세요. Telegram 서버에 존재하는 파일을 보내려면 file_id를 전달하세요(권장) 또는 인터넷에서 파일을 가져오기 위한 HTTP URL을 입력하세요.
  • 회신 마크업: 이 매개변수를 사용하여 더 많은 인터페이스 옵션을 설정하세요. 추가 정보는 회신 마크업 매개변수를 참조하세요.

추가 정보는 Telegram Bot API sendAudio 문서를 참조하세요.

오디오 전송 추가 필드#

추가 필드를 사용하여 Telegram의 sendAudio 메서드에서 선택적 필드를 사용하여 노드의 동작을 더 정제할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하세요:

  • 캡션: 오디오에 대한 캡션 텍스트를 입력하세요. 최대 1024자.
  • 알림 끄기: 알림을 조용히 전송할 것인지(켜짐) 또는 표준 알림으로 보낼 것인지(꺼짐) 선택하세요.
  • 지속시간: 오디오의 지속시간을 초 단위로 입력하세요.
  • 파서 모드: 관련 텍스트에 사용할 파서를 입력하세요. 옵션에는 HTML(기본값), Markdown (구버전), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 추가 정보는 Telegram의 형식 옵션을 참조하세요.
  • 연주자: 연주자의 이름을 입력하세요.
  • 메시지 ID에 회신: 메시지가 회신인 경우, 회신하는 메시지의 ID를 입력하세요.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력하세요; 포럼 슈퍼그룹 전용.
  • 제목: 오디오 트랙의 이름을 입력하세요.
  • 썸네일: 전송된 파일의 썸네일을 추가하세요. 파일에 대한 썸네일 생성이 서버 측에서 지원되면 이 필드를 무시하세요. 썸네일은 다음 사양을 충족해야 합니다:
    • JPEG 형식
    • 크기가 200KB 미만
    • 너비와 높이가 320px 미만.

채팅 액션 전송#

봇 측에서 무언가가 발생하고 있음을 사용자에게 알릴 필요가 있을 때 이 작업을 사용하십시오. 상태는 Bot API sendChatAction 메서드를 사용하여 5초 이하로 설정됩니다.

이 매개변수를 입력하십시오:

  • 연결할 자격 증명: 기존 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 채팅 액션 전송을 선택합니다.
  • 채팅 ID: 채팅 액션을 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 액션: 봇이 수행하고 있다고 방송할 액션을 선택합니다. 여기에는 위치 찾기, 타이핑, 오디오 또는 비디오 녹화, 파일 업로드 등의 옵션이 포함됩니다.

자세한 내용은 Telegram의 Bot API sendChatAction 문서를 참조하십시오.

문서 전송#

봇 API sendDocument 메서드를 사용하여 채팅에 문서를 전송하는 데 이 작업을 사용하십시오.

이 매개변수를 입력하십시오:

  • 연결할 자격 증명: 기존 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 문서 전송을 선택합니다.
  • 채팅 ID: 문서를 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 이진 파일: 노드 자체에서 이진 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켤 경우, 전송할 파일이 포함된 입력 이진 필드를 입력해야 합니다.
  • 문서: 이진 파일을 사용하지 않는 경우, 여기에 전송할 문서를 입력합니다. Telegram 서버에 존재하는 파일을 전송하려면 file_id를 전달하거나 Telegram이 인터넷에서 파일을 가져올 수 있도록 HTTP URL을 전달하십시오.
  • 답장 마크업: 이 매개변수를 사용하여 더 많은 인터페이스 옵션을 설정합니다. 이러한 옵션 및 사용 방법에 대한 자세한 내용은 답장 마크업 매개변수를 참조하십시오.

자세한 내용은 Telegram의 Bot API sendDocument 문서를 참조하십시오.

문서 추가 필드#

추가 필드를 사용하여 Telegram의 sendDocument 메서드에서 선택적 필드를 사용하여 노드의 동작을 추가로 조정할 수 있습니다. 필드 추가를 선택하여 다음 항목 중 하나를 추가하십시오:

  • 캡션: 파일에 대한 캡션 텍스트를 입력하십시오. 최대 1024자.
  • 알림 비활성화: 알림을 조용히 전송할 것인지(켜기) 또는 표준 알림으로 전송할 것인지(끄기) 선택합니다.
  • 구문 분석 모드: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML(기본값), Markdown (Legacy), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 자세한 내용은 형식 옵션을 참조하십시오.
  • 답장할 메시지 ID: 메시지가 답장인 경우, 답장할 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력하십시오. 포럼 슈퍼 그룹에만 해당됩니다.
  • 썸네일: 전송된 파일의 썸네일을 추가합니다. 서버 측에서 파일의 썸네일 생성이 지원되는 경우 이 필드는 무시하십시오. 썸네일은 다음 사양을 충족해야 합니다:
    • JPEG 형식
    • 크기 200 KB 미만
    • 너비와 높이 320px 미만.

위치 전송#

이 작업을 사용하여 Bot API sendLocation 메서드를 사용하여 채팅에 지리적 위치를 전송합니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택하세요.
  • 리소스: 메시지를 선택하세요.
  • 작업: 위치 전송을 선택하세요.
  • 채팅 ID: 위치를 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력하세요.
  • 위도: 위치의 위도를 입력하세요.
  • 경도: 위치의 경도를 입력하세요.
  • 답장 마크업: 이 매개변수를 사용하여 인터페이스 옵션을 더 설정하세요. 이러한 옵션 및 사용 방법에 대한 자세한 내용은 답장 마크업 매개변수를 참조하세요.

더 많은 정보는 Telegram의 Bot API sendLocation 문서를 참조하세요.

위치 전송 추가 필드#

추가 필드를 사용하여 Telegram의 sendLocation 메서드에서 선택적 필드를 사용하여 노드의 동작을 더 세밀하게 조정하세요. 필드 추가를 선택하여 다음 항목을 추가하세요:

  • 알림 비활성화: 알림을 조용히(활성화) 보내거나 표준 알림(비활성화)으로 보낼지 선택하세요.
  • 답장할 메시지 ID: 메시지가 답장인 경우, 답장할 메시지의 ID를 입력하세요.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력하세요. 포럼 슈퍼그룹 전용입니다.

미디어 그룹 전송#

이 작업을 사용하여 Bot API sendMediaGroup 메서드를 사용하여 사진 및/또는 비디오 그룹을 전송합니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택하세요.
  • 리소스: 메시지를 선택하세요.
  • 작업: 미디어 그룹 전송을 선택하세요.
  • 채팅 ID: 미디어 그룹을 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력하세요.
  • 미디어: 미디어 추가를 사용하여 미디어 그룹에 다양한 미디어 유형을 추가하세요. 각 미디어에 대해 다음을 선택하세요:
    • 유형: 이 미디어의 종류입니다. 사진과 비디오 중에서 선택하세요.
    • 미디어 파일: 전송할 미디어 파일을 입력하세요. Telegram 서버에 있는 파일을 보내려면 file_id를 전달하거나, 인터넷에서 파일을 가져오기 위한 HTTP URL을 입력하세요(추천합니다).
    • 추가 필드: 각 미디어 파일에 대해 다음 필드를 추가할 수 있습니다:
      • 캡션: 파일에 대한 캡션 텍스트를 입력하세요. 최대 1024자입니다.
      • 파서 모드: 관련 텍스트에 사용할 파서를 입력하세요. 선택 사항에는 HTML(기본값), Markdown (Legacy), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 자세한 내용은 형식 옵션을 참조하세요.

더 많은 정보는 Telegram의 Bot API sendMediaGroup 문서를 참조하세요.

미디어 그룹 전송 추가 필드#

추가 필드를 사용하여 Telegram의 sendMediaGroup 메서드에서 선택적 필드를 사용하여 노드의 동작을 더욱 세밀하게 조정할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가합니다:

  • 알림 비활성화: 알림을 조용하게(켜짐) 전송할지 표준 알림(꺼짐)으로 전송할지 선택합니다.
  • 메시지 회신 ID: 메시지가 회신인 경우 회신할 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력합니다; 포럼 수퍼그룹 전용입니다.

메시지 전송#

이 작업을 사용하여 Bot API sendMessage 메서드를 사용하여 채팅에 메시지를 전송합니다.

다음 매개변수를 입력합니다:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 메시지 전송을 선택합니다.
  • 채팅 ID: 메시지를 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 텍스트: 최대 4096자의 텍스트를 입력합니다(엔터티 파싱 후).

자세한 정보는 Telegram의 Bot API sendMessage 문서를 참조하세요.

/// 경고 | 메시지 전송 한계 Telegram은 초당 전송할 수 있는 메시지 수를 30개로 제한합니다. 이 한계에 도달할 것으로 예상되면 초당 30개 이상의 메시지 전송에 대한 제안된 해결 방법을 참조하세요. ///

메시지 전송 추가 필드#

추가 필드를 사용하여 Telegram의 sendMessage 메서드에서 선택적 필드를 사용하여 노드의 동작을 더욱 세밀하게 조정할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가합니다:

  • n8n 기여 포함: 메시지 끝에 이 메시지는 n8n에 의해 자동으로 전송되었습니다라는 문구를 포함할지(켜짐, 기본값) 포함하지 않을지(꺼짐) 선택합니다.
  • 알림 비활성화: 알림을 조용하게(켜짐) 전송할지 표준 알림(꺼짐)으로 전송할지 선택합니다.
  • 웹페이지 미리보기 비활성화: 이 메시지의 링크에 대한 링크 미리보기를 활성화할지(꺼짐) 비활성화할지(켜짐) 선택합니다. 이는 is_disabled에 대한 link_preview_options 매개변수를 설정합니다. 자세한 정보는 링크 미리 보기 옵션 문서를 참조하세요.
  • 파싱 모드: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML(기본값), Markdown (레거시), MarkdownV2가 포함됩니다. 이 옵션에 대한 자세한 정보는 Telegram의 형식 옵션을 참조하세요.
  • 메시지 회신 ID: 메시지가 회신인 경우 회신할 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력합니다; 포럼 수퍼그룹 전용입니다.

사진 보내기#

이 작업을 사용하여 Bot API sendPhoto 메서드를 사용하여 채팅에 사진을 보냅니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 사진 보내기를 선택합니다.
  • 채팅 ID: 사진을 보내려는 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 바이너리 파일: 노드 자체에서 바이너리 파일을 보내려면 이 옵션을 활성화합니다. 이 매개변수를 활성화하면 보내고자 하는 파일이 포함된 입력 바이너리 필드를 입력해야 합니다.
  • 사진: 바이너리 파일을 사용하지 않는 경우, 여기에서 보낼 사진을 입력합니다. Telegram 서버에 존재하는 파일을 보내기 위해 file_id를 전달하거나, Telegram이 인터넷에서 파일을 가져올 수 있도록 HTTP URL을 입력합니다.
  • 응답 마크업: 이 매개변수를 사용하여 인터페이스 옵션을 추가로 설정합니다. 이러한 옵션 및 사용 방법에 대한 자세한 정보는 응답 마크업 매개변수를 참조하세요.

더 많은 정보는 Telegram의 Bot API sendPhoto 문서를 참조하세요.

사진 보내기 추가 필드#

추가 필드를 사용하여 Telegram의 sendPhoto 메서드에서 선택적 필드를 사용하여 노드의 동작을 더욱 세밀하게 조정합니다. 필드 추가를 선택하여 다음 중 하나를 추가합니다:

  • 캡션: 파일에 대한 캡션 텍스트를 입력합니다. 최대 1024자.
  • 알림 비활성화: 알림을 조용히(켜짐) 또는 일반 알림(꺼짐)으로 보낼지 선택합니다.
  • 파서 모드: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML (기본), Markdown (레거시), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 자세한 정보는 Telegram의 형식 옵션을 참조하세요.
  • 메시지 ID에 대한 응답: 메시지가 응답인 경우, 응답 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)용 고유 식별자를 입력합니다; 포럼 슈퍼 그룹에만 해당됩니다.

스티커 보내기#

이 메서드를 사용하여 Bot API sendSticker 메서드를 사용하여 정적 .WEBP, 애니메이션 .TGS 또는 비디오 .WEBM 스티커를 보냅니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존의 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 스티커 보내기를 선택합니다.
  • 채팅 ID: 스티커를 보내려는 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 바이너리 파일: 노드 자체에서 바이너리 파일을 보내려면 이 옵션을 활성화합니다. 이 매개변수를 활성화하면 보내고자 하는 파일이 포함된 입력 바이너리 필드를 입력해야 합니다.
  • 스티커: 바이너리 파일을 사용하지 않는 경우, 여기에서 보낼 스티커를 입력합니다. Telegram 서버에 존재하는 파일을 보내기 위해 file_id를 전달하거나, Telegram이 인터넷에서 파일을 가져올 수 있도록 HTTP URL을 입력합니다.
  • 응답 마크업: 이 매개변수를 사용하여 인터페이스 옵션을 추가로 설정합니다. 이러한 옵션 및 사용 방법에 대한 자세한 정보는 응답 마크업 매개변수를 참조하세요.

더 많은 정보는 Telegram의 Bot API sendSticker 문서를 참조하세요.

스티커 추가 필드#

추가 필드를 사용하여 Telegram의 sendSticker 메서드에서 선택적 필드를 사용하여 노드의 동작을 추가로 세밀하게 조정할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하십시오:

  • 알림 끄기: 알림을 조용하게(켜짐) 전송할지, 표준 알림(꺼짐)으로 전송할지를 선택합니다.
  • 답장 메시지 ID: 메시지가 답장인 경우, 답장하는 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력합니다; 포럼 슈퍼그룹 전용입니다.

비디오 전송#

이 작업을 사용하여 Bot API sendVideo 메서드를 사용하여 채팅에 비디오를 전송합니다.

다음 매개변수를 입력하십시오:

  • 연결할 자격 증명: 기존 Telegram 자격 증명을 생성하거나 선택합니다.
  • 리소스: 메시지를 선택합니다.
  • 작업: 비디오 전송을 선택합니다.
  • 채팅 ID: 비디오를 전송할 채널의 채팅 ID 또는 사용자 이름을 @channelusername 형식으로 입력합니다.
  • 이진 파일: 노드 자체에서 이진 파일을 전송하려면 이 옵션을 켭니다. 이 매개변수를 켜면 전송할 파일이 포함된 입력 이진 필드를 입력해야 합니다.
  • 비디오: 이진 파일을 사용하지 않는 경우 여기에서 전송할 비디오를 입력합니다. Telegram 서버에 존재하는 파일을 전송하려면 file_id를 전달하거나 인터넷에서 파일을 가져오기 위해 HTTP URL을 입력하십시오.
  • 답장 마크업: 이 매개변수를 사용하여 더 많은 인터페이스 옵션을 설정합니다. 이러한 옵션과 사용하는 방법에 대한 자세한 정보는 답장 마크업 매개변수를 참조하십시오.

자세한 정보는 Telegram의 Bot API sendVideo 문서를 참조하십시오.

비디오 추가 필드#

추가 필드를 사용하여 Telegram의 sendVideo 메서드에서 선택적 필드를 사용하여 노드의 동작을 추가로 세밀하게 조정할 수 있습니다. 필드 추가를 선택하여 다음 중 하나를 추가하십시오:

  • 캡션: 비디오에 대한 캡션 텍스트를 입력합니다. 최대 1024자.
  • 알림 끄기: 알림을 조용하게(켜짐) 전송할지, 표준 알림(꺼짐)으로 전송할지를 선택합니다.
  • 지속 시간: 비디오의 지속 시간을 초 단위로 입력합니다.
  • 높이: 비디오의 높이를 입력합니다.
  • 파서 모드: 관련 텍스트에 사용할 파서를 입력합니다. 옵션에는 HTML(기본값), Markdown (Legacy), MarkdownV2가 포함됩니다. 이러한 옵션에 대한 자세한 정보는 Telegram의 형식 옵션을 참조하십시오.
  • 답장 메시지 ID: 메시지가 답장인 경우, 답장하는 메시지의 ID를 입력합니다.
  • 메시지 스레드 ID: 포럼의 대상 메시지 스레드(주제)에 대한 고유 식별자를 입력합니다; 포럼 슈퍼그룹 전용입니다.
  • 썸네일: 전송된 파일의 썸네일을 추가합니다. 파일에 대한 썸네일 생성이 서버 측에서 지원되는 경우 이 필드는 무시하십시오. 썸네일은 다음 사양을 충족해야 합니다:
    • JPEG 형식
    • 크기 200 KB 미만
    • 너비와 높이가 320px 미만.
  • 너비: 비디오의 너비를 입력합니다.

채팅 메시지 고정 해제#

이 작업을 사용하여 Bot API unpinChatMessage 메서드를 사용하여 채팅에서 메시지의 고정을 해제합니다.

다음 매개변수를 입력하세요:

  • 연결할 자격 증명: 기존 Telegram credential을 생성하거나 선택하십시오.
  • 리소스: Message를 선택하십시오.
  • 작업: Pin Chat Message를 선택하십시오.
  • 채팅 ID: 메시지의 고정을 해제할 채널의 챗 ID 또는 사용자 이름을 @channelusername 형식으로 입력하십시오.
  • 메시지 ID: 고정을 해제할 메시지의 고유 식별자를 입력하십시오.

더 많은 정보는 Telegram Bot API unpinChatMessage 문서를 참조하십시오.

답장 마크업 매개변수#

대부분의 메시지 전송 작업(예: 애니메이션 전송, 오디오 전송)에서는 답장 마크업 매개변수를 사용하여 더 많은 인터페이스 옵션을 설정합니다:

  • 강제 답장: Telegram 클라이언트는 사용자가 봇의 메시지를 선택하고 답장을 클릭한 것처럼 행동하여 자동으로 사용자에게 답장 인터페이스를 표시합니다. 이 옵션에 대한 자세한 내용은 강제 답장 매개변수를 참조하십시오.
  • 인라인 키보드: 메시지 옆에 인라인 키보드를 표시합니다. 이 옵션에 대한 자세한 내용은 인라인 키보드 매개변수를 참조하십시오.
  • 답장 키보드: 답장 옵션이 있는 사용자 정의 키보드를 표시합니다. 이 옵션에 대한 자세한 내용은 답장 키보드 매개변수를 참조하십시오.
  • 답장 키보드 제거: Telegram 클라이언트가 현재의 사용자 정의 키보드를 제거하고 기본 문자 키보드를 표시합니다. 이 옵션에 대한 자세한 내용은 답장 키보드 매개변수를 참조하십시오.

Telegram Business 계정

Telegram은 Telegram Business 계정을 대신하여 전송된 메시지 및 채널에서 다음 옵션을 제한합니다:

  • 강제 답장
  • 답장 키보드
  • 답장 키보드 제거

강제 답장 매개변수#

강제 답장은 개인 정보 보호 모드를 희생하지 않고 사용자 친화적인 단계별 인터페이스를 생성하려는 경우 유용합니다.

답장 마크업 > 강제 답장을 선택하면 다음 강제 답장 매개변수 중에서 선택합니다:

  • 강제 답장: 위에 설명된 바와 같이 사용자에게 답장 인터페이스를 표시하도록 활성화합니다.
  • 선택적: 다음 사용자만 강제 답장을 원하시는 경우 활성화합니다:
    • 메시지 텍스트에서 @mentioned된 사용자.
    • 이 애니메이션 전송 메시지가 메시지에 대한 답변인 경우 원래 메시지의 발신자.

더 많은 정보는 ForceReply를 참조하십시오.

인라인 키보드 매개변수#

답장 마크업 > 인라인 키보드를 선택하면 버튼 추가 옵션을 사용하여 표시할 인라인 키보드 버튼을 정의합니다. 키보드에 더 많은 행을 추가하려면 키보드 행 추가를 사용하십시오.

더 많은 정보는 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 제거 매개변수#

Reply Markup > Reply Keyboard Remove를 선택하면, 다음 Reply Keyboard Remove 매개변수 중에서 선택합니다:

  • Remove Keyboard: Telegram 클라이언트에 사용자 정의 키보드를 제거하도록 요청할지 (켜짐) 또는 유지할지 (꺼짐) 선택합니다.
  • Selective: 다음 사용자에 대해서만 키보드를 제거하려면 이 옵션을 켭니다:
    • 메시지 텍스트에 @mentioned된 사용자.
    • 이 Send Animation 메시지가 메시지에 대한 답변인 경우 원래 메시지의 발신자.

자세한 내용은 ReplyKeyboardRemove를 참조하세요.

인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!