Telegram 문서 전송¶

Telegram 문서 스킬은 Telegram 채팅에 파일을 전송합니다. 단일 또는 다중 파일 전송을 지원합니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 Telegram 문서를 선택합니다.

2. Telegram Bot 인증 연결¶

인증 탭에서 Telegram Bot 인증 정보를 선택합니다. (Telegram 메시지와 동일한 인증 사용 가능)

3. 파라미터 입력¶

설정 탭에서 채팅 ID, 파일 경로(또는 URL) 등을 입력합니다.

파라미터¶

파라미터	필수	설명
chat_id	O	채팅 ID
document	O	파일 URL, file_id, 또는 base64 데이터 (리스트 가능)
caption		파일 설명 텍스트
filename		커스텀 파일명 (리스트 가능)

인증 정보¶

Telegram Bot 인증이 필요합니다.

항목	설명
bot_token	BotFather에서 발급받은 봇 토큰

출력¶

단일 파일¶

{
  "success": true,
  "data": {
    "message_id": 12345,
    "chat_id": "123456789",
    "document": {}
  }
}

다중 파일¶

{
  "success": true,
  "data": {
    "message_ids": [12345, 12346],
    "chat_id": "123456789",
    "document_count": 2
  }
}

사용 예시¶

보고서 파일 전송¶

파라미터	값
chat_id	`{{ $('trigger').data_content.chat_id }}`
document	`{{ $('skill_file_write').data_content.result.file_path }}`
caption	`일일 매출 보고서`

파일 제한¶

Telegram Bot API 제한¶

항목	제한
최대 파일 크기	50 MB (봇 업로드)
캡션 길이	최대 1,024자

URL 전송 제한¶

Telegram Bot API의 sendDocument는 URL 모드에서 PDF, ZIP, GIF 파일만 지원합니다. 그 외 파일 타입(.xlsx, .csv, .docx, .png 등)은 URL을 전달해도 failed to get HTTP URL content 에러가 발생합니다.

W5W 플랫폼에서는 이 제한을 자동으로 처리합니다:

URL인 경우: 서버에서 파일을 다운로드 후 multipart/form-data로 직접 업로드 (모든 파일 타입 지원)
file_id인 경우: Telegram 내부 참조로 직접 전송

따라서 이전 노드의 storage:// 참조나 외부 URL을 그대로 사용하면 됩니다.

참고¶

storage:// S3 참조는 presigned URL로 자동 변환되며, 서버에서 다운로드 후 Telegram에 업로드합니다.
base64 데이터 전송 시 파일 타입을 자동 감지합니다 (PDF, PNG, JPG, GIF, ZIP).
다중 파일 전송 시 document와 filename을 리스트로 전달합니다.