Keri sisuni

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

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

Video + tekst + nupu näide

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

Ainult pildi näide

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

Ainult tekst

Ainult teksti näide

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

Ainult video

Ainult video näide

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

Video + teksti näide

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

Ainult teksti näide

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

Tekst + PDF

Tekst + PDF-i näide

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

Ainus PDF-i näide

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

Viberi karusselli 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

Viberi uuringu 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

Viber OTP 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 „” 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