바이버 메시지

SMSBAT API는 판촉 캠페인부터 거래 알림까지 다양한 사용 사례에 대해 다양한 유형의 Viber 메시지를 지원합니다.

메시지 유형 개요

유형	목적	리치 미디어	인터랙티브
viber_promo	마케팅 캠페인	✅ 이미지, 비디오	✅ 버튼
viber_trans	거래 알림	✅ PDF	❌
viber_carousel	제품 쇼케이스	✅ 이미지	✅ 여러 버튼
viber_survey	여론조사 및 피드백	❌	✅ 다양한 옵션
viber_otp	일회용 비밀번호	❌	❌

바이버 프로모션

마케팅 캠페인을 위한 리치 미디어 지원이 포함된 홍보 메시지입니다.

지원되는 콘텐츠

• 이미지만
• 텍스트만
• 텍스트 + 버튼
• 이미지 + 텍스트 + 버튼
• 영상 + 텍스트
• 영상 + 텍스트 + 버튼
• 비디오만

매개변수

매개변수	유형	필수	설명
img	문자열	아니요	이미지 URL
'비디오'	문자열	아니요	비디오 파일 URL
썸네일	문자열	아니요	비디오 미리보기 이미지
버튼텍스트	문자열	아니요	클릭 유도 버튼 라벨
버튼액션	문자열	아니요	버튼 클릭 URL 대상
파일 크기	정수	아니요	비디오 파일 크기(바이트)
기간	정수	아니요	비디오 길이(초)

예

텍스트 + 이미지 + 버튼

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

비디오 + 텍스트 + 버튼

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

이미지만

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

텍스트만

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

동영상 전용

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

동영상 + 텍스트

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Viber 거래

주문 확인 및 영수증과 같이 시간에 민감한 정보에 대한 거래 알림입니다.

지원되는 콘텐츠

• 텍스트만
• PDF 파일 + 텍스트
• PDF 파일만 가능

매개변수

매개변수	유형	필수	설명
fileUrl	문자열	아니요	PDF 문서 URL
파일 이름	문자열	아니요	첨부 파일의 표시 이름
파일 유형	문자열	아니요	파일 형식("pdf" 사용)

예

텍스트만

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

텍스트 + PDF

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

PDF 전용

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Viber 회전목마

제품이나 콘텐츠에 대한 탐색 가능한 다중 항목 쇼케이스입니다.

구조

캐러셀 항목의 배열은 다음을 포함합니다.

• 제목
• 이미지
• 기본 버튼(주요 작업)
• 보조 버튼(대체 작업)

매개변수

매개변수	유형	필수	설명
회전목마	배열	예	캐러셀 항목 배열
아이템	배열	예	개별 카드 개체

예

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

바이버 설문조사

객관식 옵션을 갖춘 대화형 설문 조사 및 피드백 수집.

매개변수

매개변수	유형	필수	설명
'설문조사'	개체	예	설문조사 컨테이너
'옵션'	배열	예	1~5개의 답변 선택 배열

제약

• 최대 5개의 응답 옵션 지원
• 각 옵션은 간결해야 합니다. (권장: 30자 이내)

예

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

바이버 OTP

사전 정의된 템플릿을 통한 일회성 비밀번호 전달.

주요 기능

• 9개의 사전 정의된 템플릿
• 매개변수 검증(TEXT, NUMBER 유형)
• 다국어 지원(19개 언어)
• 대소문자를 구분하는 변수 이름

지원되는 언어

우크라이나어, 영어, 러시아어, 폴란드어, 루마니아어, 스페인어, 독일어, 프랑스어, 이탈리아어, 포르투갈어, 네덜란드어, 터키어, 아랍어, 히브리어, 힌디어, 중국어, 일본어, 한국어, 베트남어

매개변수

매개변수	유형	필수	설명
템플릿 ID	문자열(UUID)	예	템플릿 식별자
templateLang	문자열	예	ISO 언어 코드
templateParams	개체	예	템플릿과 일치하는 변수

예

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

템플릿 예: "귀하의 코드: 123456. 10분간 유효합니다. 이 코드를 공유하지 마세요."

지원되는 템플릿 및 유효성 검사

