I-skip tungo sa nilalaman

Mga Mensahe sa Viber

Sinusuportahan ng SMSBAT API ang maraming uri ng mga mensahe ng Viber para sa iba't ibang sitwasyon ng paggamit, mula sa mga kampanyang pang-promosyon hanggang sa mga notification ng transaksyon.

Pangkalahatang-ideya ng Mga Uri ng Mensahe

Uri Layunin Rich Media Interactive
viber_promo Mga kampanya sa marketing ✅ Mga Larawan, Video ✅ Mga Pindutan
viber_trans Mga abiso sa transaksyon ✅ Mga PDF ❌
viber_carousel Mga showcase ng produkto ✅ Mga Larawan ✅ Maramihang mga pindutan
viber_survey Mga botohan at feedback ❌ ✅ Maramihang mga pagpipilian
viber_otp Mga minsanang password ❌ ❌

Viber Promo

Mga mensaheng pang-promosyon na may suporta sa rich media para sa mga kampanya sa marketing.

Sinusuportahang Nilalaman

  • Larawan lamang
  • Text lang
  • Button ng Text +
  • Imahe + text + na button
  • Video + teksto
  • Button ng video + text +
  • Video lang

Mga Parameter

Parameter Uri Kinakailangan Paglalarawan
img string Hindi URL ng Larawan
video string Hindi URL ng video file
thumbnail string Hindi Larawan ng preview ng video
buttonText string Hindi Label ng button ng call-to-action
buttonAction string Hindi Patutunguhan ng URL ng pag-click sa pindutan
FileSize integer Hindi Laki ng video file sa bytes
tagal integer Hindi Haba ng video sa mga segundo

Mga halimbawa

Text + Image + Button

Text + Image + Button Example

{
  "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"
  }
}

Video + Text + Button

Video + Teksto + Halimbawa ng Button

{
  "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"
  }
}

Larawan Lang

Halimbawa Lamang ng Larawan

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

Text Lang

Text Only Example

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

Video Lang

Halimbawa ng Video Lang

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

Video + Teksto

Halimbawa ng Video + Teksto

{
  "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 Transactional

Mga notification sa transaksyon para sa impormasyong sensitibo sa oras tulad ng mga kumpirmasyon at resibo ng order.

Sinusuportahang Nilalaman

  • Text lang
  • PDF file + text
  • PDF file lang

Mga Parameter

Parameter Uri Kinakailangan Paglalarawan
fileUrl string Hindi URL ng dokumentong PDF
fileName string Hindi Display name para sa attachment
fileType string Hindi Uri ng file (gamitin ang "pdf")

Mga halimbawa

Text Lang

Text Only Example

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

Teksto + PDF

Halimbawa ng Teksto + 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 Lang

PDF Tanging Halimbawa

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

Multi-item na naba-browse na showcase para sa mga produkto o content.

Istraktura

Array ng mga carousel item, bawat isa ay naglalaman ng:

  • Pamagat
  • Larawan
  • Pangunahing pindutan (pangunahing aksyon)
  • Pangalawang pindutan (alternatibong pagkilos)

Mga Parameter

Parameter Uri Kinakailangan Paglalarawan
carousel array Oo Array ng mga carousel item
mga item array Oo Mga indibidwal na bagay ng card

Halimbawa

Halimbawa ng Viber Carousel

{
  "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"
          }
        }
      ]
    }
  }
}

Viber Survey

Mga interactive na botohan at pagkolekta ng feedback na may maraming pagpipiliang pagpipilian.

Mga Parameter

Parameter Uri Kinakailangan Paglalarawan
survey bagay Oo Lalagyan ng survey
mga opsyon array Oo Array ng 1-5 na pagpipilian ng sagot

Mga hadlang

  • Sinusuportahan ang maximum na 5 mga pagpipilian sa tugon
  • Ang bawat opsyon ay dapat na maigsi (inirerekomenda: wala pang 30 character)

Halimbawa

Halimbawa ng Viber Survey

{
  "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"
      ]
    }
  }
}

Viber OTP

Isang beses na paghahatid ng password na may mga paunang natukoy na template.

Mga Pangunahing Tampok

  • 9 na paunang natukoy na mga template
  • Pagpapatunay ng parameter (TEXT, NUMBER uri)
  • Suporta sa maraming wika (19 na wika)
  • Mga pangalan ng variable na sensitibo sa case

Mga Sinusuportahang Wika

Ukrainian, English, Russian, Polish, Romanian, Spanish, German, French, Italian, Portuguese, Dutch, Turkish, Arabic, Hebrew, Hindi, Chinese, Japanese, Korean, Vietnamese

Mga Parameter

