솔라피(Solapi)
반값문자(halfsms)는 구글 앱스 스크립트(Google Apps Script)에서 바로 호출할 수 있는 오픈 API를 공식적으로 제공하지 않아, 앱스 스크립트 연동이 용이한 솔라피(Solapi) 또는 알리고(Aligo) 같은 메시징 서비스 API를 활용하는 것을 추천합니다. (문자 단가 역시 건당 8~10원 내외로 비슷하거나 매우 저렴합니다.)
아래는 구글 시트에서 ‘입금여부’를 ‘완료’로 바꾸면 자동으로 문자가 발송되는 구글 앱스 스크립트 구축 전체 과정입니다.
1단계: 구글 시트 구조 맞추기
구글 폼과 연결된 구글 시트의 열(Column) 구성을 아래와 같이 설정해 주세요.
- A열: 제출시간
- B열: 이름
- C열: 전화번호
- D열: 입금여부 (이곳에 ‘완료’ 입력 시 문자 발송)
- E열: 발송상태 (자동으로 ‘발송완료’ 기록)
2단계: 문자 서비스 API Key 발급받기
가장 연동이 쉽고 앱스 Script 샘플을 잘 지원하는 솔라피(Solapi) 기준으로 설명해 드립니다.
- 솔라피 회원가입 및 발신번호 등록 (문자 발송용 본인 번호 인증)
- 개발자 지원 $\rightarrow$ API Key 관리 메뉴에서
API Key와API Secret발급 - 문자 발송에 필요한 캐시/포인트 소량 충전
1. 구글 시트 구성 (열 추가)
이전 구조에서 신청문자 발송상태를 기록할 열을 하나 더 추가해 주시면 관리하기 편리합니다.
- A열: 제출시간
- B열: 이름
- C열: 전화번호
- D열: 입금여부 (이곳에 ‘완료’ 입력 시 입금 안내 문자 발송)
- E열: 신청문자 상태 (자동으로 ‘발송완료’ 기록)
- F열: 입금문자 상태 (자동으로 ‘발송완료’ 기록)
2. apps script 구성
// ==========================================
// 1. 설정 정보 입력
// ==========================================
const API_KEY = 'YOUR_API_KEY'; // 솔라피 API Key
const API_SECRET = 'YOUR_API_SECRET'; // 솔라피 API Secret
const SENDER_PHONE = '01012345678'; // 발신번호 (숫자만)
// ==========================================
// 2-1. [트리거 1] 구글 폼 제출 시 (신청 완료 문자)
// ==========================================
function onFormSubmitTrigger(e) {
const sheet = e.source.getActiveSheet();
const row = e.range.getRow(); // 방금 제출되어 추가된 행
const name = sheet.getRange(row, 2).getValue(); // B열: 이름
const rawPhone = sheet.getRange(row, 3).getValue(); // C열: 전화번호
const phone = String(rawPhone).replace(/[^0-9]/g, ''); // 숫자만 추출
if (!phone) {
sheet.getRange(row, 5).setValue('오류: 번호없음');
return;
}
// 신청 접수 문자 내용
const messageText = `[수강신청 접수 안내]\n안녕하세요 ${name}님, 수강신청이 정상적으로 접수되었습니다.\n\n안내해 드린 계좌로 입금해 주시면 확인 후 최종 수강 확정 안내를 드리겠습니다. 감사합니다.`;
// 문자 발송
const result = sendSolapiSMS(phone, messageText);
if (result) {
sheet.getRange(row, 5).setValue('발송완료'); // E열: 신청문자 상태
} else {
sheet.getRange(row, 5).setValue('발송실패');
}
}
// ==========================================
// 2-2. [트리거 2] 시트 셀 수정 시 (입금 완료 문자)
// ==========================================
function onEditTrigger(e) {
const sheet = e.source.getActiveSheet();
const range = e.range;
const row = range.getRow();
const col = range.getColumn();
// 첫 번째 행(헤더)이거나, D열(4번째 열: 입금여부)이 아닌 경우 종료
if (row <= 1 || col !== 4) return;
const statusValue = range.getValue().toString().trim();
const sendStatus = sheet.getRange(row, 6).getValue(); // F열: 입금문자 상태
// 입금여부가 '완료'이고, 아직 입금 문자가 발송되지 않은 경우
if (statusValue === '완료' && sendStatus !== '발송완료') {
const name = sheet.getRange(row, 2).getValue(); // B열: 이름
const rawPhone = sheet.getRange(row, 3).getValue(); // C열: 전화번호
const phone = String(rawPhone).replace(/[^0-9]/g, '');
if (!phone) {
sheet.getRange(row, 6).setValue('오류: 번호없음');
return;
}
// 입금 확인 문자 내용
const messageText = `[입금 확인 안내]\n안녕하세요 ${name}님, 입금이 정상적으로 확인되어 수강 신청이 최종 완료되었습니다.\n\n자세한 강의 안내 및 일정은 개강 전 추가 안내드리겠습니다.`;
// 문자 발송
const result = sendSolapiSMS(phone, messageText);
if (result) {
sheet.getRange(row, 6).setValue('발송완료'); // F열: 입금문자 상태
} else {
sheet.getRange(row, 6).setValue('발송실패');
}
}
}
// ==========================================
// 3. 솔라피 API 호출 공통 함수
// ==========================================
function sendSolapiSMS(toPhone, text) {
const url = 'https://api.solapi.com/messages/v4/send';
const date = new Date().toISOString();
const salt = Math.random().toString(36).substring(2, 15);
const signatureData = date + salt;
const byteSignature = Utilities.computeHmacSha256Signature(signatureData, API_SECRET);
const signature = byteSignature.map(function(byte) {
return ('0' + (byte & 0xFF).toString(16)).slice(-2);
}).join('');
const headers = {
'Authorization': `HMAC-SHA256 apiKey=${API_KEY}, date=${date}, salt=${salt}, signature=${signature}`,
'Content-Type': 'application/json'
};
const payload = {
'message': {
'to': toPhone,
'from': SENDER_PHONE,
'text': text
}
};
const options = {
'method': 'post',
'headers': headers,
'payload': JSON.stringify(payload),
'muteHttpExceptions': true
};
try {
const response = UrlFetchApp.fetch(url, options);
return response.getResponseCode() === 200;
} catch (error) {
Logger.log('문자 발송 에러: ' + error.toString());
return false;
}
}
3. 트리거 2개 등록하기
이 부분이 가장 중요합니다. 스크립트 좌측의 시계 아이콘(트리거) 메뉴로 들어가셔서 총 2개의 트리거를 등록해 주세요.
- 첫 번째 트리거 (신청 접수용)
- 실행할 함수 선택:
onFormSubmitTrigger - 이벤트 소스 선택:
스프레드시트에서 - 이벤트 유형 선택:
양식 제출 시
- 실행할 함수 선택:
- 두 번째 트리거 (입금 확인용)
- 실행할 함수 선택:
onEditTrigger - 이벤트 소스 선택:
스프레드시트에서 - 이벤트 유형 선택:
수정 시
- 실행할 함수 선택:
동작 방식
- 수강생이 구글 폼으로 접수하면 $\rightarrow$
양식 제출 시트리거 작동 $\rightarrow$ “접수되었습니다” 문자 발송 및 E열에발송완료표기 - 관리자가 입금 확인 후 D열에 완료 입력하면 $\rightarrow$
수정 시트리거 작동 $\rightarrow$ “입금되었습니다” 문자 발송 및 F열에발송완료표기
네, 이미 공유해 드린 코드 안에 신청자 이름이 변수로 들어가도록 설정되어 있습니다!
코드에서 이 부분이 해당 역할을 합니다.
// 시트의 B열에서 이름을 가져와 name 변수에 저장
const name = sheet.getRange(row, 2).getValue();
// 백틱(`) 기호와 ${name} 문법을 사용해 이름 변수를 합성
const messageText = `[수강신청 접수 안내]\n안녕하세요 ${name}님, 수강신청이 정상적으로 접수되었습니다.`;
다양한 변수 추가 방법
이름 외에도 강의명, 입금 계좌번호, 금액 등 시트에 있는 다른 항목도 얼마든지 변수로 넣으실 수 있습니다.
예를 들어 구글 시트의 열 구성이 아래와 같다면:
- B열 (2번째 열): 이름
- C열 (3번째 열): 전화번호
- D열 (4번째 열): 신청 과목명 (추가)
코드 내 메시지 작성 부분을 아래처럼 수정하시면 됩니다.
const name = sheet.getRange(row, 2).getValue(); // B열: 이름
const course = sheet.getRange(row, 4).getValue(); // D열: 신청 과목명
// 변수를 여러 개 조합한 문자 내용
const messageText = `[수강신청 접수 안내]\n안녕하세요 ${name}님!\n신청하신 [${course}] 과목 접수가 정상 완료되었습니다.\n\n아래 계좌로 입금해 주시면 수강 확정됩니다.\n- 계좌: OO은행 123-456-7890 (예금주: 홍길동)`;
주의할 점 (문자 글자 수 / 단가)
- 단문(SMS, 90byte 이하): 변수를 넣었을 때 한글 약 45자 이내여야 기본 단가(약 8~9원)로 발송됩니다.
- 장문(LMS, 90byte 초과): 이름이나 과목명이 길어져서 90byte를 넘어가면 자동으로 장문문자(LMS, 약 25~30원)로 변경되어 발송되니, 문구 길이를 조절해 주시면 비용을 아끼실 수 있습니다!
답글 남기기