SMS 메시지

SMSBAT API를 사용하여 표준 문자 메시지를 보냅니다. SMS는 모든 모바일 장치에서 전송률이 가장 높은 가장 보편적인 메시징 채널입니다.

개요

SMS(단문 메시지 서비스)는 다음과 같은 경우에 이상적입니다.

긴급 알림
Viber/RCS 메시지 대체
스마트폰 없이도 사용자에게 다가가기
모든 모바일 네트워크에 걸친 범용 호환성
높은 배송율(95%+)

기본 SMS 메시지

요청

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

매개변수

매개변수	유형	필수	설명
'에서'	문자열	예	영숫자 발신자 ID(최대 11자)
'에'	문자열	예	E.164 형식의 수신자 전화번호
'유형'	문자열	예	`"sms"`로 설정
`텍스트`	문자열	예	메시지 내용
`고객 메시지 ID`	문자열	아니요	내부 추적 ID
`ttl`	정수	아니요	초 단위 수명

예

간단한 SMS

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

고객 ID가 포함된 SMS

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

TTL이 포함된 SMS

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

문자 인코딩

GSM 7비트 인코딩

표준 GSM 알파벳(SMS당 160자):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

확장 GSM 문자

다음 문자는 2자로 계산됩니다.

| ^ € { } [ ] ~ \

유니코드(UCS-2) 인코딩

특수 문자가 포함된 메시지는 유니코드 인코딩(SMS당 70자)을 사용합니다.

이모티콘: 😀 🎉 ❤️
키릴 문자: А Б В Г Д Е Ж
특수 기호: ✓ ✗ ★ ♥

메시지 길이

단일 SMS

GSM 7비트: 160자
유니코드: 70자

다중 부분 SMS

메시지가 한도를 초과하면 여러 부분으로 분할됩니다.

GSM 7비트: 부품당 153자
유니코드: 부분당 67자

예

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

이 메시지(201자)는 두 부분으로 나누어집니다.

응답

성공 응답

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

응답 필드

필드	설명
`메시지 ID`	추적용 고유 식별자
`상태`	메시지 상태(`accepted`, `rejected`)
'부품'	SMS 부품 수
'에'	수신자 전화번호

발신자 ID

영숫자 발신자

귀하의 브랜드 이름을 발신자로 사용하십시오(최대 11자):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

제한 사항:

최대 11자
문자와 숫자만 가능
공백이나 특수 문자가 없습니다.
수신자는 영숫자 발신자에게 회신할 수 없습니다.

숫자 발신자

전화번호를 발신자로 사용(양방향 SMS의 경우):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

사용 사례

OTP 인증

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

주문 알림

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

약속 알림

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

결제 확인

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

모범 사례

메시지 내용

✅ 메시지를 간결하고 명확하게 유지하세요
✅ 발신자 식별 정보 포함
✅ 필요한 경우 클릭 유도 문구 추가
✅ 올바른 문법과 철자를 사용하세요
❌과도한 구두점은 피해주세요!!!
❌ 모두 대문자를 사용하지 마세요.
❌ 의심스러운 URL 단축어는 피하세요.

캐릭터 사용법

보내기 전 문자수를 확인하세요.
확장된 GSM 문자에 유의하세요(2로 계산).
대량 발송 전 특수문자 테스트
긴 메시지에는 GSM 인코딩 사용을 고려하세요.

전화번호

항상 E.164 형식을 사용하십시오: +380XXXXXXXXX
보내기 전에 전화번호를 확인하세요
목록에서 잘못된 번호를 제거하세요.
연락처 목록을 최신 상태로 유지하세요.

타이밍

현지 시간대를 존중하세요.
야간(오후 10시~오전 8시)에는 발송을 피하세요.
상업성 메시지의 경우 영업시간을 고려하세요.
시간에 민감한 메시지에 적절한 TTL 설정

규정 준수

마케팅 메시지 발송 전 동의 받기
프로모션 SMS에 대한 수신 거부 지침을 포함합니다.
현지 규정(GDPR 등)을 따르세요.
"방해 금지" 목록을 존중하세요.

오류 처리

일반적인 오류

오류	원인	솔루션
`INVALID_RECIPIENT`	잘못된 전화 형식	E.164 형식 사용
`INVALID_SENDER`	잘못된 발신자 ID	보낸 사람 ID 규칙 확인
`MESSAGE_TOO_LONG`	최대 길이를 초과했습니다	메시지 분할 또는 단축
`INVALID_ENCODING`	지원되지 않는 문자	GSM 또는 유니코드 사용

비용 최적화

메시지 부분 줄이기

메시지를 160자(GSM) 또는 70자(유니코드) 미만으로 유지하세요.
유니코드를 실행하는 특수 문자를 사용하지 마세요.
적절한 경우 약어를 사용하십시오.
불필요한 공백 제거

최적화 예시

❌ 이전 (171자, 2 SMS):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ 이후(156자, SMS 1개):

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

대량보내기

한 번의 요청으로 여러 메시지를 보냅니다.

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

다음 단계

Viber 메시지 - 리치 미디어 메시징
RCS 메시지 - 풍부한 커뮤니케이션 서비스
상태 확인 - 배송 상태 추적
대체 전략 - 대체 구성