단체문자보내기
빠른 시작

5분 안에 시작하기

이 단계별 가이드를 따라 API를 통해 첫 SMS를 발송하세요.

진행 상황

0/5 단계 완료
1

1단계: 앱 다운로드

먼저 안드로이드폰에 단체문자 앱을 다운로드하고 설치하세요. 이 앱이 SMS 게이트웨이 역할을 합니다.

시스템 요구 사항

  • ✓ Android 7.0 (API 24) 이상
  • ✓ SMS 기능이 있는 활성 통신 요금제
  • ✓ 인터넷 연결 (Wi-Fi 또는 모바일 데이터)
안드로이드 앱 다운로드
2

2단계: 계정 생성

앱을 열고 전화번호 인증을 사용하여 계정을 만드세요.

전화번호 인증이 필요한 이유는?: SMS 메시지를 발송할 기기를 소유하고 있는지 확인하기 위해 전화번호를 인증합니다.

  1. 1.단체문자 앱 열기
  2. 2."시작하기"를 탭하고 전화번호 입력
  3. 3.전화로 전송된 인증 코드 입력
3

3단계: API 키 생성

앱 설정에서 API 키를 생성하세요. 이 키가 API 요청을 인증합니다.

  1. 1.앱에서 왼쪽 상단의 메뉴 아이콘 (☰) 탭
  2. 2.설정 > 개발자 API로 이동
  3. 3."API 키 생성" 탭
  4. 4.API 키를 복사하고 안전하게 저장

⚠️ 중요: API 키를 비밀로 유지하세요! 키를 가진 사람은 누구나 내 폰으로 SMS를 발송할 수 있습니다. API 키를 버전 관리에 커밋하지 마세요.

예제 API 키

gsms_live_1a2b3c4d5e6f7g8h9i0j
4

4단계: 첫 API 호출하기

cURL을 사용하여 테스트 SMS를 발송해 보세요. YOUR_API_KEY_HERE를 실제 API 키로 교체하고 전화번호를 업데이트하세요.

YOUR_API_KEY_HERE를 API 키로, +821012345678을 테스트 전화번호로 교체하세요:

curl -X POST https://api-2ue64mzmvq-du.a.run.app/api/v1/developer/send \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"recipients":[{"phone":"+821012345678","message":"Test message from Group SMS API!"}]}'

예상 응답

{
  "success": true,
  "batchId": "batch_1736416234_a1b2c3",
  "totalCount": 1,
  "estimatedDeliveryTime": "2-5 minutes"
}
5

5단계: 전달 확인

메시지가 성공적으로 발송되었는지 확인하세요.

  1. 1.테스트 전화를 확인하세요 - 2~5분 이내에 SMS를 받아야 합니다
  2. 2.단체문자 앱에서 "문자 이력" 탭으로 이동하여 발송된 메시지 확인
  3. 3.응답의 배치 ID를 사용하여 /status 엔드포인트로 상태 확인

✓ 성공: API를 통해 첫 SMS를 성공적으로 발송했습니다! 이제 전체 API 문서를 탐색하여 애플리케이션에 SMS를 통합하세요.

도움이 필요하신가요?

작동하지 않나요? 문서를 확인하거나 FAQ를 방문하세요.

API 문서FAQ 보기