Skip to content

Telegram 채널 플러그인

Telegram 채널 플러그인은 Telegram Bot API를 통해 알림 메시지를 chat으로 전송하는 alert_deliver 플러그인입니다. Core가 만든 rendered message를 받아 transport 형식으로 전달합니다.

특징

  • bot token과 chat id 기반 전송을 지원합니다.
  • plain, HTML, MarkdownV2 parse mode를 선택할 수 있습니다.
  • disable notification, protected content, timeout/retry/backoff 설정을 제공합니다.
  • health check에서 bot token 검증과 test chat message 전송을 구분합니다.

등록 전 확인

  • BotFather에서 발급한 bot token과 대상 chat id를 준비합니다.
  • group/supergroup에서는 bot이 메시지를 보낼 권한을 가져야 합니다.
  • formatting mode를 사용할 경우 escaping 규칙을 확인합니다.

운영 팁

  • bot token은 민감 정보이며 health/action 응답에 노출하지 않습니다.
  • 기본은 Core-rendered plain text를 사용하는 것이 가장 안전합니다.
  • Telegram에는 universal idempotency key가 없으므로 중복 조사 기준은 Core delivery session입니다.