Parameter Uri Kinakailangan Paglalarawan
templateId string (UUID) Oo Tagatukoy ng template
templateLang string Oo ISO code ng wika
templateParams bagay Oo Mga variable na tumutugma sa template

Halimbawa

Halimbawa ng Viber OTP

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

Halimbawa ng template: "Ang iyong code: 123456. Valid para sa 10 minuto. Huwag kailanman ibahagi ang code na ito."

Mga Sinusuportahang Template at Pagpapatunay

Nag-aalok ang Viber ng mga paunang natukoy at mahigpit na kinokontrol na mga template. Ang mga variable na parameter na naipasa ay dapat na tumutugma sa mga tamang uri ng data.

Mga Uri ng Data: - NUMBER: Mga numeral lang na [0-9], +, -, at .. Ang mga simbolo tulad ng / o whitespace ay hindi suportado. - TEXT: Anumang alpabeto ng wika, mga simbolo (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc). - Regular na pagmamapa: Ang isang sequence ng <mga titik> ay hindi maaaring umiral katabi ng isang <number> sequence; kailangan nila ng whitespace separation. Karaniwang ipinagbabawal ang mga double whitespace sa loob ng mga template. Para sa mga link, iwasan ang mga puwang kung lumampas sila sa mga limitasyon.

Nasa ibaba ang 9 Standard ISO templates. Palitan ang mga ID batay sa iyong mga kinakailangan sa pagpaparehistro sa mga partikular na bansa. Makipag-ugnayan sa suporta kung nagdaragdag ng mga karagdagang wika.

1. "Code LAMANG (Anumang PIN)"

Mga Kinakailangan: Sinusuportahan ang mga PIN sa mga numeral at letrang Ingles, mga simbolo - o .. Nangangailangan ang template ng pag-format upang maipakita nang maayos ang iyong brand kasama ng PIN sa pag-verify.

2. "Aksyon: Mangyaring gamitin ang code na ito"

Mga Parameter: {pin} (NUMBER o TEXT) Halimbawang format: "Pakigamit ang code na ito {pin} para sa pag-verify."

3. "Pagpaparehistro/Access ng Brand"

Mga Parameter: {business_platform_name} (TEXT), {pin} (NUMBER o TEXT) Halimbawang format: "Ang iyong code para sa {business_platform_name} ay {pin}."

4. "Tiyempo ng Pagpapatunay ng Code"

Mga Parameter: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Halimbawang format: "Ang iyong verification code ay {pin}. Ito ay may bisa para sa {code_validity_time} minuto."

5. "Brand Access at Code Validation"

Mga Parameter: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Halimbawang format: "Ang verification code ng {business_platform_name} ay {pin} valid para sa {code_validity_time} minuto."

(Tandaan: Mayroong hanggang 9 na paunang natukoy na structural block para sa Viber na karaniwang mga panuntunan sa OTP batay sa mga kumbinasyon ng paggamit ng pin, business_platform_name, at code_validity_time).

Pangkalahatang Kinakailangan

Ang lahat ng uri ng mensahe ng Viber ay nangangailangan ng:

  • mula sa: Alphanumeric sender ID
  • to: Numero ng telepono sa format na E.164
  • uri: Tagatukoy ng uri ng mensahe
  • ttl: Oras ng pag-expire ng mensahe sa mga segundo (inirerekomenda)

Fallback sa SMS

Sinusuportahan ng lahat ng uri ng mensahe ng Viber ang SMS fallback gamit ang array block ng fallbacks. Kung nabigo ang paghahatid ng Viber, awtomatikong bumabalik ang mensahe sa mga alternatibong na-configure na channel.

Viber Promo -> SMS Fallback

{
  "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 Survey -> SMS Fallback

{
  "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 Fallback

{
  "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
        }
      ]
    }
  ]
}

Pinakamahuhusay na Kasanayan

Mga larawan

  • Gumamit ng JPG o PNG na format
  • Inirerekomendang laki: 800x600 pixels
  • Panatilihin ang laki ng file sa ilalim ng 1MB
  • Gumamit ng mga URL ng HTTPS

Mga video

  • Gumamit ng MP4 format
  • Panatilihin ang laki ng file sa ilalim ng 10MB
  • Isama ang thumbnail na larawan
  • Tukuyin ang tagal at laki ng file

Mga Pindutan

  • Panatilihing maikli ang text ng button (2-3 salita)
  • Gumamit ng malinaw na mga pariralang call-to-action
  • Palaging gumamit ng mga HTTPS URL
  • Subukan ang mga URL bago ipadala

TTL (Time-to-Live)

  • Mga mensaheng pang-promosyon: 24-72 oras
  • Mga mensahe sa transaksyon: 24 na oras
  • Mga mensahe ng OTP: 5-10 minuto
  • Mga survey: 7-30 araw

Mga Susunod na Hakbang