SMS·RCS 메시징 API인 GatewayAPI에 앱을 연결해 모바일 메시지 발송, 전달 상태 추적, 수신 답장 처리를 수행합니다.
GatewayAPI에 앱 연결하기
SMS·RCS 메시징 API인 GatewayAPI에 앱을 연결해 모바일 메시지를 발송하고, 전달 상태를 추적하며, Lovable 앱에서 수신 답장을 처리하세요.
GatewayAPI는 API를 통해 모바일 메시지를 발송하는 SMS·RCS 메시징 플랫폼입니다. GatewayAPI connector를 사용하면 Lovable 앱이 SMS·RCS 메시지를 발송하고, 알림을 일괄 발송하며, 전달 이벤트를 앱 워크플로우에 연결할 수 있습니다.
GatewayAPI를 연결하면 앱은 다음 작업이 가능합니다.
- 전화번호로 SMS·RCS 메시지 발송
- 알림·캠페인용 모바일 메시지 일괄 발송
- 주문, 예약 등 앱 레코드와 메시지를 매핑하기 위해 레이블·참조값 추가
- GatewayAPI에서 구성한 공개 웹훅 엔드포인트를 통해 전달 상태 콜백 수신
- GatewayAPI 계정이 지원하는 경우 수신 SMS·RCS 답장 받기
GatewayAPI는 GatewayAPI 계정 기반의 트랜잭션 알림, 운영 공지, 고객 메시징, 캠페인 워크플로우가 필요한 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 예약 리마인더 | GatewayAPI를 사용해 각 예약 전에 SMS 리마인더를 발송하는 예약 알림 앱을 만들어줘. | 예약된 SMS 리마인더로 노쇼를 줄입니다. 앱이 예약을 저장하고, 각 예약 전에 GatewayAPI 메시지를 발송하며, 각 리마인더의 전달 상태를 기록합니다. |
| 주문 상태 알림 | GatewayAPI를 사용해 주문이 포장·배송·배달될 때 고객에게 문자를 보내는 주문 추적 앱을 만들어줘. | 주문 이벤트에 따라 고객에게 최신 정보를 전달합니다. 앱이 주문 상태 변경 시 SMS·RCS 업데이트를 발송하고, 메시지 참조값으로 콜백을 올바른 주문에 연결합니다. |
| 인시던트 알림 | GatewayAPI를 사용해 중요 이벤트 발생 시 온콜 담당자에게 문자를 보내는 인시던트 알림 도구를 만들어줘. | 이메일·채팅 외 채널로 긴급 알림을 발송합니다. 앱이 중요 인시던트를 감지하고, GatewayAPI를 통해 모바일 알림을 발송하며, 감사 기록을 위해 전달 결과를 저장합니다. |
| 양방향 고객지원 수신함 | GatewayAPI를 사용해 고객의 수신 SMS 답장을 받는 지원 수신함을 만들어줘. | 수신 고객 답장을 고객지원 레코드로 전환합니다. 앱이 공개 웹훅 엔드포인트를 노출하고, GatewayAPI 서명을 검증하며, 고객지원팀을 위해 답장을 저장합니다. |
| 캠페인 발송기 | GatewayAPI를 사용해 승인된 SMS 업데이트를 고객 목록에 발송하는 캠페인 도구를 만들어줘. | 앱 데이터에서 세그먼트된 모바일 캠페인을 발송합니다. 앱이 수신자를 일괄 처리하고, GatewayAPI를 통해 메시지를 발송하며, 각 캠페인의 콜백 이벤트를 추적합니다. |
| 전달 상태 대시보드 | GatewayAPI를 사용해 GatewayAPI 웹훅에서 발송·전달·실패 SMS 메시지를 보여주는 대시보드를 만들어줘. | 앱 내에서 메시지 전달을 모니터링합니다. 앱이 웹훅 이벤트를 저장하고, 메시지 참조값으로 그룹화하며, 시간별 전달 추이를 보여줍니다. |
GatewayAPI 연결하기
Workspace admins와 owners가 GatewayAPI를 연결할 수 있습니다.
App connectors는 Free, Pro, Business 플랜에서 기본으로 활성화됩니다. Enterprise 플랜에서는 workspace admins와 owners가 Connectors → Admin settings → App connectors에서 app connectors를 활성화할 수 있습니다.
다른 API 토큰을 사용해 여러 GatewayAPI 연결을 생성할 수 있습니다. 환경을 분리하거나(예: 개발·프로덕션) 다른 GatewayAPI 계정을 연결하거나 별도의 GatewayAPI 도메인을 사용할 때 유용합니다.
연결이 생성되면 workspace 내 모든 프로젝트에서 GatewayAPI를 사용할 수 있습니다. 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 연결해달라고 요청할 수 있습니다.
사전 준비
GatewayAPI를 연결하기 전에 다음을 준비하세요.
- GatewayAPI 계정
- GatewayAPI API 토큰
- API 토큰이 유효한 GatewayAPI 도메인: Global (gatewayapi.com) 또는 EU (gatewayapi.eu)
- Lovable workspace owner 또는 admin 역할
이 connector를 통한 모든 SMS, RCS, 웹훅, API 사용은 GatewayAPI 계정을 통해 이루어집니다. 메시징 비용, 할당량, 결제는 Lovable이 아닌 GatewayAPI가 직접 처리합니다.
Step 1: GatewayAPI API 토큰 가져오기
GatewayAPI API 토큰으로 Lovable 앱이 GatewayAPI 메시징 API에 인증합니다. 환경이나 앱별로 별도 토큰을 생성할 수 있습니다.
GatewayAPI API 토큰을 생성하거나 복사하려면 다음 단계를 따르세요.
GatewayAPI 계정 열기
Lovable에서 사용할 계정으로 GatewayAPI 대시보드에 로그인합니다.
API 토큰 설정 열기
GatewayAPI에서 계정의 API 토큰 관리 섹션을 엽니다.
API 토큰 생성 또는 복사하기
Lovable용 새 API 토큰을 생성하거나 기존 토큰을 복사합니다. GatewayAPI에서 이름을 요청하면 예를 들어 Lovable integration처럼 알아보기 쉬운 이름을 사용하세요.
API 도메인 확인하기
토큰이 글로벌 GatewayAPI 도메인(gatewayapi.com)에 속하는지 EU 도메인(gatewayapi.eu)에 속하는지 확인합니다. Lovable에서 일치하는 도메인을 선택해야 합니다.
API 토큰은 비밀번호처럼 기능합니다. 안전하게 보관하고 절대 공개적으로 공유하지 마세요. 다음 단계에서 필요합니다.
자세한 내용은 GatewayAPI 문서를 참고하세요. GatewayAPI authentication.
Step 2: GatewayAPI를 Lovable에 연결하기
다른 API 토큰을 사용해 여러 연결을 생성할 수 있습니다.
Connectors에서 GatewayAPI 열기
Connectors → App connectors로 이동해 GatewayAPI를 선택합니다.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 예를 들어
GatewayAPI Prod처럼 연결 이름을 지정합니다. - API domain: 토큰이 유효한 GatewayAPI 도메인을 선택합니다. 기본값은 **Global (gatewayapi.com)**입니다. EU 도메인용 토큰이면 **EU (gatewayapi.eu)**를 선택하세요.
- API token: GatewayAPI API 토큰을 붙여넣습니다.
이 연결에 접근할 수 있는 사람 선택하기
Who can access this connection 아래에서 workspace 내 누가 이 연결을 사용할 수 있는지 결정합니다.
- Only you (기본): 연결을 생성한 사람만 사용할 수 있습니다.
- Invite specific people: 명시적으로 추가된 workspace 멤버만 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭해 Lovable workspace 전체에 공개합니다.
자세한 내용은 Connection-level access를 참고하세요.
연결하기
Connect를 클릭합니다.
연결이 완료되면 프로젝트에서 작업하는 누구든 Lovable 채팅에서 프로젝트를 GatewayAPI에 연결해달라고 요청할 수 있습니다(구성된 connection-level access 기준). Lovable 앱은 GatewayAPI를 통해 SMS·RCS 메시지를 발송할 수 있습니다.
전달 상태 및 수신 답장 받기
GatewayAPI는 전달 상태 업데이트와 수신 SMS·RCS 메시지를 GatewayAPI 대시보드에서 구성하는 웹훅 엔드포인트로 전송합니다. 이 웹훅 이벤트는 Lovable connector gateway를 통과하지 않습니다.
Lovable에 웹훅 처리를 구축해달라고 요청할 때 다음 사항을 포함하도록 하세요.
- GatewayAPI 웹훅 이벤트용 공개 엔드포인트 생성
- 웹훅 서명 검증을 위한 별도
GATEWAYAPI_WEBHOOK_SECRET백엔드 시크릿 저장 - 웹훅 데이터를 신뢰하기 전에
Signature헤더 검증 - 2xx 상태로 응답하기 전에 각 이벤트 저장
- GatewayAPI가 이벤트를 실패로 처리하지 않도록 5초 이내에 응답
- GatewayAPI 메시지 참조값으로 상태 콜백을 앱 레코드에 매핑
Lovable이 웹훅 엔드포인트를 생성하면 해당 엔드포인트와 웹훅 시크릿을 일치하는 도메인의 GatewayAPI 대시보드에 등록합니다.
수신 SMS에는 GatewayAPI에서 임대한 단문번호나 키워드가 필요하며, GatewayAPI에서 웹훅에 연결해야 합니다. 가용성과 요금은 GatewayAPI가 처리합니다.
제한사항
GatewayAPI connector는 다음 작업을 지원하지 않습니다.
- GatewayAPI 웹훅 생성·수정·삭제. 웹훅은 GatewayAPI 대시보드에서 직접 구성하세요.
- connector gateway를 통한 전달 상태·수신 메시지 웹훅 이벤트 라우팅
- 단문번호, 키워드 등 수신 메시징 리소스 임대
- 최종 고객별 GatewayAPI 인증. 각 연결은 연결된 모든 프로젝트가 공유하는 단일 GatewayAPI API 토큰을 나타냅니다.
- 연결당 둘 이상의 GatewayAPI 도메인 사용. 단일 연결은 글로벌 도메인 또는 EU 도메인 중 하나에만 인증합니다.
GatewayAPI 연결에서 프로젝트 연결 해제하기
Editors 이상은 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
프로젝트 연결을 해제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **GatewayAPI**를 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택하기
Linked projects 아래에서 연결을 해제할 프로젝트를 체크합니다.
확인하기
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 GatewayAPI에 접근할 수 없습니다. 다시 GatewayAPI가 필요하면 사용 가능한 연결에 프로젝트를 연결하면 됩니다.
GatewayAPI 연결 삭제하기
Workspace admins와 owners가 GatewayAPI 연결을 삭제할 수 있습니다. 다른 멤버는 본인이 생성했거나 명시적으로 접근 권한을 부여받은 연결만 삭제할 수 있습니다.
연결 삭제는 영구적이며 취소할 수 없습니다. 연결된 모든 프로젝트에서 자격증명이 제거되고, 이 연결을 사용하는 앱은 새 연결이 추가될 때까지 작동을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용하는 프로젝트를 확인하세요.
연결을 삭제하려면 다음 단계를 따르세요.
Connectors 열기
Connectors를 열고 App connectors로 이동한 후 **GatewayAPI**를 선택합니다.
연결 열기
제거할 연결을 엽니다.
연결된 프로젝트 검토하기
Linked projects 섹션을 검토합니다.
삭제하기
Delete this connection 아래에서 Delete를 클릭하고 확인합니다.