Skoči na vsebino

Sporočila Viber

SMSBAT API podpira več vrst sporočil Viber za različne primere uporabe, od promocijskih kampanj do obvestil o transakcijah.

Pregled vrst sporočil

Vrsta Namen Obogatena predstavnost Interaktivno
viber_promo Marketinške akcije ✅ Slike, videi ✅ Gumbi
viber_trans Obvestila o transakcijah ✅ PDF-ji ❌
viber_vrtiljak Vitrine izdelkov ✅ Slike ✅ Več gumbov
viber_anketa Ankete in povratne informacije ❌ ✅ Več možnosti
viber_otp Enkratna gesla ❌ ❌

Viber Promo

Promocijska sporočila z bogato medijsko podporo za marketinške akcije.

Podprta vsebina

  • Samo slika
  • Samo besedilo
  • Besedilo + gumb
  • Slika + besedilo + gumb
  • Video + besedilo
  • Video + besedilo + gumb
  • Samo video

Parametri

Parameter Vrsta Zahtevano Opis
img niz Ne URL slike
video niz Ne URL video datoteke
sličica niz Ne Video predogled slike
besedilo gumba niz Ne Oznaka gumba za poziv k dejanju
gumbDejanje niz Ne Cilj URL-ja klika gumba
velikost datoteke celo število Ne Velikost video datoteke v bajtih
trajanje celo število Ne Dolžina videa v sekundah

Primeri

Besedilo + slika + gumb

Besedilo + slika + primer gumba

{
  "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 + besedilo + gumb

Video + besedilo + primer gumba

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

Samo slika

Primer samo slike

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

Samo besedilo

Primer samo besedila

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

Samo video

Samo primer videa

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

Primer videa + besedila

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

Obvestila o transakcijah za časovno občutljive informacije, kot so potrditve naročil in potrdila.

Podprta vsebina

  • Samo besedilo
  • PDF datoteka + besedilo
  • Samo datoteka PDF

Parametri

Parameter Vrsta Zahtevano Opis
fileUrl niz Ne URL dokumenta PDF
ime datoteke niz Ne Prikazno ime za prilogo
fileType niz Ne Vrsta datoteke (uporabite "pdf")

Primeri

Samo besedilo

Primer samo besedila

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

Besedilo + PDF

Besedilo + Primer 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
}

Samo PDF

Samo primer 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 vrtiljak

Predstavitev izdelkov ali vsebine, po kateri je mogoče brskati po več predmetih.

Struktura

Niz elementov vrtiljaka, od katerih vsak vsebuje:

  • Naslov
  • Slika
  • Primarni gumb (glavno dejanje)
  • Sekundarni gumb (alternativno dejanje)

Parametri

Parameter Vrsta Zahtevano Opis
vrtiljak niz Da Niz elementov vrtiljaka
predmeti niz Da Posamezni predmeti kartice

Primer

Primer vrtiljaka 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"
          }
        }
      ]
    }
  }
}

Viber anketa

Interaktivne ankete in zbiranje povratnih informacij z možnostmi več izbir.

Parametri

Parameter Vrsta Zahtevano Opis
anketa predmet Da Anketni vsebnik
možnosti niz Da Niz 1-5 odgovorov

Omejitve

  • Podprtih je največ 5 možnosti odgovora – Vsaka možnost mora biti jedrnata (priporočeno: pod 30 znakov)

Primer

Primer ankete Viber

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

Dostava enkratnega gesla z vnaprej določenimi predlogami.

Ključne lastnosti

  • 9 vnaprej določenih predlog – Preverjanje parametrov (BESEDILO, ŠTEVILO vrst)
  • Večjezična podpora (19 jezikov)
  • Imena spremenljivk razlikujejo med velikimi in malimi črkami

Podprti jeziki

Ukrajinski, angleški, ruski, poljski, romunski, španski, nemški, francoski, italijanski, portugalski, nizozemski, turški, arabski, hebrejski, hindujski, kitajski, japonski, korejski, vietnamski

Parametri

Parameter Vrsta Zahtevano Opis
templateId niz (UUID) Da Identifikator predloge
templateLang niz Da Jezikovna koda ISO
templateParams predmet Da Predloga za ujemanje spremenljivk

