Skip to content

Viber poruke

SMSBAT API podržava više vrsta Viber poruka za različite slučajeve upotrebe, od promotivnih kampanja do obavještenja o transakcijama.

Pregled tipova poruka

Vrsta Svrha Rich Media Interactive
viber_promo Marketinške kampanje ✅ Slike, Video ✅ Dugmad
viber_trans Obavještenja o transakcijama ✅ PDF-ovi ❌
viber_carousel Vitrine proizvoda ✅ Slike ✅ Više dugmadi
viber_survey Ankete i povratne informacije ❌ ✅ Više opcija
viber_otp Jednokratne lozinke ❌ ❌

Viber Promo

Promotivne poruke s bogatom medijskom podrškom za marketinške kampanje.

Podržani sadržaj

  • Samo slika
  • Samo tekst
  • Tekst + dugme
  • Slika + tekst + dugme
  • Video + tekst
  • Video + tekst + dugme
  • Samo video

Parametri

Parametar Vrsta Obavezno Opis
img string Ne URL slike
video string Ne URL video datoteke
sličica string Ne Video pregled slike
buttonText string Ne Oznaka dugmeta poziva na akciju
buttonAction string Ne Kliknite na dugme URL odredište
fileSize cijeli broj Ne Veličina video datoteke u bajtovima
trajanje cijeli broj Ne Dužina videa u sekundama

Primjeri

Tekst + Slika + Dugme

Primjer teksta + Slika + Dugme

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

Video + Tekst + Primer dugmeta

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

Primjer samo slike

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

Samo tekst

Primjer samo teksta

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

Samo video

Samo primjer 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 + Tekst

Video + Tekst primjer

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

Obavijesti o transakcijama za vremenski osjetljive informacije kao što su potvrde narudžbe i priznanice.

Podržani sadržaj

  • Samo tekst
  • PDF fajl + tekst
  • Samo PDF fajl

Parametri

Parametar Vrsta Obavezno Opis
fileUrl string Ne URL PDF dokumenta
fileName string Ne Ime za prikaz za prilog
fileType string Ne Vrsta datoteke (koristite "pdf")

Primjeri

Samo tekst

Samo tekst primjer

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

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

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

Viber vrtuljak

Vitrina sa više stavki za pregled proizvoda ili sadržaja.

Struktura

Niz stavki vrtuljka, od kojih svaka sadrži:

  • Naslov
  • Slika
  • Primarno dugme (glavna akcija)
  • sekundarno dugme (alternativna radnja)

Parametri

Parametar Vrsta Obavezno Opis
vrtuljak niz Da Niz karusela stavki
predmeti niz Da Pojedinačni objekti kartice

Primjer

Primjer Viber karusela

{
  "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 i prikupljanje povratnih informacija s višestrukim opcijama izbora.

Parametri

Parametar Vrsta Obavezno Opis
anketa objekt Da Pregledni kontejner
opcije niz Da Niz od 1-5 odgovora

Ograničenja

  • Podržano je maksimalno 5 opcija odgovora
  • Svaka opcija treba da bude sažeta (preporučeno: ispod 30 karaktera)

Primjer

Primjer Viber ankete

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

Isporuka jednokratne lozinke s unaprijed definiranim predlošcima.

Ključne karakteristike

  • 9 unapred definisanih šablona
  • Validacija parametara (TEXT, NUMBER vrste)
  • Podrška za više jezika (19 jezika)
  • Imena varijabli osjetljiva na velika i mala slova

Podržani jezici

ukrajinski, engleski, ruski, poljski, rumunski, španski, njemački, francuski, italijanski, portugalski, holandski, turski, arapski, hebrejski, hindi, kineski, japanski, korejski, vijetnamski

Parametri

Parametar Vrsta Obavezno Opis
templateId string (UUID) Da Identifikator šablona
templateLang string Da ISO kod jezika
templateParams objekt Da Varijable koje odgovaraju predlošku

Primjer

Viber OTP primjer

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

Primjer predloška: "Vaš kod: 123456. Vrijedi 10 minuta. Nikad ne dijelite ovaj kod."

Podržani predlošci i validacije

Viber nudi unapred definisane i strogo kontrolisane šablone. Proslijeđeni parametri varijabli moraju odgovarati ispravnim tipovima podataka.

Vrste podataka: - BROJ: Samo brojevi [0-9], +, - i .. Simboli poput / ili razmaka nisu podržani. - TEXT: Abeceda bilo kojeg jezika, simboli (@#$%^&*().,<>;:!\"'+=-()[]{} \n itd.). - Redovno preslikavanje: Niz <slova> ne može postojati pored niza <broj>; zahtijevaju odvajanje razmaka. Dvostruki razmaci unutar šablona su općenito zabranjeni. Za veze izbjegavajte razmake ako prelaze ograničenja.

Ispod je 9 standardnih ISO šablona. Zamijenite ID-ove na osnovu vaših zahtjeva za registraciju u određenim zemljama. Kontaktirajte podršku ako dodajete dodatne jezike.

1. "SAMO KOD (Bilo koji PIN)"

Zahtjevi: Podržava PIN-ove u brojevima i engleskim slovima, simbolima - ili .. Predložak zahtijeva formatiranje kako bi se vaš brend ispravno prikazao uz PIN za verifikaciju.

2. "Akcija: Molimo koristite ovaj kod"

Parametri: {pin} (BROJ ili TEKST) Primjer formata: "Koristite ovaj kod {pin} za verifikaciju."

3. "Registracija brenda/pristup"

Parametri: {business_platform_name} (TEXT), {pin} (BROJ ili TEKST) Primjer formata: "Vaš kod za {business_platform_name} je {pin}."

4. "Vrijeme provjere valjanosti koda"

Parametri: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Primjer formata: "Vaš verifikacioni kod je {pin}. Vrijedi {code_validity_time} minuta."

5. "Pristup brendu i validacija koda"

Parametri: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Primjer formata: "{business_platform_name} verifikacioni kod je {pin} važeći {code_validity_time} minuta."

(Napomena: Postoji do 9 unapred definisanih strukturnih blokova za Viber standardna OTP pravila zasnovana na kombinacijama upotrebe pin, business_platform_name i code_validity_time).

Opći zahtjevi

Sve vrste Viber poruka zahtijevaju:

  • od: Alfanumerički ID pošiljaoca
  • za: Broj telefona u E.164 formatu
  • type: identifikator tipa poruke
  • ttl: vrijeme isteka poruke u sekundama (preporučeno)

Povratak na SMS

Svi tipovi Viber poruka podržavaju rezervni SMS koristeći blok niza fallbacks. Ako Viber dostava ne uspije, poruka se automatski vraća na alternativne konfigurirane kanale.

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 anketa -> 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
        }
      ]
    }
  ]
}

Najbolje prakse

Slike

  • Koristite JPG ili PNG format
  • Preporučena veličina: 800x600 piksela
  • Zadržite veličinu datoteke ispod 1MB
  • Koristite HTTPS URL-ove

Videos

  • Koristite MP4 format
  • Zadržite veličinu datoteke ispod 10MB
  • Uključuje sličicu
  • Odredite trajanje i veličinu datoteke

Dugmad

  • Neka tekst dugmeta bude kratak (2-3 riječi)
  • Koristite jasne fraze poziva na akciju
  • Uvijek koristite HTTPS URL-ove
  • Testirajte URL-ove prije slanja

TTL (vrijeme za život)

  • Promotivne poruke: 24-72 sata
  • Transakcione poruke: 24 sata
  • OTP poruke: 5-10 minuta
  • Ankete: 7-30 dana

Sljedeći koraci