> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 팟캐스트 알림

> 새 팟캐스트 에피소드를 아트워크 및 에피소드 세부 정보와 함께 Discord 서버에 공지하세요.

<Info>
  **Basic**이 필요합니다. 서버당 최대 **10개 팟캐스트**. 공통 규칙은 [알림 작동 방식](/ko/notifications/overview) 참고.
</Info>

## 팟캐스트 추가

이름으로 검색하세요. Vetox가 팟캐스트 디렉토리에서 해당 쇼를 찾아 피드를 저장합니다.

## 설정

| 설정                            | 기본         | 비고                |
| ----------------------------- | ---------- | ----------------- |
| **Discord Channel**           | —          | 필수                |
| **Notify on New Episodes**    | **On**     |                   |
| **Custom Message**            | 없음         | 일반 텍스트, 최대 2,000자 |
| **Mention Role**              | 없음         |                   |
| **Custom Notification Embed** | Podcast 기본 | 보라색               |

## 변수

| 변수                      | 해석되는 값  |
| ----------------------- | ------- |
| `{episode.title}`       | 에피소드 제목 |
| `{episode.url}`         | 에피소드 링크 |
| `{episode.description}` | 에피소드 노트 |
| `{podcast.name}`        | 쇼 이름    |

<Warning>
  **제공되는 세 개 변수는 값을 절대 생성하지 않습니다:**

  | 변수                   | 동작                                                     |
  | -------------------- | ------------------------------------------------------ |
  | `{episode.duration}` | 항상 빈 값 — 에피소드 길이는 피드에서 읽히지 않음                          |
  | `{podcast.author}`   | 항상 빈 값                                                 |
  | `{podcast.artwork}`  | 피드 자체가 채널 수준의 아트워크를 담고 있지 않으면 빈 값; 디렉토리의 아트워크는 사용되지 않음 |

  이들은 변수 드롭다운에 나타나지만 아무 값도 해석하지 않으며, **오직 이들로만 구성된 임베드 필드는 메시지에서 제거됩니다**. 이는 팟캐스트 임베드가 예상보다 적은 필드로 도착하는 가장 흔한 원인입니다.

  이 변수들을 중심으로 임베드를 구성하지 마세요.
</Warning>

<Tip>
  안정적인 팟캐스트 임베드는 `{episode.title}`을 제목으로, `{episode.description}`을 본문으로, `{episode.url}`을 링크로, `{podcast.name}`을 푸터에 사용합니다. 나머지는 신뢰할 수 없습니다.
</Tip>

## 공지되는 것

**5분**마다 확인, 쇼당 **5분 쿨다운**, 디렉토리가 아닌 쇼의 피드를 직접 읽습니다.

[RSS](/ko/notifications/rss)와 동일한 동작: 폴당 상한 없음, 읽을 수 있는 날짜가 있는 항목에 대한 2시간 나이 컷오프, 7일 seen-list. 쇼의 피드에도 동일한 가져오기 제한이 적용됩니다 — 10초 안에 응답해야 하고, 5 MB 미만이어야 하며, 리디렉션은 3회를 넘을 수 없습니다.

<Note>
  쇼를 추가할 때 디렉토리 조회는 실패하지만 피드가 유효하면 팟캐스트는 여전히 추가됩니다 — 하지만 이름 대신 피드 URL로 나열될 수 있습니다. 이름이 이상하다면 제거하고 다시 추가하세요.
</Note>

## 문제 해결

<AccordionGroup>
  <Accordion title="Duration 필드가 절대 나타나지 않아요">
    `{episode.duration}`은 항상 빈 값이며 필드는 제거됩니다. 임베드에서 제외하세요.
  </Accordion>

  <Accordion title="아트워크가 없어요">
    피드 내부의 채널 수준 아트워크만 사용됩니다. 많은 피드가 이를 포함하지 않습니다. 대신 임베드에서 정적 이미지 URL을 사용하세요.
  </Accordion>

  <Accordion title="쇼가 이름 대신 URL로 나열되어 있어요">
    피드는 성공했지만 디렉토리 조회가 실패했습니다. 제거하고 다시 추가하세요.
  </Accordion>

  <Accordion title="아무것도 도착하지 않아요">
    서버 설정의 팟캐스트 토글, 프리미엄, 채널의 Embed Links를 확인하세요.
  </Accordion>
</AccordionGroup>

<Card title="RSS" icon="rss" horizontal href="/ko/notifications/rss">
  더 신뢰할 수 있는 변수를 위해 팟캐스트 피드를 직접 추적하기.
</Card>