Help Center Viber poruke

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	❌	❌

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

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

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

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

SMS poruke - Saznajte više o zamjenskim SMS porukama
RCS poruke - Bogate komunikacijske usluge
Provjeri status - Pratite status isporuke

Search Results

Viber poruke

Pregled tipova poruka

Viber Promo

Podržani sadržaj

Parametri

Primjeri

Tekst + Slika + Dugme

Video + Tekst + Dugme

Samo slika

Samo tekst

Samo video

Video + Tekst

Viber Transactional

Podržani sadržaj

Parametri

Primjeri

Samo tekst

Tekst + PDF

Samo PDF

Viber vrtuljak

Struktura

Parametri

Primjer

Viber anketa

Parametri

Ograničenja

Primjer

Viber OTP

Ključne karakteristike

Podržani jezici

Parametri

Primjer

Podržani predlošci i validacije

1. “SAMO KOD (Bilo koji PIN)”

2. “Akcija: Molimo koristite ovaj kod”

3. “Registracija brenda/pristup”

4. “Vrijeme provjere valjanosti koda”

5. “Pristup brendu i validacija koda”

Opći zahtjevi

Povratak na SMS

Viber Promo -> SMS Fallback

Viber anketa -> SMS Fallback

Viber Trans -> SMS Fallback

Najbolje prakse

Slike

Videos

Dugmad

TTL (vrijeme za život)

Sljedeći koraci