Primer

Primer 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
}

Primer predloge: "Vaša koda: 123456. Velja 10 minut. Nikoli ne delite te kode."

Podprte predloge in preverjanja

Viber ponuja vnaprej določene in strogo nadzorovane predloge. Posredovani parametri spremenljivk morajo ustrezati pravilnim tipom podatkov.

Vrste podatkov: - ŠTEVILO: samo številke [0-9], +, - in .. Simboli, kot sta / ali presledki, niso podprti. - BESEDILO: abeceda katerega koli jezika, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n itd.). - Običajno preslikavo: zaporedje <črk> ne more obstajati poleg zaporedja <število>; zahtevajo ločitev presledkov. Dvojni presledki `` znotraj predlog so na splošno prepovedani. Pri povezavah se izogibajte presledkom, če presegajo omejitve.

Spodaj je 9 standardnih ISO predlog. Zamenjajte ID-je glede na vaše zahteve za registracijo v določenih državah. Če želite dodati dodatne jezike, se obrnite na podporo.

1. "SAMO koda (kateri koli PIN)"

Zahteve: Podpira PIN-e v številkah in angleških črkah, simbolih - ali .. Predloga zahteva oblikovanje za pravilno prikazovanje vaše blagovne znamke poleg kode PIN za preverjanje.

2. "Ukrep: Prosimo, uporabite to kodo"

Parametri: {pin} (ŠTEVILO ali BESEDILO) Primer oblike: "Prosimo, uporabite to kodo {pin} za preverjanje."

3. "Registracija blagovne znamke/dostop"

Parametri: {business_platform_name} (BESEDILO), {pin} (ŠTEVILKA ali BESEDILO) Primer zapisa: "Vaša koda za {business_platform_name} je {pin}."

4. "Čas preverjanja kode"

Parametri: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Primer zapisa: »Vaša potrditvena koda je {pin}. Velja {code_validity_time} minut."

5. "Dostop do blagovne znamke in preverjanje kode"

Parametri: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Primer oblike: "Koda za preverjanje {business_platform_name} je {pin} veljavna {code_validity_time} minut."

(Opomba: Obstaja do 9 vnaprej določenih strukturnih blokov za standardna pravila OTP Viber, ki temeljijo na kombinacijah uporabe pin, business_platform_name in code_validity_time).

Splošne zahteve

Vse vrste sporočil Viber zahtevajo:

  • od: Alfanumerični ID pošiljatelja
  • za: telefonska številka v formatu E.164
  • type: identifikator vrste sporočila
  • ttl: čas poteka sporočila v sekundah (priporočeno)

Nazaj na SMS

Vse vrste sporočil Viber podpirajo nadomestna sporočila SMS z uporabo matričnega bloka nadomestnih. Če dostava Viber ne uspe, se sporočilo samodejno vrne na druge konfigurirane kanale.

Viber Promo -> Nadomestni 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
        }
      ]
    }
  ]
}

Anketa Viber -> Nadomestni 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 -> Nadomestni 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
        }
      ]
    }
  ]
}

Najboljše prakse

Slike

  • Uporabite format JPG ali PNG
  • Priporočena velikost: 800x600 slikovnih pik
  • Naj bo velikost datoteke manjša od 1 MB
  • Uporabite URL-je HTTPS

Videoposnetki

  • Uporabite format MP4
  • Naj bo velikost datoteke manjša od 10 MB
  • Vključite sličico
  • Določite trajanje in velikost datoteke

Gumbi

  • Besedilo gumba naj bo kratko (2-3 besede)
  • Uporabljajte jasne fraze za poziv k dejanju
  • Vedno uporabljajte URL-je HTTPS
  • Preizkusite URL-je pred pošiljanjem

TTL (Time-to-Live)

  • Promocijska sporočila: 24-72 ur
  • Transakcijska sporočila: 24 ur
  • Sporočila OTP: 5-10 minut
  • Ankete: 7-30 dni

Naslednji koraki

– Sporočila SMS – Več o nadomestnih sporočilih SMS - RCS sporočila - Bogate komunikacijske storitve - Preveri stanje - Sledite stanju dostave