# Telegram 채널 피드

> 봇 없이 공개 Telegram 채널의 새 게시물을 구조화된 게시물과 텍스트로 읽습니다. 일정에 따라 다시 쓰기, 요약, 재게시에 사용하세요.

Source: https://nodaro.ai/ko/docs/nodes/automate/telegram-channel-feed

**Telegram 채널 피드** 노드는 공개 Telegram 채널의 새 게시물을 읽습니다. 게시물은 텍스트, 링크, 날짜, 미디어가 담긴 구조화된 게시물과 하나의 텍스트로 함께 반환됩니다. 봇도 로그인도 필요 없으며, 실행할 때마다 지난 실행 이후의 게시물만 반환합니다. [일정 트리거](https://nodaro.ai/docs/nodes/automate/schedule-trigger)와 함께 써서 채널을 지켜본 다음, [텍스트 생성 - 모든 LLM](https://nodaro.ai/docs/nodes/automate/prompt) 노드로 게시물을 다시 쓰거나 요약하고 결과를 게시하세요.

- Found in: Automate › Get Content
- Output: text
- API type: `telegram-channel-feed`

## 사용 시기
- 채널을 지켜보고 새 게시물을 내 말투로 다시 씁니다.
- 여러 채널이 올린 내용을 매일 요약본으로 만듭니다.
- 새 게시물을 [Telegram 게시물](https://nodaro.ai/docs/nodes/publish/telegram-post)로 내 채널에, 또는 [SNS에 게시](https://nodaro.ai/docs/nodes/publish/publish-to-social)로 다른 네트워크에 재게시합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab을 누르고 **자동화 › 콘텐츠 가져오기 › Telegram 채널 피드**를 선택하세요.

### 채널 지정
**채널**에 공개 채널을 `@name`, `t.me/name` 또는 이름만 입력하세요.

### 실행
노드가 위치를 기록할 수 있도록 워크플로를 저장하세요. **실행**을 클릭하세요. 최신 게시물이 **실행당 최대 게시물 수**까지 노드에 표시됩니다.

### 게시물 연결 후 워크플로 예약
**게시물** 출력을 [텍스트 생성 - 모든 LLM](https://nodaro.ai/docs/nodes/automate/prompt) 노드의 **프롬프트** 입력에 연결하고, 게시물이 요청이 되도록 **사용자 프롬프트**는 비워 두세요. 작업 내용은 <strong>지시 사항(시스템 프롬프트)</strong>에 쓰세요. 일정에 따라 채널을 확인하려면 [일정 트리거](https://nodaro.ai/docs/nodes/automate/schedule-trigger)를 추가하세요.

Workflow: 일정 트리거가 매시간 워크플로를 실행합니다. 피드가 새 게시물을 반환하고, 텍스트 생성 - 모든 LLM 노드가 다시 쓰고, Telegram 게시물이 결과를 게시합니다.

- Telegram 채널 피드 → 텍스트 생성 - 모든 LLM (프롬프트)
- 텍스트 생성 - 모든 LLM → Telegram 게시물

## 설정
| 설정 | 기능 |
| --- | --- |
| **채널** | 읽을 공개 채널입니다. `@name`, `t.me/name` 또는 이름만 입력합니다. 필수입니다. |
| **실행당 최대 게시물 수** | 실행 한 번이 반환하는 새 게시물의 최대 개수로, 1~30입니다. 기본값은 5입니다. |
| **위치** | 피드의 현재 위치입니다. 마지막으로 반환한 게시물과 그 시각, 또는 **아직 시작하지 않았습니다**가 표시됩니다. 워크플로를 저장하면 나타납니다. |
| **위치 초기화** | 확인한 뒤 위치를 지웁니다. 다음 실행은 최신 게시물을 다시 읽습니다. |
| **최근 5개 다시 가져오기** | 위치를 옮기지 않고 최신 게시물을 다시 읽어, 채널에 무엇이 있는지 확인합니다. 개수는 **실행당 최대 게시물 수**를 따르며 최대 20개입니다. 가져오기는 실행과 같이 청구됩니다. |

## 출력
| 출력 | 보내는 것 | 하는 일 |
| --- | --- | --- |
| **게시물** | 텍스트 | 새 게시물의 텍스트를 하나의 텍스트로 합친 것이며, 두 게시물 사이에는 `---` 줄이 들어갑니다. 텍스트 생성 - 모든 LLM 노드나 텍스트를 받는 다른 노드에 연결하세요. |
| **JSON** | 게시물 목록 | 새 게시물을 오래된 순서로 담은 것으로, 게시물마다 객체 하나입니다. |

**JSON**에서 나가는 연결을 **개별** 모드로 두면 다음 노드가 게시물마다 한 번씩 실행됩니다. [필드 추출](https://nodaro.ai/docs/nodes/automate/extract-field)과 [목록](https://nodaro.ai/docs/nodes/automate/list)은 게시물을 바로 읽습니다.

**JSON**의 각 게시물에는 다음 필드가 있습니다.

| 필드 | 담긴 내용 |
| --- | --- |
| `id` | 채널 안에서의 게시물 번호입니다. |
| `channel` | `@`를 뺀 채널 이름입니다. |
| `postUrl` | 게시물 링크, `https://t.me/<channel>/<id>`입니다. |
| `text` | 게시물의 텍스트입니다. 답글에 인용된 텍스트는 포함되지 않습니다. |
| `date` | 게시물이 게시된 시각으로, ISO 타임스탬프입니다. |
| `forwardedFrom` | 게시물이 전달된 것일 때의 `{ name, url }`입니다. `url`은 없을 수 있습니다. |
| `media` | 게시물의 모든 사진과 동영상으로, `{ type: "photo", url }` 또는 `{ type: "video", url, posterUrl }` 형식입니다. 앨범에는 여러 개가 있습니다. 동영상의 `url`은 미리 보기 페이지에 파일이 포함된 경우에만 있습니다. |
| `imageUrl` | 첫 번째 이미지입니다. 첫 번째 사진, 없으면 동영상의 포스터입니다. 이미지 하나를 받는 노드에 사용하세요. |
| `views` | 페이지에 표시된 조회수로, 예를 들어 `1.52M`입니다. |

## 새 게시물을 찾는 방법
노드는 `t.me/s/` 뒤에 채널 이름이 붙은 채널의 웹 미리 보기 페이지를 읽습니다.

- **채널별 위치.** 노드는 위치, 즉 마지막으로 반환한 게시물을 기록합니다. 위치는 저장된 워크플로의 노드별, 채널별로 저장됩니다. 새 채널은 처음부터 시작하고, 이전 채널로 돌아가면 그 채널의 위치에서 다시 시작합니다.
- **첫 실행.** 첫 실행, 또는 **위치 초기화** 후 첫 실행은 최신 게시물을 **실행당 최대 게시물 수**까지 반환합니다. 그다음 위치가 최신 게시물로 옮겨지며, 그보다 오래된 게시물은 읽지 않습니다.
- **이후의 모든 실행.** 실행마다 위치 뒤의 가장 오래된 게시물부터 **실행당 최대 게시물 수**까지 반환하고, 위치를 그중 마지막 게시물로 옮깁니다. 일정이 읽는 속도보다 게시물이 빨리 올라와도 실행마다 다음 묶음을 읽으므로, 건너뛰는 게시물이 없습니다.
- **읽을 내용이 없는 게시물.** 투표, 음성 메시지, 캡션 없는 문서는 건너뛰며, 위치는 그 뒤로 옮겨집니다.
- **위치는 게시물을 읽을 때 옮겨집니다.** 같은 실행의 뒤쪽 노드가 실패해도, 다음 실행은 그 묶음을 다시 반환하지 않습니다. **최근 5개 다시 가져오기**로 다시 볼 수 있습니다.
- **새 게시물 없음.** 실행은 게시물을 반환하지 않고 완료되며 청구되지 않습니다. 피드 뒤에서 그 텍스트를 처리할 노드는 건너뜁니다.
- **위치를 옮기는 실행.** 일정에 따른 실행, 게시한 앱의 실행, 내 **실행**은 같은 위치를 함께 씁니다. 다른 사람이 편집기에서 워크플로를 실행하면, 피드는 위치를 옮기지 않고 채널을 읽습니다.

## 크레딧
새 게시물을 하나 이상 반환한 실행마다 11크레딧이 듭니다. 새 게시물을 찾지 못한 실행은 무료입니다. **최근 5개 다시 가져오기**는 실행과 같이 청구됩니다. 비공개 채널에서의 실행처럼 실패한 실행은 환불됩니다.

일정에 따라 실행되는 피드는 자주 실행되므로 일정의 비용을 확인하세요. 15분마다는 청구되는 실행이 하루 최대 96번, 즉 최대 1,056크레딧입니다. 매시간은 청구되는 실행이 하루 최대 24번, 즉 최대 264크레딧입니다.

## 제한
- **공개 채널만.** 채널이 공개되어 있고 웹 미리 보기가 켜져 있어야 하며, 대부분의 공개 채널은 그렇습니다. 비공개 채널이나 미리 보기를 끈 채널은 분명한 오류와 함께 실행이 실패합니다.
- **실행당 약 40개의 게시물.** 실행 한 번은 미리 보기 페이지를 최대 두 쪽, 약 40개의 게시물까지 읽습니다. 쌓인 게시물이 많으면 나머지는 다음 실행에서 읽습니다.
- **미디어 링크는 만료됩니다.** 사진과 동영상 링크는 Telegram에서 제공되며 며칠 안에 작동하지 않습니다. 이미지를 보관하려면 링크를 저장하지 말고, 같은 실행 안에서 업로드 노드나 생성 노드 등에 넘기세요.

## 팁
- **일정을 채널에 맞추세요.** 하루에 두 번 게시하는 채널은 5분마다 확인할 필요가 없습니다.
- **텍스트가 무엇인지 모델에 알려 주세요.** 텍스트 생성 - 모든 LLM 노드의 지시 사항에 입력이 `---`로 구분된 Telegram 게시물 묶음이라고 쓰세요.
- **대신 내 봇에 반응하세요.** 누군가 내 봇에 메시지를 보낼 때 워크플로를 시작하려면 [Telegram 트리거](https://nodaro.ai/docs/nodes/automate/telegram-trigger)를 사용하세요.

## 자주 묻는 질문

### Telegram 채널 피드 노드에 봇이나 로그인이 필요한가요?

아니요. 채널의 공개 웹 미리 보기, 즉 t.me/s/ 뒤에 채널 이름이 붙은 페이지를 읽습니다. 웹 미리 보기가 켜져 있는 공개 채널이면 모두 사용할 수 있습니다.

### 비공개 채널도 읽을 수 있나요?

아니요. 비공개 채널과 웹 미리 보기를 끈 공개 채널은 읽을 수 없습니다. 실행은 분명한 오류와 함께 실패하며 크레딧은 환불됩니다.

### 노드가 같은 게시물을 두 번 보내나요?

아니요. 노드는 위치, 즉 마지막으로 반환한 게시물을 기록하며, 실행할 때마다 그 뒤의 게시물만 반환합니다. 게시물이 쌓이면 실행마다 다음 묶음을 읽으므로, 일정에 따라 실행되는 피드는 모든 게시물을 한 번씩 읽고 건너뛰지 않습니다.

### Telegram 채널 피드에는 비용이 얼마나 드나요?

새 게시물을 하나 이상 반환한 실행마다 11크레딧이 듭니다. 새 게시물을 찾지 못한 실행은 무료입니다. 15분마다 확인하는 일정은 하루에 최대 96번 청구되며, 1,056크레딧이 듭니다.

### Telegram 채널 피드는 사진과 동영상도 반환하나요?

네. JSON 출력에는 각 게시물의 사진과 동영상이 링크와 함께 들어 있고, 첫 번째 이미지는 imageUrl에 들어 있습니다. 링크는 Telegram에서 제공되며 며칠 안에 만료되므로, 이미지는 같은 실행 안에서 다음 노드로 넘기세요.