Viber는 사전 정의되고 엄격하게 제어되는 템플릿을 제공합니다. 전달된 변수 매개변수는 올바른 데이터 유형과 일치해야 합니다.

데이터 유형: - 숫자: 숫자 [0-9], +, -, .만 가능합니다. '/' 또는 공백과 같은 기호는 지원되지 않습니다. - 텍스트: 모든 언어 알파벳, 기호(@#$%^&*().,<>;:!\"'+=-()[]{} \n 등). - 일반 매핑: <문자> 시퀀스는 <번호> 시퀀스 옆에 존재할 수 없습니다. 공백 분리가 필요합니다. 템플릿 내부의 이중 공백 은 일반적으로 금지됩니다. 링크의 경우 제한을 초과하는 경우 공백을 피하십시오.

다음은 9개의 표준 ISO 템플릿입니다. 특정 국가의 등록 요구 사항에 따라 ID를 교체하세요. 언어를 추가하는 경우 지원팀에 문의하세요.

1. "코드만(모든 PIN)"

요구사항: 숫자, 영문자, 기호 '-' 또는 '.'으로 된 PIN을 지원합니다. 확인 PIN과 함께 브랜드를 올바르게 표시하려면 템플릿 형식을 지정해야 합니다.

2. "Action: 이 코드를 사용해주세요"

매개변수: {pin}(NUMBER 또는 TEXT) 형식 예시: "확인을 위해 이 코드 {pin}을(를) 사용하세요."

3. "브랜드 등록/접속"

매개변수: {business_platform_name}(TEXT), {pin}(NUMBER 또는 TEXT) 형식 예: "{business_platform_name}의 코드는 {pin}입니다."

4. "코드 유효성 검사 타이밍"

매개변수: {pin}(NUMBER/TEXT), {code_validity_time}(NUMBER) 예시 형식: "귀하의 인증 코드는 {pin}입니다. {code_validity_time}분 동안 유효합니다."

5. "브랜드 액세스 및 코드 유효성 검사"

매개변수: {business_platform_name}(TEXT), {pin}(NUMBER/TEXT), {code_validity_time}(NUMBER) 형식 예: "{business_platform_name} 인증 코드는 {code_validity_time}분 동안 유효합니다."

(참고: 'pin', 'business_platform_name' 및 'code_validity_time' 사용의 조합을 기반으로 Viber 표준 OTP 규칙에 대해 최대 9개의 사전 정의된 구조 블록이 있습니다.)

일반 요구 사항

모든 Viber 메시지 유형에는 다음이 필요합니다.

• from: 영숫자 발신자 ID
• to: E.164 형식의 전화번호
• type: 메시지 유형 식별자
• ttl: 메시지 만료 시간(초)(권장)

SMS로 대체

모든 Viber 메시지 유형은 'fallbacks' 배열 블록을 활용하여 SMS 대체를 지원합니다. Viber 전송이 실패하면 메시지는 자동으로 구성된 대체 채널로 대체됩니다.

Viber 프로모션 -> SMS 대체

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Viber 설문조사 -> SMS 대체

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Viber Trans -> SMS 대체

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

모범 사례

이미지

• JPG 또는 PNG 형식을 사용하세요.
• 권장 크기: 800x600픽셀
• 파일 크기를 1MB 미만으로 유지하세요.
• HTTPS URL을 사용하세요

동영상

• MP4 형식 사용
• 파일 크기를 10MB 미만으로 유지하세요.
• 썸네일 이미지 포함
• 기간 및 파일 크기 지정

버튼

• 버튼 텍스트를 짧게 유지하세요(2~3단어)
• 명확한 클릭 유도문안을 사용하세요.
• 항상 HTTPS URL을 사용하세요.
• 보내기 전에 URL을 테스트하세요.

TTL(Time-to-Live)

• 홍보 메시지: 24~72시간
• 거래 메시지: 24시간
• OTP 메시지: 5~10분
• 설문조사: 7~30일

다음 단계

• SMS 메시지 - SMS 대체에 대해 알아보기
• RCS 메시지 - 풍부한 커뮤니케이션 서비스
• 상태 확인 - 배송 상태 추적