Viberi sõnumid

SMSBAT API toetab mitut tüüpi Viberi sõnumeid erinevatel kasutusjuhtudel, alates reklaamikampaaniatest kuni tehinguteatisteni.

Sõnumitüüpide ülevaade

Tüüp	Eesmärk	Rikasmeedia	Interaktiivne
viber_promo	Turunduskampaaniad	✅ Pildid, videod	✅ Nööbid
viber_trans	Tehingute teatised	✅ PDF-id	❌
viber_carousell	Toodete vitriinid	✅ Pildid	✅ Mitu nuppu
viber_survey	Küsitlused ja tagasiside	❌	✅ Mitu valikut
viber_otp	Ühekordsed paroolid	❌	❌

Viber Promo

Reklaamsõnumid koos turunduskampaaniate rikasmeedia toega.

Toetatud sisu

• Ainult pilt
• Ainult tekst
• Tekst + nupp
• Pilt + tekst + nupp
• Video + tekst
• Video + tekst + nupp
• Ainult video

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
”img”	string	Ei	Pildi URL
video	string	Ei	Videofaili URL
”pisipilt”	string	Ei	Video eelvaate pilt
buttonTekst	string	Ei	Tegevusele kutsuva nupu silt
”buttonAction”	string	Ei	Nupuklõps URL sihtkoha
”faili suurus”	täisarv	Ei	Videofaili suurus baitides
”kestus”	täisarv	Ei	Video pikkus sekundites

Näited

Tekst + pilt + nupp

