Twilio로 SMS·MMS 메시지 전송과 음성 통화를 앱에서 구현해 전화 기반 커뮤니케이션을 추가합니다.
Twilio에 앱 연결하기
앱을 Twilio에 연결하여 SMS/MMS 메시지 전송, 음성 통화, 전화 기반 커뮤니케이션 플로우를 Lovable 앱에서 바로 구현하세요.
Twilio는 앱이 전화를 통해 사용자에게 도달할 수 있게 해주는 클라우드 커뮤니케이션 플랫폼입니다. 실시간 문자 업데이트, 전화 인증, 음성 통화, 메시징 기반 워크플로우가 필요한 앱에 적합합니다.
이 통합은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
Twilio를 연동하면 앱에서 다음과 같은 작업이 가능합니다.
- SMS 및 MMS 메시지 송수신
- 음성 통화 발신 및 관리
- WhatsApp 메시징 플로우 지원
- 전화번호 유효성 검사 및 조회
Twilio는 인앱 알림이나 이메일이 아닌, 전화나 문자로 사용자와 소통해야 할 때 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| SMS 알림 및 경고 | 주문 추적 앱을 만들어줘. 주문이 발송되면 고객에게 추적 링크와 함께 문자를 보내줘. | 앱 이벤트에 따라 실시간 SMS 업데이트를 전송합니다. 상태 변경을 감지하고, 메시지를 생성해 고객에게 자동으로 전송합니다. |
| 전화 인증 플로우 | 회원가입 시 SMS로 일회성 코드를 보내 전화번호를 인증한 후 계정을 만드는 플로우를 구현해줘. | 온보딩이나 로그인에 전화 기반 인증을 추가합니다. 일회성 코드를 전송하고, 사용자 입력을 확인한 뒤 진행합니다. |
| 예약 리마인더 | 예약 앱을 만들고, 예약 24시간 전에 문자를 보내고 시간 변경 시 다시 알려줘. | 예약 데이터를 기반으로 자동 리마인더 메시지를 전송합니다. 수동 후속 조치 없이 적절한 시점에 문자를 트리거합니다. |
| 음성 통화 업데이트 | 서비스 앱을 만들어줘. 기술자가 출발하면 고객에게 녹음 메시지로 전화를 걸어줘. | 즉각적인 주의가 필요한 업데이트 시 앱에서 아웃바운드 음성 통화를 트리거합니다. 전화를 걸어 음성 메시지를 전달합니다. |
| WhatsApp 지원 인박스 | 고객 지원 앱을 만들어줘. 사용자가 WhatsApp으로 메시지를 보내면 상담원이 앱에서 답변할 수 있게 해줘. | WhatsApp을 제품의 커뮤니케이션 채널로 추가합니다. Twilio를 통해 메시지를 송수신하여 워크플로우 안에서 대화를 처리합니다. |
| 전화번호 유효성 검사 | 리드 수집 폼을 만들어줘. 전화번호가 유효한지 확인한 뒤 데이터베이스에 저장해줘. | 전화번호를 저장하거나 사용하기 전에 유효성을 검증합니다. Twilio를 통해 번호를 확인하여 더 깨끗한 연락처 데이터로 워크플로우를 시작합니다. |
Twilio 연결하기
Twilio 연결을 만들 수 있는 사용자는 요금제와 워크스페이스 설정에 따라 다릅니다. 앱 + 채팅 커넥터는 Free, Pro, Business 요금제에서 기본으로 사용할 수 있습니다. Enterprise 요금제에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정되기 때문입니다.
서로 다른 API 키를 사용하는 Twilio 연결을 여러 개 만들 수 있습니다. 개발과 프로덕션 환경을 분리하거나 여러 Twilio 계정을 관리할 때 유용합니다.
연결을 만든 뒤 Twilio를 사용할 프로젝트에 연결할 수 있습니다. 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 해당 프로젝트를 연결해 달라고 요청할 수 있습니다.
사전 준비
Twilio를 연결하기 전에 다음을 준비하세요.
- Twilio 계정과 Account SID
- SMS, MMS 전송 또는 통화에 필요한 경우 Twilio 전화번호
- SID와 Secret이 있는 Twilio API 키. 전송에는 Standard 키를 사용할 수 있습니다. 수신한 WhatsApp 또는 MMS 미디어를 읽으려면 Main 키나 미디어 권한이 있는 제한된 키를 사용하세요.
- 계정이 호스팅되는 Twilio Region
- Lovable 워크스페이스에서 연결 생성 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 SMS, MMS, 음성, WhatsApp 등 모든 Twilio 사용량은 Twilio 계정과 요금제에 따라 Twilio에서 직접 청구됩니다. Lovable이 아닌 Twilio가 과금을 처리합니다.
1단계: Twilio API 키 생성
Twilio는 단일 토큰 대신 API Key SID와 Secret을 사용합니다. 메인 Auth Token을 사용하는 것보다 안전합니다. API 키는 독립적으로 해지할 수 있기 때문입니다.
Twilio Standard API Key를 만들려면.
Twilio Console 열기
Twilio Console에 로그인하고 Account → API keys & tokens로 이동합니다.
키 만들기
Create API key를 클릭합니다. Lovable integration 같은 Friendly name을 입력합니다. 계정이 호스팅되는 Region을 선택합니다. 대부분 계정의 기본값인 United States (US1), Ireland (IE1), Australia (AU1) 중에서 고를 수 있습니다. Key type은 Standard로 두고 Create API key를 클릭합니다.
SID와 Secret 복사하기
SK로 시작하는 SID와 Secret을 모두 복사합니다. Twilio는 Secret을 한 번만 표시하므로 페이지를 떠나기 전에 안전하게 보관하세요.
Account SID 기록하기
Twilio Console 홈에서 AC로 시작하는 Account SID를 복사합니다. Twilio API 키는 리전별로 구분되므로 여기서 선택한 리전과 Lovable에서 선택하는 리전이 같아야 합니다.
API Key Secret은 비밀번호와 같은 역할을 합니다. 안전하게 보관하고 공개하지 마세요. 다음 단계에서 필요합니다.
프로덕션 SMS 트래픽을 보내기 전에 Twilio Console에서 SMS Pumping Protection을 활성화하고 SMS Geo Permissions를 검토해 필요한 대상 국가만 허용하세요. SMS pumping은 공격자가 자신이 제어하는 번호로 대량의 SMS를 유발해 사용자가 비용을 부담하게 하는 사기입니다.
자세한 내용은 Twilio의 Console에서 API 키 만들기 문서를 참고하세요.
2단계: Lovable에 Twilio 연결
서로 다른 API 키로 여러 연결을 만들 수 있습니다.
Connectors에서 Twilio 열기
Connectors를 열고 Twilio를 선택합니다. 카탈로그를 여는 다른 방법은 커넥터를 찾는 위치를 참고하세요.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 연결 이름을 입력합니다(예:
Twilio Prod). 이 이름은 Lovable 안에서 연결을 식별하는 데만 사용됩니다. - Region: API 키에 사용한 리전을 선택합니다. United States (US1)(기본값), Ireland (IE1), Australia (AU1) 중에서 고를 수 있습니다.
- Account SID:
AC로 시작하는 Twilio Account SID를 붙여넣습니다. - Standard API Key SID:
SK로 시작하는 API 키 SID를 붙여넣습니다. - API Key Secret: 키를 만들 때 Twilio가 표시한 Secret을 붙여넣습니다.
이 연결을 사용할 수 있는 사람 선택
Sharing 아래에서 연결은 기본적으로 본인에게만 공개되며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나 Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있게 합니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다. Lovable은 연결을 저장하기 전에 Twilio API로 인증 정보를 검증합니다.
연결이 완료되면 프로젝트에서 빌드하는 사용자는 누구나 채팅에서 Lovable에 프로젝트를 Twilio와 연결해 달라고 요청할 수 있습니다(구성된 연결 수준 접근 권한에 따름). 그러면 Lovable 앱이 Twilio를 통해 메시지를 보내고, 전화를 걸고, 번호를 조회할 수 있습니다.
메시지와 통화 수신하기
Twilio는 수신 메시지, 전송 상태 업데이트, 통화 이벤트를 Twilio 전화번호나 메시징 서비스에 구성한 웹훅 URL로 전달합니다. 이 웹훅은 Lovable 커넥터 게이트웨이를 통과하지 않습니다. 수신 메시지를 처리해 달라고 Lovable에 요청하면 프로젝트에 공개 엔드포인트를 만듭니다. 해당 엔드포인트를 Twilio Console에서 웹훅으로 등록하세요.
제한 사항
Twilio 커넥터는 다음 작업을 할 수 없습니다.
- 커넥터 게이트웨이를 통해 Twilio 웹훅을 수신할 수 없습니다. Twilio가 앱의 공개 엔드포인트를 직접 호출합니다.
- 계정의 core REST API 리소스(
/2010-04-01/Accounts/{AccountSid}/...)와 Messaging, Verify, Lookups, Conversations, Content API 이외의 Twilio API를 호출할 수 없습니다. - 미디어 권한이 없는 키로 메시지 미디어를 읽을 수 없습니다. WhatsApp 또는 MMS 사진 처리 중 Twilio 권한 오류(코드
70051)가 발생하면 Main API 키나 메시지 미디어 읽기 권한이 있는 제한된 키로 연결을 업데이트하세요. - API 키를 자동으로 갱신하거나 교체할 수 없습니다. 키를 교체하려면 Twilio Console에서 새 키를 만들고 Lovable 연결을 업데이트하세요.
- 최종 사용자별 Twilio 로그인을 지원하지 않습니다. 각 연결은 연결된 모든 프로젝트가 공유하는 Twilio 계정 하나를 나타냅니다.
Twilio 연결 관리
연결은 Connectors에서 관리합니다. **Twilio**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 Twilio 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, Twilio을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.