Telegram 봇으로 메시지를 주고받고, 알림과 대화형 워크플로를 앱에 추가합니다.
Telegram에 앱 연결하기
Lovable로 만든 앱에서 Telegram 메시지를 주고받으세요. 이 페이지는 앱 통합에 관한 내용이며, Telegram에서 Lovable과 채팅하는 방법이 아닙니다.
Telegram은 Lovable 앱이 채팅, 그룹, 채널을 통해 사용자와 소통할 수 있게 해주는 메시징 플랫폼입니다. Telegram 커넥터를 사용하면 직접 소유한 봇을 통해 앱에서 알림을 보내고, 사용자 메시지에 응답하고, Telegram 대화에서 바로 워크플로를 실행할 수 있습니다.
Telegram은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
이 통합은 Lovable로 만드는 앱을 위한 것입니다. 앱이 Telegram 봇을 통해 메시지를 주고받을 수 있습니다.
대신 Telegram 안에서 Lovable과 채팅하고 싶다면 Telegram에서 Lovable 사용하기를 참고하세요.
Telegram을 연결하면 앱에서 다음 작업을 할 수 있습니다.
- 사용자나 그룹에 메시지, 사진, 문서, 기타 미디어 전송
- 웹훅을 통한 사용자 메시지와 명령 수신 및 응답
- 대화형 버튼과 맞춤 키보드 생성
- 예약, 주문, 요청 제출 같은 워크플로 안내
- 채팅을 통한 알림, 보고서, 리마인더 전달
- Telegram 그룹이나 채널에 업데이트 브로드캐스트
Telegram은 이벤트를 사용자에게 알리거나, 업데이트를 브로드캐스트하거나, 사용자가 채팅에서 직접 정보를 요청하게 할 때 적합합니다.
주요 활용 사례 및 예시 앱
다음 예시는 Telegram으로 만들 수 있는 앱과 시작 프롬프트를 보여줍니다.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 주문 추적 스토어 | Telegram을 사용해 온라인 스토어를 만들어줘. 주문이 접수되면 팀에 메시지를 보내고, 고객이 봇에 문의하면 배송 상태를 알려줘. | Telegram으로 스토어 활동과 고객 업데이트를 관리합니다. 앱이 주문 상세를 팀 채팅에 보내고, 고객이 주문번호와 함께 봇에 메시지를 보내면 답변합니다. |
| API 모니터링 알림 | Telegram을 사용해 매분 API를 확인하고 서비스가 응답하지 않으면 알림을 보내는 모니터링 대시보드를 만들어줘. | 문제가 발생하면 Telegram으로 알림을 보냅니다. 앱이 일정에 따라 서비스 상태를 확인하고 다운타임이나 오류를 감지하면 Telegram 채팅에 게시합니다. |
| 지원 인박스 | Telegram을 사용해 고객이 봇에 메시지를 보내면 지원 대시보드에 대화가 나타나는 지원 인박스를 만들어줘. | Telegram 대화를 통해 고객 지원을 제공합니다. 앱이 봇이 받은 메시지를 기록하고 팀이 대시보드에서 답변할 수 있게 합니다. |
| 일일 KPI 보고서 | Telegram을 사용해 매일 아침 팀 그룹에 일일 지표 요약을 게시하는 KPI 대시보드를 만들어줘. | Telegram으로 정기 보고서를 전달합니다. 앱이 일정에 따라 지표를 집계하고 형식이 적용된 요약을 Telegram 그룹에 보냅니다. |
| 가격 알림 | Telegram을 사용해 선택한 가격 임계값에 도달하면 메시지를 보내는 시장 추적기를 만들어줘. | 추적 값이 바뀌면 알림을 보냅니다. 앱이 API의 가격을 모니터링하고 임계값을 넘으면 사용자에게 메시지를 보냅니다. |
Telegram 연결 동작 방식
각 Telegram 연결은 @BotFather에서 만든 하나의 Telegram 봇을 나타내는 봇 토큰을 사용합니다.
Lovable 워크스페이스에서는 다음과 같이 작동합니다.
- 각 연결은 Telegram 봇 하나를 나타냅니다.
- 여러 봇을 사용하려면 연결을 여러 개 만들 수 있습니다.
- 여러 프로젝트가 같은 연결을 사용할 수 있습니다.
Telegram은 OAuth가 아니라 봇 토큰으로 인증하므로 승인 창이 표시되지 않으며 토큰을 갱신할 필요도 없습니다. 요청은 Lovable의 커넥터 게이트웨이를 통과하며, 게이트웨이가 봇 토큰을 자동으로 추가합니다. 인증 및 사용량 제한에 대한 자세한 내용은 게이트웨이 기반 커넥터를 참고하세요.
Telegram 연결 방법
Telegram 연결을 만들 수 있는 사용자는 요금제와 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 요금제에서 기본으로 사용할 수 있습니다. Enterprise 요금제에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정되기 때문입니다.
서로 다른 봇을 사용하는 Telegram 연결을 여러 개 만들 수 있습니다. 개발과 프로덕션 환경을 분리하거나 여러 봇을 운영할 때 유용합니다.
연결을 만든 뒤 Telegram을 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 해당 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비
Telegram을 연결하기 전에 다음을 준비하세요.
- Telegram 계정
- @BotFather에서 만든 Telegram 봇과 봇 토큰
- Lovable 워크스페이스에서 연결 생성 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
Telegram은 Bot API 사용료를 청구하지 않습니다. Telegram의 사용량 제한과 약관은 그대로 적용되며, Lovable이 아닌 Telegram이 이를 집행합니다.
1단계: Telegram 봇을 만들고 봇 토큰 받기
Telegram 봇은 Telegram의 공식 봇 관리 도구인 @BotFather에서 만들고 관리합니다.
봇을 만들고 토큰을 받으려면 다음 단계를 따르세요.
BotFather 열기
Telegram에서 @BotFather를 검색하거나 t.me/BotFather를 엽니다.
봇 만들기
/newbot 명령을 보내고 안내를 따릅니다. 봇의 표시 이름을 정한 뒤 bot으로 끝나는 사용자 이름을 선택합니다(예: myapp_notify_bot).
봇 토큰 복사하기
BotFather가 123456789:ABCDefghIJKLMnopQRStuvWXYz1234567 형식의 봇 토큰을 보냅니다. 토큰을 복사해 안전하게 보관하세요.
봇 토큰은 비밀번호와 같은 역할을 합니다. 안전하게 보관하고 공개하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 Telegram의 BotFather 및 Telegram Bot API 문서를 참고하세요.
2단계: Lovable에 Telegram 연결하기
서로 다른 봇 토큰으로 여러 연결을 만들 수 있습니다.
Connectors에서 Telegram 열기
Connectors를 열고 Telegram을 선택합니다. 카탈로그를 여는 다른 방법은 커넥터를 찾는 위치를 참고하세요.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 연결 이름을 입력합니다(예:
Telegram Prod). 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다. - Bot token: @BotFather에서 받은 봇 토큰을 붙여넣습니다. 양식에도 1단계의 BotFather 절차가 다시 표시됩니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Telegram Bot API로 토큰을 검증합니다.
연결이 완료되면 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 프로젝트를 Telegram과 연결해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따름). 그러면 Lovable 앱이 봇을 통해 Telegram 메시지를 주고받을 수 있습니다.
메시지 수신하기
메시지를 받으려면 누군가 봇에 글을 보낼 때 Telegram이 호출할 수 있는 공개 엔드포인트가 앱에 필요합니다. 수신 메시지를 처리해 달라고 Lovable에 요청하면 프로젝트에 해당 엔드포인트를 만들고 커넥터 게이트웨이를 통해 봇의 웹훅으로 등록합니다. 사용자는 다른 Telegram 봇과 같은 방식으로 봇에 메시지를 보내고, 앱이 이에 답합니다.
봇 토큰 하나에는 웹훅을 하나만 등록할 수 있습니다. 같은 봇을 두 프로젝트에서 사용하면 가장 최근에 등록한 웹훅이 적용됩니다.
제한 사항
Telegram 커넥터는 다음 작업을 할 수 없습니다.
- 봇을 만들거나 이름, 설명, 명령 같은 봇 설정을 변경할 수 없습니다. 해당 작업은 @BotFather에서 관리하세요.
- 봇 토큰을 자동으로 갱신하거나 교체할 수 없습니다. 토큰을 교체하려면 @BotFather에서 기존 토큰을 취소하고 새 토큰을 만든 뒤 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Telegram 로그인을 지원하지 않습니다. 각 연결은 연결된 모든 프로젝트가 공유하는 봇 하나를 나타냅니다.
Telegram 연결 관리
연결은 Connectors에서 관리합니다. **Telegram**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Telegram 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적입니다. 연결된 모든 프로젝트에서 자격 증명이 제거되고, Telegram을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.