{
  "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 + tekst + nupp

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

Ainult pilt

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

Ainult tekst

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

Ainult video

{
  "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 + tekst

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

Viberi tehing

Tehingumärguanded ajatundliku teabe jaoks, nagu tellimuste kinnitused ja kviitungid.

Toetatud sisu

• Ainult tekst
• PDF-fail + tekst
• ainult PDF-fail

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
fileUrl	string	Ei	PDF-dokumendi URL
failinimi	string	Ei	Manuse kuvatav nimi
”failitüüp”	string	Ei	Failitüüp (kasutage “pdf”)

Näited

Ainult tekst

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

Tekst + 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
}

Ainult PDF

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

Viberi karussell

Mitme üksuse sirvitav vitriin toodete või sisu jaoks.

Struktuur

Karusselli üksuste hulk, millest igaüks sisaldab:

• Pealkiri
• Pilt
• Esmane nupp (põhitegevus)
• Sekundaarne nupp (alternatiivne toiming)

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
karussell	massiiv	Jah	Karusselltoodete hulk
”esemed”	massiiv	Jah	Üksikud kaardiobjektid

Näide

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

Viberi uuring

Interaktiivsed küsitlused ja tagasiside kogumine valikvastustega.

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
”küsitlus”	objekt	Jah	Uuringukonteiner
”valikud”	massiiv	Jah	1–5 vastusevaliku massiiv

Piirangud

• Toetatud kuni 5 vastusevalikut
• Iga valik peaks olema lühike (soovitatav: alla 30 tähemärgi)

Näide

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

Ühekordne parooli edastamine eelnevalt määratletud mallidega.

Põhifunktsioonid

• 9 eelnevalt määratletud malli
• parameetrite kinnitamine (TEXT, NUMBER tüüpi)
• Mitme keele tugi (19 keelt)
• tõstutundlikud muutujate nimed

Toetatud keeled

ukraina, inglise, vene, poola, rumeenia, hispaania, saksa, prantsuse, itaalia, portugali, hollandi, türgi, araabia, heebrea, hindi, hiina, jaapani, korea, vietnami

Parameetrid

Parameeter	Tüüp	Nõutav	Kirjeldus
templateId	string (UUID)	Jah	Malli identifikaator
templateLang	string	Jah	ISO keelekood
templateParams	objekt	Jah	Muutujad, mis vastavad mallile

Näide

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

Malli näide: “Teie kood: 123456. Kehtib 10 minutit. Ärge kunagi jagage seda koodi.”

Toetatud mallid ja kinnitused

Viber pakub eelnevalt määratletud ja rangelt kontrollitud malle. Edastatud muutujate parameetrid peavad vastama õigetele andmetüüpidele.

Andmetüübid:

• NUMBER: ainult numbrid „[0–9]”, „+”, „-” ja „.”. Sümboleid, nagu / või tühik, ei toetata.
• TEKST: mis tahes keele tähestik, sümbolid (@#$%^&*().,<>;:!\"'+=-()[]{} \n jne).
• Tavaline vastendus: jada „<tähted>” ei saa eksisteerida jada „” kõrval; need nõuavad tühikute eraldamist. Topelt tühikud “ mallide sees on üldiselt keelatud. Linkide puhul vältige tühikuid, kui need ületavad piiranguid.

Allpool on 9 standardset ISO malli. Asendage ID-d vastavalt teie registreerimisnõuetele teatud riikides. Täiendavate keelte lisamisel võtke ühendust toega.

1. “AINULT kood (igasugune PIN)”

Nõuded: toetab PIN-koode numbrites ja ingliskeelsetes tähtedes, sümbolites - või .. Mall nõuab vormindamist, et teie kaubamärki koos kinnitus-PIN-koodiga õigesti kuvada.

2. “Toiming: kasutage seda koodi”

Parameetrid: {pin} (NUMBER või TEKST) Näidisvorming: “Palun kasutage kinnitamiseks seda koodi {pin}.“

3. “Brändi registreerimine/juurdepääs”

Parameetrid: {business_platform_name} (TEXT), {pin} (NUMBER või TEXT) Näidisvorming: „Teie kood ettevõttele {business_platform_name} on {pin}.”

4. “Koodi kinnitamise ajastus”

Parameetrid: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Näidisvorming: „Teie kinnituskood on {pin}. See kehtib {code_validity_time} minutit.”

5. “Brändi juurdepääs ja koodi kinnitamine”

Parameetrid: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Vormingu näide: “{business_platform_name} kinnituskood kehtib {pin} {code_validity_time} minutit.”

(Märkus. Viberi standardsete OTP-reeglite jaoks on kuni 9 eelmääratletud struktuuriplokki, mis põhinevad kombinatsioonidel “pin”, “business_platform_name” ja “code_validity_time” kasutusel).

Üldnõuded

Kõik Viberi sõnumitüübid nõuavad:

• “from”: tähtnumbriline saatja ID
• “kuni”: telefoninumber vormingus E.164
• “tüüp”: sõnumi tüübi identifikaator
• “ttl”: sõnumi aegumisaeg sekundites (soovitatav)

Tagasi SMS-i juurde

Kõik Viberi sõnumitüübid toetavad varundamissõnumeid, kasutades massiiviplokki “varumaad”. Kui Viberi kohaletoimetamine ebaõnnestub, suunatakse teade automaatselt tagasi alternatiivsetele konfigureeritud kanalitele.

Viber Promo -> SMS Backback

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

Viberi uuring -> SMS-i tagavara

{
  "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-i tagavara

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

Parimad tavad

Pildid

• Kasutage JPG- või PNG-vormingut
• Soovitatav suurus: 800x600 pikslit
• Hoidke faili suurus alla 1 MB
• Kasutage HTTPS-i URL-e

Videod

• Kasutage MP4-vormingut
• Hoidke faili suurus alla 10 MB
• Kaasake pisipilt
• Määrake kestus ja faili suurus

Nupud

• Hoidke nupu tekst lühike (2-3 sõna)
• Kasutage selgeid tegevusele kutsuvaid fraase
• Kasutage alati HTTPS-i URL-e
• Testige URL-e enne saatmist

TTL (eluaeg)

• Reklaamsõnumid: 24–72 tundi
• Tehingusõnumid: 24 tundi
• OTP-sõnumid: 5-10 minutit
• Küsitlused: 7-30 päeva

Järgmised sammud

• SMS-sõnumid - Lugege SMS-i varusõnumite kohta
• RCS-sõnumid - rikkalikud sideteenused
• Kontrolli olekut - Jälgige kohaletoimetamise olekut