Repolode
laravel-notification-channels

laravel-notification-channels/telegram

Telegram Bot API로 알림을 전송하는 Telegram 채널을 추가하는 Laravel 패키지입니다.

스타
1,120
포크
173
열린 이슈
0
마지막 커밋
2개월 전

어떤 프로젝트인가요?

이 패키지를 사용하면 Laravel 애플리케이션에서 Telegram Bot API를 통해 Telegram 사용자, 그룹, 채널로 알림을 보낼 수 있습니다. 알림의 via() 메서드에서 채널을 반환하고, fluent 방식의 TelegramMessage, TelegramFile, TelegramPoll 등의 클래스로 메시지를 구성하면 됩니다.

일반 텍스트 외에도 키보드와 인라인 버튼, 사진, 문서, 오디오, 비디오, 스티커, 위치, 장소, 연락처, 주사위, 투표, 미디어 그룹을 지원합니다. 파일은 URL, 로컬 경로, Telegram 파일 ID 또는 원본 콘텐츠로 전달할 수 있습니다. 채팅 ID를 조회하는 TelegramUpdates 헬퍼, notifiable 모델의 라우팅 훅, NotificationFailed 이벤트 또는 onError 콜백을 통한 오류 처리 기능도 제공합니다. 요청은 프록시나 자체 호스팅 Bot API 서버를 거칠 수 있습니다.

핵심 기능

  • 01텍스트, 파일, 투표, 주사위, 위치, 연락처, 미디어 그룹을 위한 fluent 빌더
  • 02인라인 버튼, 답장 키보드, Markdown/HTML 서식
  • 03로컬 파일, 원격 파일, 파일 ID, 원본 콘텐츠를 첨부 파일로 지원
  • 04업데이트를 가져와 채팅 ID를 찾는 헬퍼
  • 05NotificationFailed 이벤트 또는 onError 콜백을 통한 실패 처리
  • 06프록시 및 자체 호스팅 Bot API 서버 지원

활용 사례

  • Laravel 앱에서 고객의 Telegram 계정으로 주문 또는 청구서 알림 전송
  • 서버 또는 모니터링 알림을 팀 Telegram 그룹에 게시
  • 애플리케이션 이벤트를 바탕으로 투표나 퀴즈 진행
  • Telegram의 전송 속도 제한을 준수하면서 여러 구독자에게 공지 전송

빠른 시작

  1. 1

    Composer로 패키지를 설치합니다

    composer require laravel-notification-channels/telegram
  2. 2

    @BotFather에서 봇을 만들고 config/services.php에서 TELEGRAM_BOT_TOKEN을 설정합니다

  3. 3

    알림의 via() 메서드에서 'telegram'을 반환하고 toTelegram()을 정의합니다

사용 전 알아둘 점

  • Telegram 봇 토큰과 채팅 ID가 필요하며, 사용자가 먼저 봇에 메시지를 보내야 합니다.

토픽

#laravel#php#telegram#telegram-bot#notifications#bot-api#hacktoberfest#laravel-13#laravel-notification-channels#laravel-notifications

자주 묻는 질문

telegram은(는) 무엇인가요?
Telegram Bot API로 알림을 전송하는 Telegram 채널을 추가하는 Laravel 패키지입니다. 이 패키지를 사용하면 Laravel 애플리케이션에서 Telegram Bot API를 통해 Telegram 사용자, 그룹, 채널로 알림을 보낼 수 있습니다. 알림의 via() 메서드에서 채널을 반환하고, fluent 방식의 TelegramMessage, TelegramFile, TelegramPoll 등의 클래스로 메시지를 구성하면 됩니다.
telegram은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
telegram은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
telegram은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. telegram의 마지막 커밋은 2026년 9월 4일입니다.
telegram은(는) 어디에 사용할 수 있나요?
Laravel 앱에서 고객의 Telegram 계정으로 주문 또는 청구서 알림 전송 서버 또는 모니터링 알림을 팀 Telegram 그룹에 게시 애플리케이션 이벤트를 바탕으로 투표나 퀴즈 진행 Telegram의 전송 속도 제한을 준수하면서 여러 구독자에게 공지 전송
telegram는 어떻게 설치하나요?
Composer로 패키지를 설치합니다: composer require laravel-notification-channels/telegram @BotFather에서 봇을 만들고 config/services.php에서 TELEGRAM_BOT_TOKEN을 설정합니다 알림의 via() 메서드에서 'telegram'을 반환하고 toTelegram()을 정의합니다
telegram은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/laravel-notification-channels/telegram

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트