문자발송 api

작성자

카테고리:

솔라피(Solapi)

반값문자(halfsms)는 구글 앱스 스크립트(Google Apps Script)에서 바로 호출할 수 있는 오픈 API를 공식적으로 제공하지 않아, 앱스 스크립트 연동이 용이한 솔라피(Solapi) 또는 알리고(Aligo) 같은 메시징 서비스 API를 활용하는 것을 추천합니다. (문자 단가 역시 건당 8~10원 내외로 비슷하거나 매우 저렴합니다.)

아래는 구글 시트에서 ‘입금여부’를 ‘완료’로 바꾸면 자동으로 문자가 발송되는 구글 앱스 스크립트 구축 전체 과정입니다.

1단계: 구글 시트 구조 맞추기

구글 폼과 연결된 구글 시트의 열(Column) 구성을 아래와 같이 설정해 주세요.

  • A열: 제출시간
  • B열: 이름
  • C열: 전화번호
  • D열: 입금여부 (이곳에 ‘완료’ 입력 시 문자 발송)
  • E열: 발송상태 (자동으로 ‘발송완료’ 기록)

2단계: 문자 서비스 API Key 발급받기

가장 연동이 쉽고 앱스 Script 샘플을 잘 지원하는 솔라피(Solapi) 기준으로 설명해 드립니다.

  1. 솔라피 회원가입 및 발신번호 등록 (문자 발송용 본인 번호 인증)
  2. 개발자 지원 $\rightarrow$ API Key 관리 메뉴에서 API Key와 API Secret 발급
  3. 문자 발송에 필요한 캐시/포인트 소량 충전

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개의 트리거를 등록해 주세요.

  1. 첫 번째 트리거 (신청 접수용)
    • 실행할 함수 선택: onFormSubmitTrigger
    • 이벤트 소스 선택: 스프레드시트에서
    • 이벤트 유형 선택: 양식 제출 시
  2. 두 번째 트리거 (입금 확인용)
    • 실행할 함수 선택: onEditTrigger
    • 이벤트 소스 선택: 스프레드시트에서
    • 이벤트 유형 선택: 수정 시

동작 방식

  1. 수강생이 구글 폼으로 접수하면 $\rightarrow$ 양식 제출 시 트리거 작동 $\rightarrow$ “접수되었습니다” 문자 발송 및 E열에 발송완료 표기
  2. 관리자가 입금 확인 후 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원)로 변경되어 발송되니, 문구 길이를 조절해 주시면 비용을 아끼실 수 있습니다!

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다