Telegram에 앱 연결하기
앱을 Telegram에 연결하여 메시지 전송, 커맨드 수신, Telegram 봇을 통한 사용자 상호작용을 구현하세요.
Telegram은 앱이 채팅, 그룹, 채널을 통해 사용자와 소통할 수 있게 해주는 메시징 플랫폼입니다. Telegram 커넥터를 사용하면 알림 전송, 사용자 메시지 응답, Telegram 대화에서 직접 워크플로우 트리거가 가능합니다.
Telegram 봇은 앱의 채팅 인터페이스 역할을 하며, 사용자가 앱을 열지 않고도 업데이트를 받거나 기능과 상호작용할 수 있습니다.
Telegram을 연동하면 앱에서 다음과 같은 작업이 가능합니다:
- 사용자나 그룹에 메시지, 사진, 문서, 기타 미디어 전송
- 사용자 메시지 및 커맨드 수신 및 응답 (폴링 방식)
- 인터랙티브 버튼 및 커스텀 키보드 생성
- 예약, 주문, 요청 제출 등의 워크플로우 안내
- 채팅을 통한 알림, 보고서, 리마인더 전달
- Telegram 그룹이나 채널에 업데이트 브로드캐스트
Telegram은 사용자에게 이벤트 알림, 업데이트 브로드캐스트를 보내거나, 채팅을 통해 직접 정보를 요청할 수 있게 할 때 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| Telegram 알림 및 주문 추적이 있는 온라인 스토어 | 온라인 스토어를 만들어줘. 새 주문이 생기면 팀 Telegram에 메시지를 보내고, 고객이 주문번호로 봇에 메시지를 보내면 배송 상태를 알려줘. | Telegram으로 스토어 활동과 고객 업데이트를 관리합니다. 주문이 접수되면 팀 Telegram 채팅에 주문 상세를 전송합니다. 고객이 봇에 주문번호를 보내면 현재 배송 상태를 반환합니다. |
| Telegram 알림이 있는 API 모니터링 대시보드 | 모니터링 대시보드를 만들어줘. 매분 API를 확인하고 서비스가 응답하지 않으면 Telegram 알림을 보내줘. | 시스템을 모니터링하고 문제 발생 시 Telegram으로 알림을 보냅니다. 일정에 따라 서비스 상태를 확인하고, 다운타임이나 오류 감지 시 Telegram 채팅에 메시지를 전송합니다. |
| Telegram 채팅 기반 고객 지원 인박스 | 지원 인박스 앱을 만들어줘. 고객이 Telegram 봇에 메시지를 보내면 지원 대시보드에 대화가 나타나게 해줘. | Telegram 대화를 통한 고객 지원을 제공합니다. 사용자가 봇에 메시지를 보내면 지원 시스템에 기록하고, 팀이 대시보드나 자동 응답으로 답변합니다. |
| Telegram 보고서가 있는 분석 대시보드 | KPI 대시보드를 만들어줘. 매일 아침 지표를 계산해서 팀 Telegram 그룹에 요약을 보내줘. | Telegram으로 정기 보고서를 전달합니다. 일정에 따라 지표를 집계하고 포맷된 요약 메시지를 Telegram 채팅이나 그룹에 전송합니다. |
| Telegram 가격 알림이 있는 시장 데이터 트래커 | 시장 데이터 트래커를 만들어줘. 암호화폐나 주식 가격을 모니터링하고 설정한 임계값에 도달하면 Telegram 메시지를 보내줘. | 추적 값이 변경되면 알림을 보냅니다. API에서 금융 데이터를 모니터링하고, 가격이 설정된 임계값을 넘으면 Telegram 메시지를 전송합니다. |
Telegram 연결 방식
각 Telegram 연결은 @BotFather를 통해 생성한 하나의 Telegram 봇을 나타내는 봇 토큰을 사용합니다.
Lovable 워크스페이스에서는:
- 각 연결은 하나의 Telegram 봇을 나타냅니다
- 여러 봇을 사용하려면 연결을 여러 개 만들 수 있습니다
- 여러 프로젝트가 같은 연결을 공유할 수 있습니다
Telegram은 OAuth가 아닌 봇 토큰 인증 모델을 사용하므로, 승인 플로우나 토큰 갱신 프로세스가 없습니다.
Telegram은 안전한 인증 정보 처리를 위해 Lovable의 게이트웨이 아키텍처를 사용합니다. 인증 및 사용량 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.
Telegram 연결하기
워크스페이스 admin 또는 owner가 Telegram을 연결할 수 있습니다.
연결을 만들면 해당 워크스페이스의 모든 프로젝트에서 Telegram을 사용할 수 있습니다.
사전 준비
Telegram을 연결하기 전에 다음을 준비하세요:
- Telegram 계정
- @BotFather를 통해 생성한 Telegram 봇 및 봇 토큰
- Lovable 워크스페이스 admin 또는 owner 권한
1단계: Telegram 봇 생성 및 봇 토큰 받기
Telegram 봇은 Telegram의 공식 봇 관리 도구인 @BotFather를 통해 생성하고 관리합니다.
봇을 만들고 토큰을 받으려면:
-
Telegram을 열고 @BotFather를 검색하거나 https://t.me/BotFather로 이동합니다.
-
/newbot커맨드를 전송합니다. -
안내에 따릅니다:
- 봇의 표시 이름을 선택합니다
bot으로 끝나는 사용자 이름을 선택합니다 (예:myapp_notify_bot)
-
BotFather가 다음과 같은 봇 토큰을 생성합니다:
123456789:ABCDefghIJKLMnopQRStuvWXYz1234567 -
토큰을 복사하고 안전하게 저장합니다.
봇 토큰은 비밀번호와 같습니다. 안전하게 보관하고 절대 공개하지 마세요. 다음 단계에서 필요합니다.
자세한 안내는 Telegram 문서를 참고하세요: BotFather
2단계: Lovable에 Telegram 연결
- Settings → Connectors → Shared connectors로 이동합니다.
- Telegram을 선택합니다.
- Add connection을 클릭합니다.
- 연결 정보를 입력합니다:
- Display name: 연결을 식별할 수 있는 이름을 입력합니다 (예:
Telegram Prod). - Bot token: @BotFather에서 받은 봇 토큰을 붙여넣습니다.
- Display name: 연결을 식별할 수 있는 이름을 입력합니다 (예:
- Create를 클릭합니다.
Lovable이 토큰을 검증하고 연결을 생성합니다. 연결이 완료되면 Lovable 앱에서 Telegram 메시지를 보내고 받을 수 있습니다.
제한 사항
Telegram 커넥터는 현재 다음을 지원하지 않습니다:
- 수신 메시지를 위한 웹훅. 대신
getUpdates(폴링)를 사용하여 수신 메시지를 받으세요. - 사용자별 Telegram 로그인 (최종 사용자가 각자 계정을 연결)
수신 메시지를 받으려면 앱에서 Telegram Bot API에 주기적으로 업데이트를 요청해야 합니다.
Telegram 연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결 해제할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
연결 해제 방법:
커넥터로 이동
Settings → Connectors → Shared connectors에서 **Telegram**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 선택합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 Telegram에 접근할 수 없습니다. 필요하면 다른 연결로 다시 연결할 수 있습니다.
Telegram 연결 삭제
워크스페이스 admin 또는 owner가 Telegram 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 인증 정보가 제거되며, 새 연결을 만들기 전까지 이 연결을 사용하던 앱은 동작을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.
삭제 방법:
커넥터로 이동
Settings → Connectors → Shared connectors에서 **Telegram**를 선택합니다.
연결 열기
삭제할 연결을 엽니다.
연결된 프로젝트 확인
Linked projects 섹션을 확인합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.